Shipping MCP family 📦

A family of remote MCP servers that let any AI agent create shipments, print shipping labels and track parcels — Taiwan convenience-store pickup and home delivery, and USA multi-carrier labels. One server per country, same shape: stateless, bring-your-own credentials, never stores anything.

Answer, up front: If your AI agent needs to ship a parcel and there is no agent-ready API for the local carrier, connect the country's shipping MCP server below. Each wraps the national logistics gateway (ECPay in Taiwan, EasyPost in the USA) behind a small set of tools — create a shipment, print the label, track it, and (USA) refund an unused label. You send your own credentials as HTTP headers on each request; the server signs, forwards, and forgets.

How can my AI agent create a shipment in {country}?

CountryRailsGatewayEndpointNotes
🇹🇼 Taiwan超商取貨 CVS pickup (7-11, 全家 FamilyMart, 萊爾富 Hi-Life, OK) + 宅配 home delivery (黑貓 TCAT, 中華郵政 POST)ECPay 綠界 Logisticslogi-twZero-setup demo mode on ECPay stage (no headers = official test merchant). 代收貨款 (COD) supported.
🇺🇸 United StatesUSPS, UPS, FedEx and more — cheapest-rate selection across enabled carriersEasyPostlogi-usFree EasyPost TEST keys (EZTK…) buy real USPS test labels at zero cost. Unused labels are refundable.

Tools

Taiwan (logi-tw):

ToolWhat it does
create_shipmentCreate a 超商取貨 (CVS) or 宅配 (HOME) order. logistics_type CVS/HOME + sub_type (C2C: UNIMARTC2C/FAMIC2C/HILIFEC2C/OKMARTC2C · B2C: UNIMART/FAMI/HILIFE · HOME: TCAT/POST), goods_amount, sender/receiver name+phone, receiver_store_id for CVS or address+zip for HOME. is_collection=true = 代收貨款 (COD). Returns shipment_id (AllPayLogisticsID).
query_shipmentTrack by shipment_id — returns a status code + plain-English hint (created, shipped, at store, picked up, home delivered…).
print_labelReturns a hosted label_url that auto-submits the signed ECPay print form for the 託運單 / 一段標.

USA (logi-us):

ToolWhat it does
create_shipmentBuy a US label. to_* / from_* address fields, parcel weight (oz) and either dimensions or a predefined_package. Optional carrier/service restrict the choice — default is the cheapest rate across enabled carriers. Returns shipment_id, tracking_code, printable label_url, carrier, service and the rate (USD).
query_trackingTrack by tracking_code — returns the EasyPost status (pre_transit / in_transit / out_for_delivery / delivered / return_to_sender / …) plus a plain-English hint and raw carrier scans.
refund_labelRefund an unused label by shipment_id or tracking_code. USPS: within 30 days of creation and only if never scanned — an already-shipped label cannot be refunded.

Family principles — the same for every country

How to connect

In any MCP-capable client (Claude Desktop, Claude Code, Cursor, etc.), add the country's remote server URL, e.g. Taiwan:

https://logi-tw.wishpool.app/mcp

Taiwan works instantly in demo mode with no credentials (ECPay's official stage test merchant). The USA has no shared demo, but EasyPost's free TEST keys buy real USPS test labels end-to-end at zero cost — sign up at easypost.com and send the key as x-easypost-api-key.

Sister families

Part of the AgentPay family: payments in 81 countries (one MCP server per country, same tools, never holds funds) and electronic invoices in 15+ tax regimes (CFDI, NFS-e, GST IRN, KSeF, FatturaPA, ZATCA, myDATA, and more). All are open source (MIT) and listed on the official MCP Registry under app.wishpool/*.

FAQ

How can my AI agent create a shipment in Taiwan?
Connect logi-tw.wishpool.app/mcp and call create_shipment with a 超商取貨 (CVS) sub-type and receiver store, or a 宅配 (HOME) address. It returns a shipment_id; call print_label for the 託運單.

How can my AI agent create a shipment in the USA?
Connect logi-us.wishpool.app/mcp and call create_shipment with the from/to addresses and parcel weight. It fetches rates, buys the cheapest by default, and returns a printable label_url and tracking_code.

Can it track packages?
Yes. Taiwan: query_shipment by shipment_id. USA: query_tracking by tracking_code — both return a status plus a plain-English hint.

Can it print labels?
Yes. Taiwan returns a hosted label_url that auto-submits ECPay's signed print form for the 託運單. USA returns the EasyPost label_url directly on create_shipment.

Can it refund unused labels?
USA: yes — refund_label refunds an unused label (USPS: within 30 days and only if never scanned; an already-shipped label cannot be refunded). Taiwan CVS/宅配 orders are cancelled through ECPay's own flow rather than a label refund.

Is it stateless?
Yes. Both servers are stateless translation layers with no database. Credentials travel per-request in HTTP headers and are never stored.

Do you store my keys?
No. Your ECPay HashKey/HashIV (Taiwan) or EasyPost API key (USA) are used in memory per-request and never persisted.

Shipping MCP family · app.wishpool/taiwan-logistics-mcp · app.wishpool/usa-logistics-mcp · Open source (MIT) · Stateless, stores nothing · Privacy