# Skydropx MCP

> Servidor MCP oficial de Skydropx, la plataforma de envíos para negocios en México. Conecta Claude, ChatGPT o Gemini a tu cuenta y cotiza, compra guías, rastrea envíos, agenda recolecciones y administra pedidos de tus tiendas con lenguaje natural. 48 herramientas tipadas sobre la API de Skydropx; OAuth 2.1 con PKCE; ninguna compra sin que el usuario elija y confirme una tarifa.

- Landing: https://ia.skydropx.com/
- Servidor MCP (producción, Streamable HTTP): https://mcp.skydropx.com
- Servidor MCP (sandbox): https://sb-mcp.skydropx.com
- Metadatos OAuth: https://mcp.skydropx.com/.well-known/oauth-authorization-server
- App: https://app.skydropx.com · Sitio: https://www.skydropx.com
- Lista completa de herramientas: https://ia.skydropx.com/llms-full.txt

## Qué hace

- Cotiza con todas las paqueterías conectadas (Estafeta, DHL, FedEx, Paquetexpress, 99minutos y más) usando las tarifas negociadas de la cuenta.
- Compra guías y devuelve la etiqueta PDF y el número de rastreo; solo `create_shipment` / `create_shipment_for_order` gastan saldo y requieren una tarifa elegida por el usuario.
- Lee pedidos de Shopify, WooCommerce, Wix, MercadoLibre, Tiendanube y otras tiendas conectadas y genera la guía del pedido.
- Rastrea envíos, agenda y reagenda recolecciones, asegura paquetes (SOS Protección), cancela guías.
- Administra libreta de direcciones, reglas de envío del checkout, códigos de Carta Porte (SAT) y tipos de empaque.
- Consulta saldo, movimientos y un feed de eventos verificable para agentes sin webhooks.

## Cómo conectar

- Claude (claude.ai, escritorio): Ajustes → Conectores → Añadir conector personalizado → URL `https://mcp.skydropx.com`. Claude descubre OAuth automáticamente.
- Claude Code: `claude mcp add --transport http skydropx https://mcp.skydropx.com`
- ChatGPT (Team/Enterprise, GPTs): Ajustes → Conectores → Añadir conector MCP → URL `https://mcp.skydropx.com`, autenticación OAuth.
- Gemini CLI: en `~/.gemini/settings.json`, `mcpServers.skydropx.httpUrl = "https://mcp.skydropx.com"`, `oauth.enabled = true`.

## Garantías

- Esquemas JSON cerrados: argumentos desconocidos se rechazan en el servidor.
- Autorización por herramienta fuera del modelo; el asistente actúa como el operador autenticado, dentro de su cuenta y permisos.
- Anotaciones MCP read-only / destructive / idempotent en cada herramienta; 30 herramientas son de solo lectura.
- Las compras se deduplican por `rate_id` hasta 96 horas para evitar guías dobles.

## Herramientas (48)

### Cotización y tarifas

