proship-mcp

Servidor MCP (Model Context Protocol) sin estado que permite a cualquier agente de IA crear envíos de Thailand Post, imprimir etiquetas y rastrear paquetes a través de ProShip.

• Punto de conexión: POST https://mcp.proship.me/mcp (JSON-RPC 2.0, application/json)

• Documentación: abre https://mcp.proship.me/mcp en un navegador — la página de documentación se genera a partir del registro de herramientas en vivo.

• Autenticación: Authorization: Bearer <ProShip API token>, se pasa textualmente a api.proship.me. No se almacena nada en el servidor. Los nuevos usuarios pueden llamar a la herramienta pública signup para obtener un token.

Herramientas

Públicas: track_parcel, get_order_statuses, signup. Autenticadas: list_shops, create_order, list_orders, get_order, update_order_status, cancel_order, check_duplicate, print_label.

La página de documentación en el navegador en /mcp es la referencia canónica y siempre actualizada de las herramientas.

Related MCP server: shipsaving-mcp

Ejecución

npm install
npm start          # listens on PORT (default 3000)
npm test           # node:test suite, upstream fully mocked

Variables de entorno

Despliegue

Aplicación Fly.io proship-mcp (región sin):

fly deploy            # add --depot=false if the Depot builder fails

Notas

• Los IDs de pedidos tienen un sufijo de tubería (order-xxx|123). GET/PUT/DELETE eliminan el sufijo internamente; print_label requiere el ID completo. Siempre pasa el ID completo entre las herramientas.

• Los pesos están en gramos. Los códigos de estado usan el pipeline tailandés (get_order_statuses); el código 6 significa en reparto a pesar de que la fuente upstream lo etiqueta como "ERROR".

• El único estado del servidor es una caché en memoria de 10 minutos para los PDF de las etiquetas, de modo que print_label pueda devolver una URL.