app.wishpool/japan-logistics-mcp — Model Context Protocol (MCP) Server

Japan shipping labels for AI agents. This MCP server helps an agent buy Yamato, Sagawa, and Japan Post labels and track parcels via Ship&co. It is exposed as an HTTP MCP endpoint and provides tools for logistics operations relevant to Japan shipments.

🛠️ Key Features

Buy Japan shipping labels: Yamato, Sagawa, Japan Post
Track shipments via Ship&co
HTTP-based MCP endpoint at https://logi-jp.wishpool.app/mcp
Tool count: 4

🚀 Use Cases

Shipping parcels in Japan from an AI agent
Obtaining carrier labels for Yamato, Sagawa, or Japan Post
Tracking delivery status through Ship&co

⚡ Developer Benefits

MCP client config example is available for Claude Desktop, Cursor, Windsurf, and other MCP-capable agents
Credentials, when required, are sent as HTTP headers per request and are not stored
Topics include ai-agent, mcp-server, and shipandco

⚠️ Limitations

The readme excerpt only documents usage, endpoint configuration, and credential handling; additional tool details are not provided.

Japan Logistics MCP 🇯🇵 — How can my AI agent ship a parcel in Japan (Yamato / Sagawa / Japan Post via Ship&co)?

Use it in 60 seconds

Paste this into your MCP client config (Claude Desktop, Cursor, Windsurf, or any MCP-capable agent):

json

{
  "mcpServers": {
    "japan-logistics": {
      "type": "http",
      "url": "https://logi-jp.wishpool.app/mcp"
    }
  }
}

Nothing to install. Credentials, when you need them, travel as HTTP headers on each request and are never stored — see the threat model.

Or run it yourself

Would you rather not send production credentials to a server you do not control? Deploy this identical code to your own account and point your agent at your own URL:

bash

git clone https://github.com/junter1989k-ai/japan-logistics-mcp && cd japan-logistics-mcp && npx vercel --prod

MIT-licensed. Self-hosting removes us from the picture entirely, at no cost and with no loss of function.

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

Live endpoint: https://logi-jp.wishpool.app/mcp · Registry: app.wishpool/japan-logistics-mcp

Quick start

json

{
  "mcpServers": {
    "japan-logistics": {
      "type": "http",
      "url": "https://logi-jp.wishpool.app/mcp",
      "headers": {
        "x-shipandco-token": "your_shipandco_api_token"
      }
    }
  }
}

No shared demo — use your own Ship&co account. Get an API token self-serve in the Ship&co Dashboard (API menu → Create New Token) and send it in the header above. The server is stateless: on every call it forwards the token to api.shipandco.com as the x-access-token header and stores nothing.

No carrier contract needed for test mode

create_shipment defaults to test:true, which prints a free, non-billable virtual label end-to-end. Yamato and Sagawa need no extra carrier account for test mode — an agent can validate the whole flow with no carrier contract. Set test:false to buy a real billable label.

Tools

