Enviadores

Enviadores MCP Server

The first shipping MCP server in Mexico. Quote, create, track and cancel shipments with Estafeta, DHL, FedEx, Paquetexpress and more — plus pickups, an address book, webhooks and balance — from Claude, ChatGPT, Cursor or any MCP client.

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 (Streamable HTTP, remote — nothing to install)
• Registry: mx.com.enviadores/shipping on the official MCP Registry
• Docs: https://enviadores.com.mx/desarrolladores · Landing: https://enviadores.com.mx/mcp

Authentication

Two options:

1. OAuth 2.1 — clients that speak MCP OAuth (claude.ai connectors, ChatGPT developer mode) discover it automatically: RFC 8414/9728 metadata, dynamic client registration (RFC 7591) and CIMD. Every grant mints a scoped key tied to your Enviadores account.
2. API key — mint an ek_ key in the dashboard and send it as a bearer token. ek_test_ keys run in a full sandbox with no real money.

Connect

Claude Code

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

claude.ai — Settings → Connectors → Add custom connector → https://api.enviadores.com.mx/api/v1/mcp (OAuth flow, no key needed).

Cursor / JSON config

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

Tools (23)

Every tool is a thin projection of one public REST endpoint. Quotes come back grouped by service (carrier + service level, shown once with its price range and bookable options); a rate_id is valid for 30 minutes.

Quote and ship

Tool	What it does
validate_postal_code	SEPOMEX lookup (state, municipality, colonias) — optional pre-flight
get_shipping_rates	Live multi-carrier rates between two Mexican postal codes; one box (package) or 2–10 boxes as one shipment (packages); optional insurance.insured_value
create_shipment	Buy a label from a quoted rate_id — idempotent (idempotency_key), same boxes as quoted, optional declared_value
get_shipment	One shipment with its current status
list_shipments	Shipments on the account, filterable by status, tracking number and date
get_label	Label PDF link for a shipment
track_shipment	Live tracking by tracking number (guía)
cancel_shipment	Request cancellation (refund follows the carrier's outcome)

Pickups (request-only: our team confirms with the carrier and emails the result)

Tool	What it does
schedule_pickup	Request a carrier pickup at the sender's door for a local time window
get_pickup / list_pickups	Status of pickup requests

Address book

Tool	What it does
list_senders / create_sender	Saved senders
list_recipients / create_recipient	Saved recipients
import_contacts	Bulk import (rows or raw CSV) with a dry-run mode

Webhooks (no polling: shipment.* and pickup.resolved events, HMAC-signed, retried with backoff)

Tool	What it does
register_webhook	Register an https:// endpoint for a set of events (secret shown once)
list_webhooks / delete_webhook	Manage the account's webhooks (5 active per mode)
test_webhook	Deliver a signed ping synchronously

Account

Tool	What it does
whoami	Account, key scopes, mode (sandbox/live) and capabilities of this connection
get_balance	Prepaid balance, holds and available amount
list_transactions	Balance movements (charges, refunds, top-ups)

Every tool ships title, annotations (readOnlyHint / destructiveHint / openWorldHint) and an outputSchema derived from the OpenAPI spec, so structured results are typed. Pickup tools appear only when the feature is open on the account.

Sandbox

ek_test_ keys (or choosing Sandbox in the OAuth consent screen) run every tool against a sandbox with no real money: quotes list only services with a real sandbox behind them (a FedEx test lane plus one simulated offer), labels are durable signed test PDFs, and webhooks receive shipment.created / shipment.cancelled plus ping. Reconnect choosing Producción to ship for real.

Spend safety

Everything charges a prepaid balance with server-side enforcement: create_shipment can never spend more than the available balance nor exceed the key's daily limit. create_shipment accepts an idempotency_key (one is generated and returned if omitted) so retries never double-charge. The MCP adapter is a pure protocol translator over the public REST API — an agent can never do anything a plain REST caller couldn't.

Support

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

---

This repository hosts the public documentation for the hosted server; the server itself is operated by Enviadores.