# Japan Logistics MCP

> A remote MCP server that lets any AI agent ship parcels in Japan — via Ship&co, over Yamato (ヤマト運輸), Sagawa (佐川急便), Japan Post (日本郵便) and Seino (西濃運輸), plus international DHL / UPS / FedEx. Estimate carrier rates, create shipping labels (one call = shipment + label PDF), track parcels and void labels. Stateless, bring-your-own Ship&co API token, never stores anything.

- MCP endpoint (Streamable HTTP): https://logi-jp.wishpool.app/mcp
- Credential header: x-shipandco-token (your Ship&co API token — get one self-serve in the Ship&co Dashboard: API menu -> Create New Token). No shared demo token. Stateless: every call forwards the token to https://api.shipandco.com/v1 as the x-access-token header, then stores nothing.
- Test mode (no carrier contract needed): create_shipment defaults to setup.test:true = a free, non-billable virtual label end-to-end. Yamato and Sagawa need no extra carrier account for test mode. Set test:false to buy a real billable label.
- Units: weight in GRAMS (g), parcel dimensions in CENTIMETRES (cm), money in JPY. Japanese addresses use a 7-digit postal code (郵便番号), prefecture (都道府県) and city/ward (市区町村).
- Flow: get_rates (optional; from/to address + parcel + products -> carrier services + prices, cheapest flagged; needs carriers registered in your Ship&co account) -> create_shipment (carrier + from/to address + parcel + products -> shipment_id + tracking_number + label PDF) -> query_tracking (carrier + tracking_number). void_label cancels a label before pickup.

## Tools

- get_rates: Estimate rates BEFORE creating a label (read-only, spends nothing). Required: from_address (from_name/from_zip/from_province/from_city/from_address1), to_address (to_*), weight (grams), products (array of { name, price JPY, quantity }). Optional: length/width/height (cm), country codes, phones/emails. Returns available carrier services (carrier, service, amount JPY), the cheapest, and serviceable=true/false. NOTE: /rates only quotes carriers registered in your Ship&co account; TEST labels still work directly via create_shipment with no carrier account.
- create_shipment: Create a shipment AND issue the label in ONE call. Required: carrier (yamato/sagawa/japanpost/seino/dhl/ups/fedex), from_address, to_address, weight (grams), products (array of { name, price JPY, quantity }). Optional: service (from get_rates), test (boolean, DEFAULT TRUE = free non-billable label; false = real billable label), ship_date, dimensions, phones/emails/company/address2, product origin_country. Returns shipment_id, carrier, tracking_number(s), label_url (PDF), estimated_delivery_date, declared_value_jpy. Owner policy gates the declared goods value (JPY) before creation.
- query_tracking: Track by carrier + tracking_number. Status enum (Ship&co): collected, transit, out_for_delivery, delivered, exception, returned — each with a plain-English hint; non-terminal statuses include next_steps. Raw current_status, location and full history always included.
- void_label: Void/cancel a shipment + label by shipment_id. TEST labels can always be voided; a real label only before it is shipped/scanned.
- Owner policy guardrails: x-agentpay-max-amount (hard cap on declared value JPY), x-agentpay-approval-above (returns an unsigned draft for human review — no label created), x-agentpay-allowed-tools (tool allow-list) — set by the human owner in the MCP client config; the agent cannot relax them. The declared goods value (sum of price x quantity, JPY) is gated before creation.

## Safety

Stateless translation layer. The Ship&co API token travels per-request in a header, is forwarded to Ship&co as the x-access-token header, and is never stored; shipments, labels and tracking are held by Ship&co and the carriers, never here. Parcels flow sender <-> carrier <-> recipient directly. Privacy policy: https://logi-jp.wishpool.app/privacy

## Sister servers

USA labels (USPS/UPS/FedEx via EasyPost): https://logi-us.wishpool.app/mcp . Indonesia labels (JNE/J&T/SiCepat via Biteship): https://logi-id.wishpool.app/mcp . Taiwan CVS pickup + home delivery: https://logi-tw.wishpool.app/mcp . One family of stateless BYO local-commerce MCP servers: local payments in 81 countries (https://mcp.wishpool.app/llms.txt) and electronic invoicing (https://inv.wishpool.app/llms.txt).