Tool	What it does
`get_rates`	Estimate rates before creating a label (read-only, spends nothing). `from_address`, `to_address`, `weight` (grams) and `products` → available carrier services with `amount` (JPY), cheapest flagged. `/rates` quotes carriers registered in your Ship&co account.
`create_shipment`	Create a shipment and issue the label in one call. `carrier` (`yamato`/`sagawa`/`japanpost`/`seino`/`dhl`/`ups`/`fedex`) + `from_address` + `to_address` + `weight` + `products`. Returns `shipment_id`, `carrier`, `tracking_number(s)`, `label_url` (PDF). `test` defaults true (free); `test:false` buys a real label.
`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 carry `next_steps`. Raw current status + history always included.
`void_label`	Void/cancel a shipment + label by `shipment_id`. TEST labels always; real labels only before pickup.

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. The declared goods value (JPY) is gated before the label is created: approval-above returns an unsigned draft with no label created.

Units & addresses

Weight in grams (g), parcel dimensions in centimetres (cm), money in JPY. Japanese addresses use a 7-digit postal code (郵便番号), prefecture (都道府県) and city/ward (市区町村).

Develop

bash

node test/serve.js   # local server on :3252 (/mcp)
node test/e2e.js     # protocol + schema + validation + policy/shipandco units + CORS + fake-token live probe to api.shipandco.com (expects native Ship&co 403 auth error)

How it talks to Ship&co

Base URL https://api.shipandco.com/v1, auth header x-access-token. create_shipment is POST /shipments (creates the shipment and the label in one call → delivery.label PDF + delivery.tracking_numbers). get_rates is POST /rates. query_tracking is GET /tracking/{carrier}/{tracking_number}. void_label is DELETE /shipments/{id}. Test labels are requested with setup.test:true.

Safety

Pure stateless translation layer. Shipments, labels and tracking are held by Ship&co and the carriers; the API token travels per-request in a header, is forwarded as the x-access-token header, and nothing is stored. Parcels flow sender ↔ carrier ↔ recipient directly. Privacy policy.

Sister servers

USA labels (USPS/UPS/FedEx) via EasyPost in usa-logistics-mcp; Indonesia (JNE/J&T/SiCepat) via Biteship in indonesia-logistics-mcp; Taiwan CVS pickup + home delivery in taiwan-logistics-mcp. One family of stateless BYO local-commerce MCP servers: local payments in 81 countries at mcp.wishpool.app and electronic invoicing at inv.wishpool.app.

MIT licensed.

to_name	string	required	Recipient full name (氏名). Required.
to_company	string	optional	Recipient company name. Optional.
to_email	string	optional	Recipient email. Optional (some carriers/services require it).
to_phone	string	optional	Recipient phone number. Optional but recommended (many Japanese carriers require it).
to_zip	string	required	Recipient 7-digit Japanese postal code 郵便番号 (e.g. "150-0001" or "1500001"). Required.
to_province	string	required	Recipient prefecture 都道府県 (e.g. "Tokyo" / "東京都"). Required.
to_city	string	required	Recipient city / ward / town 市区町村 (e.g. "Shibuya-ku"). Required.
to_address1	string	required	Recipient street address line 1 番地 (chome-banchi-go). Required.
to_address2	string	optional	Recipient street address line 2 (building / room). Optional.
to_country	string	optional	Recipient ISO country code. Default "JP".
from_name	string	required	Sender full name (氏名). Required.
from_company	string	optional	Sender company name. Optional.
from_email	string	optional	Sender email. Optional (some carriers/services require it).
from_phone	string	optional	Sender phone number. Optional but recommended (many Japanese carriers require it).
from_zip	string	required	Sender 7-digit Japanese postal code 郵便番号 (e.g. "150-0001" or "1500001"). Required.
from_province	string	required	Sender prefecture 都道府県 (e.g. "Tokyo" / "東京都"). Required.
from_city	string	required	Sender city / ward / town 市区町村 (e.g. "Shibuya-ku"). Required.
from_address1	string	required	Sender street address line 1 番地 (chome-banchi-go). Required.
from_address2	string	optional	Sender street address line 2 (building / room). Optional.
from_country	string	optional	Sender ISO country code. Default "JP".
weight	number	required	Parcel weight in GRAMS (g). e.g. 1000 = 1 kg. Required.
length	number	optional	Parcel length/depth in CENTIMETRES (cm). Optional — provide length+width+height together if the carrier needs dimensions.
width	number	optional	Parcel width in CENTIMETRES (cm). Optional.
height	number	optional	Parcel height in CENTIMETRES (cm). Optional.
products	array	required	Parcel contents (at least one). Each: { name (required), price (required, JPY per unit), quantity (required int), origin_country? (ISO, for international) }. The declared goods value (sum of price x quantity, JPY) is what the owner policy gate checks.

to_name	string	required	Recipient full name (氏名). Required.
to_company	string	optional	Recipient company name. Optional.
to_email	string	optional	Recipient email. Optional (some carriers/services require it).
to_phone	string	optional	Recipient phone number. Optional but recommended (many Japanese carriers require it).
to_zip	string	required	Recipient 7-digit Japanese postal code 郵便番号 (e.g. "150-0001" or "1500001"). Required.
to_province	string	required	Recipient prefecture 都道府県 (e.g. "Tokyo" / "東京都"). Required.
to_city	string	required	Recipient city / ward / town 市区町村 (e.g. "Shibuya-ku"). Required.
to_address1	string	required	Recipient street address line 1 番地 (chome-banchi-go). Required.
to_address2	string	optional	Recipient street address line 2 (building / room). Optional.
to_country	string	optional	Recipient ISO country code. Default "JP".
from_name	string	required	Sender full name (氏名). Required.
from_company	string	optional	Sender company name. Optional.
from_email	string	optional	Sender email. Optional (some carriers/services require it).
from_phone	string	optional	Sender phone number. Optional but recommended (many Japanese carriers require it).
from_zip	string	required	Sender 7-digit Japanese postal code 郵便番号 (e.g. "150-0001" or "1500001"). Required.
from_province	string	required	Sender prefecture 都道府県 (e.g. "Tokyo" / "東京都"). Required.
from_city	string	required	Sender city / ward / town 市区町村 (e.g. "Shibuya-ku"). Required.
from_address1	string	required	Sender street address line 1 番地 (chome-banchi-go). Required.
from_address2	string	optional	Sender street address line 2 (building / room). Optional.
from_country	string	optional	Sender ISO country code. Default "JP".
weight	number	required	Parcel weight in GRAMS (g). e.g. 1000 = 1 kg. Required.
length	number	optional	Parcel length/depth in CENTIMETRES (cm). Optional — provide length+width+height together if the carrier needs dimensions.
width	number	optional	Parcel width in CENTIMETRES (cm). Optional.
height	number	optional	Parcel height in CENTIMETRES (cm). Optional.
products	array	required	Parcel contents (at least one). Each: { name (required), price (required, JPY per unit), quantity (required int), origin_country? (ISO, for international) }. The declared goods value (sum of price x quantity, JPY) is what the owner policy gate checks.
carrier	string	required	Carrier token (required): "yamato", "sagawa", "japanpost", "seino", "dhl", "ups" or "fedex". For a free TEST label with no carrier account use "yamato" or "sagawa".
service	string	optional	Optional carrier service token, e.g. "yamato_taqbin" / "yamato_collect" (Yamato), "japanpost_ems" (Japan Post), "dhl_express_worldwide" (DHL). Get valid values from get_rates. If the carrier requires a service and it is omitted, Ship&co returns a native error.
test	boolean	optional	TRUE (default) = free non-billable virtual TEST label (Yamato / Sagawa / UPS / DHL need no extra carrier account). FALSE = buy a REAL billable label. Defaults to true to prevent accidental live shipments.
ship_date	string	optional	Optional ship date "YYYY-MM-DD". Defaults to the carrier default if omitted.

Japan Logistics (Ship&co: Yamato / Sagawa / Japan Post labels + tracking)

app.wishpool/japan-logistics-mcp — Model Context Protocol (MCP) Server

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

Topics

get_rates

create_shipment

query_tracking

void_label