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

Official4 toolsLive

by junter1989k-ai · JavaScript

Japan shipping labels for AI agents: buy Yamato, Sagawa, Japan Post labels and track via Ship&co.

Topics

ai-agentclaudejapanlogisticsmcpmcp-serversagawashippingwishpoolyamatoshipandco

Captured live from the server via tools/list.

get_rates

Estimate Japan shipping rates BEFORE creating a label (read-only — quotes only, creates nothing and spends nothing). Given a from_address (sender), a to_address (recipient) and the parcel (weight in GRAMS, dimensions in CENTIMETRES) plus the products, it asks Ship&co for the available carrier services and their prices (JPY), and flags the cheapest. Ship&co reaches Japan domestic couriers Yamato (ヤマト運輸) / Sagawa (佐川急便) / Japan Post (日本郵便) / Seino (西濃運輸) plus international DHL / UPS / FedEx. Use the returned carrier + service in create_shipment. NOTE: /rates returns quotes for the carriers registered in your Ship&co account; if none are registered you can still create TEST labels directly with create_shipment (carrier=yamato or sagawa, setup.test defaults true — no carrier account needed for test mode). Bring your own Ship&co API token via header x-shipandco-token.

Parameters25

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.

Raw schema

{
  "type": "object",
  "properties": {
    "to_name": {
      "type": "string",
      "description": "Recipient full name (氏名). Required."
    },
    "to_company": {
      "type": "string",
      "description": "Recipient company name. Optional."
    },
    "to_email": {
      "type": "string",
      "description": "Recipient email. Optional (some carriers/services require it)."
    },
    "to_phone": {
      "type": "string",
      "description": "Recipient phone number. Optional but recommended (many Japanese carriers require it)."
    },
    "to_zip": {
      "type": "string",
      "description": "Recipient 7-digit Japanese postal code 郵便番号 (e.g. \"150-0001\" or \"1500001\"). Required."
    },
    "to_province": {
      "type": "string",
      "description": "Recipient prefecture 都道府県 (e.g. \"Tokyo\" / \"東京都\"). Required."
    },
    "to_city": {
      "type": "string",
      "description": "Recipient city / ward / town 市区町村 (e.g. \"Shibuya-ku\"). Required."
    },
    "to_address1": {
      "type": "string",
      "description": "Recipient street address line 1 番地 (chome-banchi-go). Required."
    },
    "to_address2": {
      "type": "string",
      "description": "Recipient street address line 2 (building / room). Optional."
    },
    "to_country": {
      "type": "string",
      "description": "Recipient ISO country code. Default \"JP\"."
    },
    "from_name": {
      "type": "string",
      "description": "Sender full name (氏名). Required."
    },
    "from_company": {
      "type": "string",
      "description": "Sender company name. Optional."
    },
    "from_email": {
      "type": "string",
      "description": "Sender email. Optional (some carriers/services require it)."
    },
    "from_phone": {
      "type": "string",
      "description": "Sender phone number. Optional but recommended (many Japanese carriers require it)."
    },
    "from_zip": {
      "type": "string",
      "description": "Sender 7-digit Japanese postal code 郵便番号 (e.g. \"150-0001\" or \"1500001\"). Required."
    },
    "from_province": {
      "type": "string",
      "description": "Sender prefecture 都道府県 (e.g. \"Tokyo\" / \"東京都\"). Required."
    },
    "from_city": {
      "type": "string",
      "description": "Sender city / ward / town 市区町村 (e.g. \"Shibuya-ku\"). Required."
    },
    "from_address1": {
      "type": "string",
      "description": "Sender street address line 1 番地 (chome-banchi-go). Required."
    },
    "from_address2": {
      "type": "string",
      "description": "Sender street address line 2 (building / room). Optional."
    },
    "from_country": {
      "type": "string",
      "description": "Sender ISO country code. Default \"JP\"."
    },
    "weight": {
      "type": "number",
      "description": "Parcel weight in GRAMS (g). e.g. 1000 = 1 kg. Required."
    },
    "length": {
      "type": "number",
      "description": "Parcel length/depth in CENTIMETRES (cm). Optional — provide length+width+height together if the carrier needs dimensions."
    },
    "width": {
      "type": "number",
      "description": "Parcel width in CENTIMETRES (cm). Optional."
    },
    "height": {
      "type": "number",
      "description": "Parcel height in CENTIMETRES (cm). Optional."
    },
    "products": {
      "type": "array",
      "description": "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.",
      "items": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string",
            "description": "Product name (品名)."
          },
          "price": {
            "type": "number",
            "description": "Unit price in JPY. Required (used for the declared value and the owner policy gate)."
          },
          "quantity": {
            "type": "number",
            "description": "Quantity (integer >= 1). Required."
          },
          "origin_country": {
            "type": "string",
            "description": "ISO origin country code (for international customs). Optional."
          }
        },
        "required": [
          "name",
          "price",
          "quantity"
        ]
      }
    }
  },
  "required": [
    "to_name",
    "to_zip",
    "to_province",
    "to_city",
    "to_address1",
    "from_name",
    "from_zip",
    "from_province",
    "from_city",
    "from_address1",
    "weight",
    "products"
  ]
}

