# Taiwan Logistics MCP

> A 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.

- MCP endpoint (Streamable HTTP): https://logi-tw.wishpool.app/mcp
- Credentials headers: x-ecpay-merchant-id, x-ecpay-hash-key, x-ecpay-hash-iv (your ECPay logistics merchant triplet). Add x-ecpay-mode: production for the live host (default: stage/test).
- Demo: with no credential headers the server uses ECPay's official public test merchant on the stage host — create_shipment returns a real test AllPayLogisticsID so agents can try the whole flow with zero setup.
- Flow: create_shipment (returns AllPayLogisticsID) -> print_label (open label_url to print the 託運單/一段標) -> query_shipment (track status). Amounts in TWD. is_collection=true = 代收貨款 (cash on delivery).

## Tools

- create_shipment: Create a 超商取貨 (CVS) or 宅配 (HOME) order. logistics_type CVS|HOME + sub_type (UNIMARTC2C/FAMIC2C/HILIFEC2C/OKMARTC2C for C2C, UNIMART/FAMI/HILIFE for B2C, TCAT/POST for home), goods_amount, sender/receiver name+phone, receiver_store_id for CVS or address+zip for home. Returns AllPayLogisticsID (shipment_id).
- query_shipment: Track a shipment by AllPayLogisticsID — returns status_code + plain-English hint (300 created, 2063 shipped, 2067/3006 at store, 2073/3022 picked up, 5058 home delivered, etc.).
- print_label: Returns a hosted label_url that auto-submits the signed ECPay print form for the 託運單/一段標.
- Owner policy guardrails: x-agentpay-max-amount (hard cap), x-agentpay-approval-above (returns an unsigned draft for human review), x-agentpay-allowed-tools (tool allow-list) — set by the human owner in the MCP client config; the agent cannot relax them. Applied to goods/COD amounts.

## Safety

Stateless translation layer. The ECPay HashKey/HashIV travel per-request in headers and are never stored; shipping labels are generated and served by ECPay, never held here. Parcels flow sender <-> ECPay/carrier <-> receiver directly. Privacy policy: https://logi-tw.wishpool.app/privacy

## Sister servers

Taiwan payments and 電子發票 (e-invoice) — same ECPay merchant triplet — live in taiwan-payments-mcp: https://mcp.wishpool.app/mcp . One family of stateless BYO local-commerce MCP servers: local payments in 81 countries (https://mcp.wishpool.app/llms.txt), plus invoice servers for Mexico CFDI, Brazil NF-e, Chile DTE, Peru CPE and India GST.