Enviadores

Servidor MCP Enviadores

O primeiro servidor MCP de envios no México. Cote, crie, rastreie e cancele envios com Estafeta, DHL, FedEx, Paquetexpress e mais — além de coletas, agenda de endereços, webhooks e saldo — a partir do Claude, ChatGPT, Cursor ou qualquer 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 para instalar)
• Registro: mx.com.enviadores/shipping no Registro MCP oficial
• Docs: https://enviadores.com.mx/desarrolladores · Landing: https://enviadores.com.mx/mcp

Autenticação

Duas opções:

1. OAuth 2.1 — clientes que falam MCP OAuth (conectores claude.ai, modo desenvolvedor do ChatGPT) descobrem automaticamente: metadados RFC 8414/9728, registro dinâmico de clientes (RFC 7591) e CIMD. Cada concessão gera uma chave com escopo vinculada à sua conta Enviadores.
2. Chave de API — gere uma chave ek_ no painel e envie-a como token bearer. Chaves ek_test_ rodam em um sandbox completo, sem dinheiro real.

Conectar

Claude Code

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

claude.ai — Configurações → Conectores → Adicionar conector personalizado → https://api.enviadores.com.mx/api/v1/mcp (fluxo OAuth, sem necessidade de chave).

Cursor / Config JSON

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

Ferramentas (23)

Cada ferramenta é uma projeção enxuta de um endpoint REST público. As cotações retornam agrupadas por serviço (transportadora + nível de serviço, exibido uma vez com sua faixa de preço e opções reserváveis); um rate_id é válido por 30 minutos.

Cotar e enviar

Ferramenta	O que faz
validate_postal_code	Consulta SEPOMEX (estado, município, colônias) — opcional antes do envio
get_shipping_rates	Tarifas multi-transportadora em tempo real entre dois códigos postais mexicanos; uma caixa (package) ou 2–10 caixas como um único envio (packages); insurance.insured_value opcional
create_shipment	Comprar uma etiqueta a partir de um rate_id cotado — idempotente (idempotency_key), mesmas caixas da cotação, declared_value opcional
get_shipment	Um envio com seu status atual
list_shipments	Envios na conta, filtráveis por status, número de rastreio e data
get_label	Link do PDF da etiqueta de um envio
track_shipment	Rastreio em tempo real pelo número de rastreio (guía)
cancel_shipment	Solicitar cancelamento (reembolso segue o resultado da transportadora)

Coletas (somente solicitação: nossa equipe confirma com a transportadora e envia o resultado por e-mail)

Ferramenta	O que faz
schedule_pickup	Solicitar coleta da transportadora na porta do remetente para uma janela de horário local
get_pickup / list_pickups	Status das solicitações de coleta

Agenda de endereços

Ferramenta	O que faz
list_senders / create_sender	Remetentes salvos
list_recipients / create_recipient	Destinatários salvos
import_contacts	Importação em massa (linhas ou CSV bruto) com modo de simulação (dry-run)

Webhooks (sem polling: eventos shipment.* e pickup.resolved, assinados com HMAC, com novas tentativas e backoff)

Ferramenta	O que faz
register_webhook	Registrar um endpoint https:// para um conjunto de eventos (segredo exibido uma única vez)
list_webhooks / delete_webhook	Gerenciar os webhooks da conta (5 ativos por modo)
test_webhook	Entregar um ping assinado de forma síncrona

Conta

Ferramenta	O que faz
whoami	Conta, escopos da chave, modo (sandbox/produção) e capacidades desta conexão
get_balance	Saldo pré-pago, retenções e valor disponível
list_transactions	Movimentações de saldo (cobranças, reembolsos, recargas)

Cada ferramenta inclui title, annotations (readOnlyHint / destructiveHint / openWorldHint) e um outputSchema derivado da especificação OpenAPI, então os resultados estruturados são tipados. As ferramentas de coleta aparecem apenas quando o recurso está ativo na conta.

Sandbox

Chaves ek_test_ (ou escolher Sandbox na tela de consentimento OAuth) executam todas as ferramentas contra um sandbox sem dinheiro real: as cotações listam apenas serviços com um sandbox real por trás (uma rota de teste FedEx mais uma oferta simulada), as etiquetas são PDFs de teste assinados e duráveis, e os webhooks recebem shipment.created / shipment.cancelled além de ping. Reconecte escolhendo Producción para enviar de verdade.

Segurança de gastos

Tudo cobra um saldo pré-pago com aplicação no servidor: create_shipment nunca pode gastar mais do que o saldo disponível nem exceder o limite diário da chave. create_shipment aceita um idempotency_key (um é gerado e retornado se omitido) para que novas tentativas nunca cobrem em dobro. O adaptador MCP é um tradutor puro de protocolo sobre a API REST pública — um agente nunca pode fazer nada que um chamador REST comum não pudesse.

Suporte

• Docs: https://enviadores.com.mx/desarrolladores
• E-mail: contacto@enviadores.com.mx

---

Este repositório hospeda a documentação pública do servidor hospedado; o servidor em si é operado pela Enviadores.