Live shipping quotes from Japan

1. Choose the service

ShipMate has two services with different billing models. The customer's physical location decides which endpoint is correct.

2. Quote an exact weight

Pass the destination as an ISO 3166-1 alpha-3 code and the actual weight in kilograms. Decimals are supported. For example, this asks for Send It Home shipping of 4.6 kg from Japan to Norway (NOR):

curl --get \
  'https://www-api.shipmate.jp/shipping-price/send-it-home' \
  --data-urlencode 'country_code=NOR' \
  --data-urlencode 'weight_kg=4.6'

For Shop for Me, use the same parameters at https://www-api.shipmate.jp/shipping-price/shop-for-me. Do not interpolate between rate-table tiers: EMS rounds into brackets, so interpolation can underquote.

3. Read the response before quoting it

A successful response returns the selected service, exact weight, whole-yen price, carrier, booking URL, and explicit includes and excludes arrays. The service fee is already applied; never add another fee on top.

• is_estimate is always true. The binding price is calculated after the parcel is weighed and measured.
• Send It Home includes an estimated domestic leg to the ShipMate warehouse. Booking is free, and the customer pays the exact shipping total once after weighing.
• Shop for Me excludes item prices, the 10% buying fee, and each store's delivery to the warehouse. Those are separate charges.
• Read duties.model. If it is recipient_pays, destination duty and tax are not in the price and are normally collected from the recipient.

4. OpenAPI and remote MCP

The generated OpenAPI contract is the source of truth for HTTP clients. ShipMate also exposes a stateless Streamable HTTP MCP server with one read-only tool per service.

Remote MCP URL: https://www-api.shipmate.jp/mcp

Tools:
- shipmate.get_send_it_home_shipping_price
- shipmate.get_shop_for_me_shipping_price

Both MCP tools return the same structured price response as the REST endpoints. They are read-only and require no credentials.