Enviadores

Servidor MCP de Enviadores

El primer servidor MCP de paquetería en México. Cotiza, crea, rastrea y cancela envíos con Estafeta, DHL, FedEx, Paquetexpress y más — además de recolecciones, libreta de direcciones, webhooks y saldo — desde Claude, ChatGPT, Cursor o cualquier cliente MCP.

Español: el primer servidor MCP de paquetería en México. Cotiza, crea, rastrea y cancela envíos multi-paquetería, solicita recolecciones, administra tu libreta de direcciones y recibe webhooks desde cualquier cliente MCP.

• Endpoint: https://api.enviadores.com.mx/api/v1/mcp (HTTP Streamable, remoto — nada que instalar)
• Registro: mx.com.enviadores/shipping en el Registro oficial de MCP
• Docs: https://enviadores.com.mx/desarrolladores · Landing: https://enviadores.com.mx/mcp

Autenticación

Dos opciones:

1. OAuth 2.1 — los clientes que hablan MCP OAuth (conectores de claude.ai, modo desarrollador de ChatGPT) lo descubren automáticamente: metadatos RFC 8414/9728, registro dinámico de clientes (RFC 7591) y CIMD. Cada concesión emite una clave con alcances vinculada a tu cuenta de Enviadores.
2. Clave API — emite una clave ek_ en el panel y envíala como token de portador. Las claves ek_test_ operan en un sandbox completo sin dinero real.

Conectar

Claude Code

claude mcp add --transport http enviadores https://api.enviadores.com.mx/api/v1/mcp \
  --header "Authorization: Bearer ek_..."

claude.ai — Configuración → Conectores → Agregar conector personalizado → https://api.enviadores.com.mx/api/v1/mcp (flujo OAuth, sin necesidad de clave).

Cursor / configuración JSON

{
  "mcpServers": {
    "enviadores": {
      "url": "https://api.enviadores.com.mx/api/v1/mcp",
      "headers": { "Authorization": "Bearer ek_..." }
    }
  }
}

Herramientas (23)

Cada herramienta es una proyección ligera de un endpoint REST público. Las cotizaciones regresan agrupadas por servicio (transportista + nivel de servicio, mostrado una vez con su rango de precios y opciones reservables); un rate_id es válido por 30 minutos.

Cotizar y enviar

Herramienta	Qué hace
validate_postal_code	Consulta SEPOMEX (estado, municipio, colonias) — opcional antes del envío
get_shipping_rates	Tarifas multi-transportista en vivo entre dos códigos postales mexicanos; una caja (package) o 2–10 cajas como un solo envío (packages); insurance.insured_value opcional
create_shipment	Compra una etiqueta de un rate_id cotizado — idempotente (idempotency_key), mismas cajas que las cotizadas, declared_value opcional
get_shipment	Un envío con su estado actual
list_shipments	Envíos en la cuenta, filtrables por estado, número de guía y fecha
get_label	Enlace al PDF de la etiqueta de un envío
track_shipment	Rastreo en vivo por número de guía
cancel_shipment	Solicitar cancelación (el reembolso sigue el resultado del transportista)

Recolecciones (solo solicitud: nuestro equipo confirma con el transportista y envía el resultado por correo)

Herramienta	Qué hace
schedule_pickup	Solicita una recolección del transportista en la puerta del remitente para una ventana de tiempo local
get_pickup / list_pickups	Estado de las solicitudes de recolección

Libreta de direcciones

Herramienta	Qué hace
list_senders / create_sender	Remitentes guardados
list_recipients / create_recipient	Destinatarios guardados
import_contacts	Importación masiva (filas o CSV crudo) con modo de prueba

Webhooks (sin sondeo: eventos shipment.* y pickup.resolved, firmados con HMAC, reintentados con retroceso)

Herramienta	Qué hace
register_webhook	Registra un endpoint https:// para un conjunto de eventos (secreto mostrado una vez)
list_webhooks / delete_webhook	Administra los webhooks de la cuenta (5 activos por modo)
test_webhook	Entrega un ping firmado de forma síncrona

Cuenta

Herramienta	Qué hace
whoami	Cuenta, alcances de clave, modo (sandbox/producción) y capacidades de esta conexión
get_balance	Saldo prepagado, retenciones y monto disponible
list_transactions	Movimientos de saldo (cargos, reembolsos, recargas)

Cada herramienta incluye title, annotations (readOnlyHint / destructiveHint / openWorldHint) y un outputSchema derivado de la especificación OpenAPI, por lo que los resultados estructurados están tipados. Las herramientas de recolección aparecen solo cuando la función está habilitada en la cuenta.

Sandbox

Las claves ek_test_ (o elegir Sandbox en la pantalla de consentimiento OAuth) ejecutan cada herramienta contra un sandbox sin dinero real: las cotizaciones solo listan servicios con un sandbox real detrás (una ruta de prueba de FedEx más una oferta simulada), las etiquetas son PDFs de prueba firmados y duraderos, y los webhooks reciben shipment.created / shipment.cancelled más ping. Reconecta eligiendo Producción para enviar de verdad.

Seguridad de gasto

Todo carga un saldo prepagado con aplicación del lado del servidor: create_shipment nunca puede gastar más que el saldo disponible ni exceder el límite diario de la clave. create_shipment acepta un idempotency_key (se genera y devuelve uno si se omite) para que los reintentos nunca cobren dos veces. El adaptador MCP es un traductor de protocolo puro sobre la API REST pública — un agente nunca puede hacer algo que un llamador REST simple no pudiera.

Soporte

• Docs: https://enviadores.com.mx/desarrolladores
• Correo: contacto@enviadores.com.mx

---

Este repositorio aloja la documentación pública del servidor alojado; el servidor en sí es operado por Enviadores.