create_shipment

Create a Japan shipping label via Ship&co in ONE call — pass a carrier (yamato / sagawa / japanpost / seino / dhl / ups / fedex), a from_address (sender) and to_address (recipient) with a 7-digit Japanese postal code (郵便番号), prefecture (都道府県) and city (市区町村), the parcel (weight in GRAMS, dimensions in CENTIMETRES) and the products. Ship&co creates the shipment AND issues the label in one step, returning shipment_id, carrier, tracking_number(s) and a printable label PDF (label_url). Ship&co reaches Japan domestic couriers Yamato (ヤマト運輸) / Sagawa (佐川急便) / Japan Post (日本郵便) / Seino (西濃運輸) plus international DHL / UPS / FedEx. TEST MODE IS THE DEFAULT (test:true → free non-billable virtual label; Yamato / Sagawa need no carrier account for test mode) — set test:false to buy a REAL billable label. Bring your own Ship&co API token via header x-shipandco-token (self-serve in the Ship&co Dashboard: API menu -> Create New Token). Owner policy headers gate the declared goods value (JPY) before creation.

Parameters29

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.

Raw schema

{
  "type": "object",
  "properties": {
    "to_name": {
      "type": "string",
      "description": "Recipient full name (氏名). Required."
    },
    "to_company": {
      "type": "string",
      "description": "Recipient company name. Optional."
    },
    "to_email": {
      "type": "string",
      "description": "Recipient email. Optional (some carriers/services require it)."
    },
    "to_phone": {
      "type": "string",
      "description": "Recipient phone number. Optional but recommended (many Japanese carriers require it)."
    },
    "to_zip": {
      "type": "string",
      "description": "Recipient 7-digit Japanese postal code 郵便番号 (e.g. \"150-0001\" or \"1500001\"). Required."
    },
    "to_province": {
      "type": "string",
      "description": "Recipient prefecture 都道府県 (e.g. \"Tokyo\" / \"東京都\"). Required."
    },
    "to_city": {
      "type": "string",
      "description": "Recipient city / ward / town 市区町村 (e.g. \"Shibuya-ku\"). Required."
    },
    "to_address1": {
      "type": "string",
      "description": "Recipient street address line 1 番地 (chome-banchi-go). Required."
    },
    "to_address2": {
      "type": "string",
      "description": "Recipient street address line 2 (building / room). Optional."
    },
    "to_country": {
      "type": "string",
      "description": "Recipient ISO country code. Default \"JP\"."
    },
    "from_name": {
      "type": "string",
      "description": "Sender full name (氏名). Required."
    },
    "from_company": {
      "type": "string",
      "description": "Sender company name. Optional."
    },
    "from_email": {
      "type": "string",
      "description": "Sender email. Optional (some carriers/services require it)."
    },
    "from_phone": {
      "type": "string",
      "description": "Sender phone number. Optional but recommended (many Japanese carriers require it)."
    },
    "from_zip": {
      "type": "string",
      "description": "Sender 7-digit Japanese postal code 郵便番号 (e.g. \"150-0001\" or \"1500001\"). Required."
    },
    "from_province": {
      "type": "string",
      "description": "Sender prefecture 都道府県 (e.g. \"Tokyo\" / \"東京都\"). Required."
    },
    "from_city": {
      "type": "string",
      "description": "Sender city / ward / town 市区町村 (e.g. \"Shibuya-ku\"). Required."
    },
    "from_address1": {
      "type": "string",
      "description": "Sender street address line 1 番地 (chome-banchi-go). Required."
    },
    "from_address2": {
      "type": "string",
      "description": "Sender street address line 2 (building / room). Optional."
    },
    "from_country": {
      "type": "string",
      "description": "Sender ISO country code. Default \"JP\"."
    },
    "weight": {
      "type": "number",
      "description": "Parcel weight in GRAMS (g). e.g. 1000 = 1 kg. Required."
    },
    "length": {
      "type": "number",
      "description": "Parcel length/depth in CENTIMETRES (cm). Optional — provide length+width+height together if the carrier needs dimensions."
    },
    "width": {
      "type": "number",
      "description": "Parcel width in CENTIMETRES (cm). Optional."
    },
    "height": {
      "type": "number",
      "description": "Parcel height in CENTIMETRES (cm). Optional."
    },
    "products": {
      "type": "array",
      "description": "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.",
      "items": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string",
            "description": "Product name (品名)."
          },
          "price": {
            "type": "number",
            "description": "Unit price in JPY. Required (used for the declared value and the owner policy gate)."
          },
          "quantity": {
            "type": "number",
            "description": "Quantity (integer >= 1). Required."
          },
          "origin_country": {
            "type": "string",
            "description": "ISO origin country code (for international customs). Optional."
          }
        },
        "required": [
          "name",
          "price",
          "quantity"
        ]
      }
    },
    "carrier": {
      "type": "string",
      "description": "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": {
      "type": "string",
      "description": "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": {
      "type": "boolean",
      "description": "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": {
      "type": "string",
      "description": "Optional ship date \"YYYY-MM-DD\". Defaults to the carrier default if omitted."
    }
  },
  "required": [
    "carrier",
    "to_name",
    "to_zip",
    "to_province",
    "to_city",
    "to_address1",
    "from_name",
    "from_zip",
    "from_province",
    "from_city",
    "from_address1",
    "weight",
    "products"
  ]
}

query_tracking

Track a Japan shipment by its carrier + tracking_number (the tracking number create_shipment returned, or any carrier tracking number). Returns the current status with a plain-English hint. Status values (Ship&co enum): collected, transit, out_for_delivery, delivered, exception, returned. The raw current_status details, location and full scan history are always included. Non-terminal statuses carry next_steps. Safe to call anytime.

Parameters2

carrier	string	required	Carrier token for the lookup: "yamato", "sagawa", "japanpost", "seino", "dhl", "ups", "fedex". Required.
tracking_number	string	required	The tracking number to look up (from create_shipment, or a carrier tracking number). Required.

Raw schema

{
  "type": "object",
  "properties": {
    "carrier": {
      "type": "string",
      "description": "Carrier token for the lookup: \"yamato\", \"sagawa\", \"japanpost\", \"seino\", \"dhl\", \"ups\", \"fedex\". Required."
    },
    "tracking_number": {
      "type": "string",
      "description": "The tracking number to look up (from create_shipment, or a carrier tracking number). Required."
    }
  },
  "required": [
    "carrier",
    "tracking_number"
  ]
}

void_label

Void / cancel a Japan shipment (and its label) created by create_shipment, by its shipment_id. Use this to cancel a label you created by mistake before the parcel is handed to the carrier. TEST labels can always be voided; a REAL label can only be voided while it has not yet been shipped/scanned — an already-collected parcel cannot be voided here. Returns the void result reported by Ship&co.

Parameters1

shipment_id

string

required

The Ship&co shipment id to void (the shipment_id create_shipment returned). Required.

Raw schema

{
  "type": "object",
  "properties": {
    "shipment_id": {
      "type": "string",
      "description": "The Ship&co shipment id to void (the shipment_id create_shipment returned). Required."
    }
  },
  "required": [
    "shipment_id"
  ]
}

README.md6 KBView on GitHub

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.

Install

Tools (4)

get_ratescreate_shipmentquery_trackingvoid_label

Remote endpoint

Streamable HTTP

Hosted server - connect over the network, no local install.

url

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

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "japan-logistics-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://logi-jp.wishpool.app/mcp"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.