- `quote_shipment` — Quote a shipment (solo lectura). Quote a shipment: returns available carrier rates for the given origin/destination and parcel(s).
- `rate_shipment` — Rate a shipment (solo lectura). Get carrier rates for a shipment described as one `shipment` object (same fields as quote_shipment: address_from, address_to, parcel or parcels...).
- `get_quotation` — Get quotation (solo lectura). Retrieve an existing quotation and all of its rates by id.
- `list_carrier_services` — List carrier services (solo lectura). List the carrier services available for shipments (paginated).
- `list_office_points` — List drop-off points (solo lectura). List the carrier office points applicable to a quoted rate: `delivery` (recipient collects at an office → office_delivery_point_id) or `pickup` (sender drops o…
- `list_extra_charges` — List extra charges (solo lectura). List extra charges (e.g.

### Guías y envíos

- `create_shipment` — Create shipment (buy label) (escritura · requiere confirmación). Create (purchase) a shipment from a quotation rate — THIS is the tool that buys the label.
- `create_shipment_for_order` — Create shipment for order (escritura · requiere confirmación). Create a shipment (label) for an existing order.
- `get_shipment` — Get shipment (solo lectura). Retrieve a shipment by id, including packages and addresses.
- `list_shipments` — List shipments (solo lectura). List shipments for the current headquarter, paginated.
- `cancel_shipment` — Cancel shipment (destructivo). Cancel a shipment by id (requires cancellations to be enabled for the headquarter).
- `protect_shipment` — Insure shipment (escritura · requiere confirmación). Protect a shipment (insurance) for a declared value.
- `track_shipment` — Track shipment (solo lectura). Get tracking status and events for a shipment by carrier name and tracking number.
- `list_order_labels` — List order labels (solo lectura). List shipping labels generated for an order.

### Pedidos y tiendas

- `list_orders` — List orders (solo lectura). List orders for the current headquarter, most recent first, paginated.
- `get_order` — Get order (solo lectura). Retrieve an order by id (or ecommerce reference id).
- `create_order` — Create order (escritura · requiere confirmación). Create an order from an ecommerce-style payload (merchant_store_id, reference, addresses, products, parcels, payment info).
- `update_order` — Update order (escritura). Update an order by id with a partial order payload; Skydropx re-quotes it.
- `list_merchant_stores` — List connected stores (solo lectura). List the merchant's connected ecommerce stores (Shopify, WooCommerce, Wix...), paginated.
- `get_merchant_store` — Get connected store (solo lectura). Retrieve a connected merchant store (ecommerce integration) by id.
- `update_merchant_store` — Update connected store (escritura). Update a connected merchant store's settings by id.
- `list_merchant_store_carriers` — List store carriers (solo lectura). List the carriers enabled for a connected merchant store.

### Reglas de checkout

- `list_conditional_tariffs` — List checkout shipping rules (solo lectura). List the merchant's checkout shipping rules (conditional tariffs): weight/price ranges mapped to an action like free shipping, flat price or live rates.
- `create_conditional_tariff` — Create checkout shipping rule (escritura). Create a checkout shipping rule (conditional tariff) for a connected store — e.g.

### Recolecciones

- `schedule_pickup` — Schedule pickup (escritura · requiere confirmación). Schedule a carrier pickup for an existing shipment within a time window.
- `reschedule_pickup` — Reschedule pickup (escritura). Reschedule the latest pickup of a shipment to a new time window.
- `pickup_coverage` — Check pickup coverage (solo lectura). Check which pickup dates are available for an existing shipment (coverage is computed from the shipment's carrier and origin address).
- `list_pickups` — List pickups (solo lectura). List scheduled pickups for the current headquarter, paginated.
- `get_pickup` — Get pickup (solo lectura). Retrieve a scheduled pickup by id, including its address.

### Direcciones y catálogos

- `list_address_templates` — List saved addresses (solo lectura). The merchant's saved address book (frequent customers, own warehouses).
- `get_address_template` — Get saved address (solo lectura). Retrieve a saved address template by id.
- `create_address_template` — Save address (escritura). Save a new address template to the address book.
- `update_address_template` — Update saved address (escritura). Update a saved address template by id.
- `delete_address_template` — Delete saved address (destructivo). Delete a saved address template by id.
- `verify_address_by_carriers` — Verify address with carriers (escritura). Validate a saved address template against carrier address rules.
- `lookup_postal_code` — Look up postal code (solo lectura). Resolve a postal code (CP) into its estado (area_level1), municipio (area_level2) and the list of colonias (area_level3).
- `list_packagings` — List packaging types (solo lectura). List the valid packaging types for shipments (code + name, e.g.
- `list_consignment_notes` — List consignment note codes (solo lectura). Search the valid consignment-note (carta porte SAT) codes for shipments.
- `list_products` — List products (solo lectura). List the headquarter's catalog products, paginated.

### Envíos externos y rastreo propio

- `create_external_shipment` — Register external shipment (escritura). Register an external shipment (one fulfilled outside Skydropx) so it can be tracked: carrier_custom_code, tracking_number, recipient + parcel details.
- `import_external_shipments` — Import external shipments (escritura). Bulk-import up to shipments bought outside Skydropx so they are tracked here.
- `get_external_shipment_import` — Get external shipment import (solo lectura). Get the status/result of an external-shipment bulk import by id.
- `push_tracking_event` — Push tracking event (escritura). Ingest a tracking status for an HQ-owned custom carrier shipment (custom carriers have no provider feed, so statuses are pushed here).

### Finanzas y cuenta

- `get_credits` — Get credit balance (solo lectura). Return the current headquarter's credit balance.
- `transaction_stats` — List account transactions (solo lectura). List the account's transactions (movements such as label charges and refunds) one page at a time, optionally filtered by search text, kind and date range.
- `get_events_since` — Get events since cursor (solo lectura). Pull events recorded for your account since a cursor, without needing a webhook endpoint.
- `whoami` — Who am I (solo lectura). Return the current Skydropx identity (headquarter/user/country) and verify the authenticated connection to the Skydropx API.
- `disconnect` — Disconnect #{Brand.name} (destructivo · requiere confirmación). Disconnect Skydropx from this assistant.

## Vocabulario (es-MX)

guía = etiqueta de envío (label) · paquetería = carrier · cotizar = quote · recolección = pickup · CP = código postal · Carta Porte = complemento fiscal SAT para transporte · SOS Protección = seguro de envío · saldo = créditos prepagados de la cuenta.

## Contacto

Skydropx · https://www.skydropx.com · Docs MCP: https://ia.skydropx.com/