Centro de ayudaGitHub

Servidor MCP para agentes de IA de envíos

Deja que los asistentes de IA hagan envíos con atoship mediante el Model Context Protocol. Consulta tarifas, crea etiquetas, rastrea paquetes y gestiona pedidos con lenguaje natural.

@atoship/mcp
v1.0.0
12 herramientas
MCP remoto — sin instalación
Claude.ai
Usa atoship directamente en la app web de Claude.ai: sin npm ni archivos de configuración. Solo agrega la URL y conéctate.
  1. Abre Claude.ai → Settings → Integrations
  2. Haz clic en Add integration
  3. Ingresa la URL del servidor:
https://atoship.com/api/mcp

Claude.ai te redirigirá a atoship.com para autorizar con tu cuenta. Una vez conectado, tendrás disponibles las 12 herramientas y los comandos con barra (/ship, /track, /rates).

Clientes locales (stdio)

Agrega esto a tu claude_desktop_config.json:

{
  "mcpServers": {
    "atoship": {
      "command": "npx",
      "args": ["-y", "@atoship/mcp"],
      "env": {
        "ATOSHIP_API_KEY": "ak_live_your_key_here"
      }
    }
  }
}

Ubicación del archivo de configuración: ~/Library/Application Support/Claude/claude_desktop_config.json (macOS)

Obtén tu API key

Necesitas una API key de atoship para usar el servidor MCP. Las keys empiezan con ak_live_ para producción o ak_test_ para sandbox.

Herramientas disponibles

12 herramientas que cubren todo el flujo de envíos. El asistente de IA elige la herramienta adecuada según tu solicitud.

get_shipping_rates

Compara tarifas de USPS, FedEx, UPS y más

«Busca la tarifa más barata para un paquete de 2 lb de SF a NYC»

purchase_label

Compra una etiqueta de envío con cualquier carrier y servicio

«Crea una etiqueta USPS Priority Mail para este pedido»

track_package

Rastrea un paquete con el historial completo de eventos

«Rastrea 9400111899223456789012»

validate_address

Valida direcciones con corrección automática

«Valida 123 Main St, San Francisco, CA 94105»

create_order

Crea pedidos con datos del destinatario y de los artículos

«Crea un pedido para John Doe en 456 Oak Ave»

list_orders

Busca y filtra pedidos por estado o fecha

«Muéstrame todos los pedidos enviados esta semana»

get_label

Obtén los datos de la etiqueta, el número de rastreo y el enlace de descarga

«Dame la etiqueta del pedido #12345»

void_label

Anula etiquetas sin usar y obtén reembolsos

«Anula la etiqueta que acabo de crear»

list_labels

Explora todas las etiquetas de envío con filtros

«Lista las etiquetas compradas hoy»

get_account

Consulta los datos de la cuenta, el plan y el uso

«¿En qué plan estoy?»

list_carrier_accounts

Consulta todas las cuentas de carrier configuradas

«¿Qué carriers tengo conectados?»

Ejemplos de conversación

Enviar un paquete

Necesito enviar un paquete de 12oz desde 123 Main St, San Francisco CA 94105 hasta 456 Oak Ave, New York NY 10001. ¿Cuál es la opción más barata?

Encontré 5 opciones de envío para tu paquete:

1. USPS Ground Advantage — $4.75 (5-7 días)

2. USPS Priority Mail — $8.20 (2-3 días)

3. UPS Ground — $9.45 (5 días)

4. FedEx Ground — $10.12 (5 días)

5. USPS Priority Express — $26.35 (1-2 días)

La más barata es USPS Ground Advantage a $4.75. ¿Quieres que compre esta etiqueta?

Rastrear un envío

¿Dónde está mi paquete? Número de rastreo 9400111899223456789012

Tu paquete de USPS está En tránsito: entrega estimada el 14 de feb.

12 feb 10:23 AM — Llegó a la instalación, Queens NY

11 feb 8:45 PM — Salió de la instalación, Newark NJ

10 feb 2:30 PM — Aceptado en USPS, San Francisco CA

Configuración

VariableObligatoriaValor por defectoDescripción
ATOSHIP_API_KEY
Obligatoria
Tu API key de atoship
ATOSHIP_BASE_URL
Opcional
https://atoship.comURL base de la API
atoship © 2026