proship-mcp
Stateless MCP (Model Context Protocol) server that lets any AI agent create Thailand Post shipments, print labels, and track parcels through ProShip.
- Endpoint:
POST https://mcp.proship.me/mcp (JSON-RPC 2.0, application/json)
- Docs: open
https://mcp.proship.me/mcp in a browser — the docs page is generated from the live tool registry
- Auth:
Authorization: Bearer <ProShip API token>, passed through verbatim to api.proship.me. Nothing is stored server-side. New users can call the public signup tool to get a token.
Tools
Public: track_parcel, get_order_statuses, signup.
Authenticated: list_shops, create_order, list_orders, get_order, update_order_status, cancel_order, check_duplicate, print_label.
The browser docs page at /mcp is the canonical, always-current tool reference.
Run
Environment
Deploy
Fly.io app proship-mcp (region sin):
Notes
- Order ids are pipe-suffixed (
order-xxx|123). GET/PUT/DELETE strip the suffix internally; print_label requires the full id. Always pass the full id between tools.
- Weights are grams. Status codes use the Thai pipeline (
get_order_statuses); code 6 means out for delivery despite upstream labeling it "ERROR".
- The only server state is a 10-minute in-memory cache for label PDFs so
print_label can return a URL.