Taiwan Logistics MCP Server

Taiwan Logistics MCP 🇹🇼 — How can my AI agent create a 超商取貨 / 宅配 shipment in Taiwan?

Remote MCP server that lets any AI agent create Taiwan shipments — 超商取貨 (CVS store pickup / 店到店: 7-11, 全家 FamilyMart, 萊爾富 Hi-Life, OK) and 宅配 (home delivery: 黑貓 TCAT, 中華郵政 POST) — print shipping labels (託運單) and track parcels via the ECPay 綠界 Logistics API. Stateless, bring-your-own credentials, never stores anything. Zero-setup demo mode on ECPay stage.

Live endpoint: https://logi-tw.wishpool.app/mcp · Registry: app.wishpool/taiwan-logistics-mcp

Quick start

{
  "mcpServers": {
    "taiwan-logistics": {
      "type": "http",
      "url": "https://logi-tw.wishpool.app/mcp",
      "headers": {
        "x-ecpay-merchant-id": "your-merchant-id",
        "x-ecpay-hash-key": "your-hash-key",
        "x-ecpay-hash-iv": "your-hash-iv"
      }
    }
  }
}

No headers = demo mode. The server falls back to ECPay's official public test merchant on the stage host, so create_shipment returns a real test AllPayLogisticsID and you can try the whole flow instantly. Add "x-ecpay-mode": "production" to hit the live host. The same ECPay triplet also powers taiwan-payments-mcp.

Tools

Owner policy guardrails ride optional headers (x-agentpay-max-amount, x-agentpay-approval-above, x-agentpay-allowed-tools) — set by the human owner in client config; the agent cannot relax them. Applied to goods / COD amounts.

Develop

node test/serve.js   # local server on :3233 (/mcp + /label)
node test/e2e.js     # protocol + validation + AES/CheckMac unit test + REAL stage shipment

How it talks to ECPay

create_shipment / query_shipment are server-to-server form POSTs to ECPay's /Express/Create and /Helper/QueryLogisticsTradeInfo/V2, signed with a CheckMacValue (MD5, quote_plus + lowercase) exactly as ECPay's official Logistic_Python SDK does — not the AES v2 temp-trade envelope. print_label returns a URL to our /label page, which auto-submits a signed form to ECPay's printTradeDocument (browser POST, like the payments /pay pattern).

Safety

Pure stateless translation layer. The 託運單 is generated and served by ECPay; the ECPay HashKey/HashIV travel per-request in headers, nothing is stored. Parcels flow sender ↔ ECPay/carrier ↔ receiver directly. Privacy policy.

Sister servers

Taiwan payments and 電子發票 (e-invoice) — same ECPay merchant triplet — live in taiwan-payments-mcp. One family of stateless BYO local-commerce MCP servers: local payments in 81 countries, plus invoice servers for Mexico CFDI (inv-mx) · Brazil NF-e (inv-br) · Chile DTE (inv-cl) · Peru CPE (inv-pe) · India GST (inv-in).

MIT licensed.