Japan Trade Statistics (customs data)

Measured conclusion: Deep-tested. L2 outcome: tools_ok.

Japan export and import customs statistics (Ministry of Finance) by code. No API key required.

Add to your agent

Copy this into your MCP client config:

{
  "mcpServers": {
    "Japan Trade Statistics (customs data)": {
      "url": "https://data.washutrading.com/mcp",
      "transport": "streamable-http"
    }
  }
}

Measured tools (12)

• get_catalog read-only

  Call this first. Returns periods and latest months for exports and imports, levels, which tool answers which question, keyless limits and known source-data gaps. / まず最初に呼ぶ道具。輸出・輸入それぞれの期間と最新月、区切り、どの問いにどの道具を使うか、キーなしの範囲、元データの欠けを返します。

  Parameters:

  • lang — string — 答えの言葉（ja＝日本語・既定、en＝英語） / Response language (ja default, en)

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• get_item_summary read-only

  One call for an item overview: last-12-month value with YoY and 3-year change, main partners and their growth, growing and declining partners, new markets, seasonality, yearly trend, concentration and a one-line summary. Use this first for questions about an item. / 品目の全体像を1回で返します（直近12か月の金額と前年比・3年前比、主な相手国と伸び、伸びた国・減った国、新しい市場、季節の波、年ごとの推移、集中度、1行の要約）。品目について聞かれたら、まずこれを使います。

  Parameters:

  • code (required) — string — 統計品目番号（9桁・6桁・4桁）か類（2桁）・部の番号。分からなければ search_items で探す / Statistical code (9, 6 or 4 digits) or chapter (2 digits) or section; use search_items to find it
  • flow (required) — string — export＝輸出、import＝輸入 / export or import
  • lang — string — 答えの言葉（ja＝日本語・既定、en＝英語） / Response language (ja default, en)
  • level — string — 区切り（省略時はコードの桁数で判断） / Level (inferred from the code length if omitted)

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• get_new_markets read-only

  Partners that newly appeared (last 12 months at or above the minimum, previous 12 months under USD 100,000) and partners that surged (2x or more). / 新しく取引が始まった相手（直近12か月が下限以上で、前の12か月が10万ドル未満）と、急に増えた相手（2倍以上）を返します。

  Parameters:

  • code (required) — string — 統計品目番号（9桁・6桁・4桁）か類（2桁）・部の番号。分からなければ search_items で探す / Statistical code (9, 6 or 4 digits) or chapter (2 digits) or section; use search_items to find it
  • flow (required) — string — export＝輸出、import＝輸入 / export or import
  • lang — string — 答えの言葉（ja＝日本語・既定、en＝英語） / Response language (ja default, en)
  • level — string — 区切り（省略時はコードの桁数で判断） / Level (inferred from the code length if omitted)
  • limit — integer — 返す件数の上限 / Maximum number of results
  • min_value — number — 下限（ドル、直近12か月か前の12か月。既定 1,000,000） / Minimum value in USD (last 12 months or the 12 before; default 1,000,000)

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• get_seasonality read-only

  Seasonality: monthly shares over the last three full years with year-to-year range, peak and low months, for the world and the top 5 partners (or one country). / 季節の波を返します。直近の丸3年の月ごとの割合と年によるばらつき、山の月・谷の月。全世界と上位5か国（country を指定すればその国）。

  Parameters:

  • code (required) — string — 統計品目番号（9桁・6桁・4桁）か類（2桁）・部の番号。分からなければ search_items で探す / Statistical code (9, 6 or 4 digits) or chapter (2 digits) or section; use search_items to find it
  • flow (required) — string — export＝輸出、import＝輸入 / export or import
  • lang — string — 答えの言葉（ja＝日本語・既定、en＝英語） / Response language (ja default, en)
  • level — string — 区切り（省略時はコードの桁数で判断） / Level (inferred from the code length if omitted)
  • country — string — 国コード（税関の3桁。000＝全世界） / Country code (3-digit customs code, 000 = world)
  • min_value — number — 下限（ドル、直近12か月か前の12か月。既定 1,000,000） / Minimum value in USD (last 12 months or the 12 before; default 1,000,000)

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• search_items read-only

  Find items by name or code. Use this first when you do not know the code. 9-digit codes differ between exports and imports; check each result's flow. / 品名やコードから品目を探します。品目コードが分からないときに最初に使います。9桁の番号は輸出と輸入で体系が違うため、結果の flow でどちらの番号かを確かめてください。

  Parameters:

  • q (required) — string — 検索語（品名の一部かコードの先頭） / Part of a name or the start of a code
  • flow — string — 省略時は両方 / Both if omitted
  • lang — string — 答えの言葉（ja＝日本語・既定、en＝英語） / Response language (ja default, en)
  • level — string — 区切り（省略時はコードの桁数で判断） / Level (inferred from the code length if omitted)
  • limit — integer — 返す件数の上限 / Maximum number of results

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• get_item read-only

  Item details: parent and child levels, unit, and the months covered. Use this to navigate the hierarchy. For an item's figures, partners and growth, use get_item_summary; use this to navigate parent and child levels. / 品目の詳細（上位・下位の区切り、単位、データのある期間）を返します。下位の品目をたどるときに使います。品目の金額・相手国・伸びなどの全体像は get_item_summary を使います。こちらは区切りの上下をたどるときに。

  Parameters:

  • code (required) — string — 統計品目番号（9桁・6桁・4桁）か類（2桁）・部の番号。分からなければ search_items で探す / Statistical code (9, 6 or 4 digits) or chapter (2 digits) or section; use search_items to find it
  • flow (required) — string — export＝輸出、import＝輸入 / export or import
  • lang — string — 答えの言葉（ja＝日本語・既定、en＝英語） / Response language (ja default, en)
  • level — string — 区切り（省略時はコードの桁数で判断） / Level (inferred from the code length if omitted)

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• get_series read-only

  Monthly series for an item (value, quantity, unit price, YoY, MoM, preliminary/revised). With flow=both, exports, imports and the balance side by side. Chapters and sections start in 1988; 9-, 6- and 4-digit codes start in 2022. Use freq=year for long-term trends, or set from for older months (without from, months start in January 2022). Some import chapters and sections for April 2018–December 2019 return no value but gap="source" with an explanation, because the source e-Stat table lacks data. This does not mean there was no trade. / 品目の月ごとの推移（金額・数量・単価・前年比・前月比・速報／確報）。flow=both なら輸出・輸入・差し引きを並べます。類・部は1988年から、9桁・6桁・4桁は2022年から。長期の推移は freq=year、月ごとの過去分は from を付けます（from を省くと2022年1月から）。輸入の類・部の 2018年4月〜2019年12月の一部は、元データ（e-Stat の統計表）に欠けがあるため値を返さず gap="source" と説明文を返します。取引が無かったという意味ではありません。

  Parameters:

  • code (required) — string — 統計品目番号（9桁・6桁・4桁）か類（2桁）・部の番号。分からなければ search_items で探す / Statistical code (9, 6 or 4 digits) or chapter (2 digits) or section; use search_items to find it
  • flow (required) — string — export＝輸出、import＝輸入、both＝両方と差し引き（6桁以上のみ） / export, import, or both with the balance (6-digit level and above only)
  • to — string — 月（YYYY-MM。省略時は最新の月） / Month as YYYY-MM (latest if omitted)
  • freq — string — month＝月ごと（既定）、year＝年ごとの合計 / month (default) or yearly totals
  • from — string — 月（YYYY-MM。省略時は最新の月） / Month as YYYY-MM (latest if omitted)
  • lang — string — 答えの言葉（ja＝日本語・既定、en＝英語） / Response language (ja default, en)
  • level — string — 区切り（省略時はコードの桁数で判断） / Level (inferred from the code length if omitted)
  • country — string — 国コード（税関の3桁。000＝全世界） / Country code (3-digit customs code, 000 = world)

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• get_partners read-only

  Partner-country breakdown and shares for an item (one month or the last 12 months): destinations for exports, origins for imports. / 品目の相手国の内訳とシェア（その月、または直近12か月）。輸出なら輸出先、輸入なら輸入元。

  Parameters:

  • code (required) — string — 統計品目番号（9桁・6桁・4桁）か類（2桁）・部の番号。分からなければ search_items で探す / Statistical code (9, 6 or 4 digits) or chapter (2 digits) or section; use search_items to find it
  • flow (required) — string — export＝輸出、import＝輸入 / export or import
  • lang — string — 答えの言葉（ja＝日本語・既定、en＝英語） / Response language (ja default, en)
  • sort — string — value＝金額の順（既定）、growth＝直近12か月の伸びの順（下限つき） / value (default) or growth: fastest-growing partners over the last 12 months (with a minimum)
  • level — string — 区切り（省略時はコードの桁数で判断） / Level (inferred from the code length if omitted)
  • limit — integer — 返す相手国の数の上限 / Maximum number of partners
  • month — string — 月（YYYY-MM。省略時は最新の月） / Month as YYYY-MM (latest if omitted)
  • window — integer — 1＝その月、12＝その月までの直近12か月 / 1 = that month, 12 = the last 12 months up to that month
  • min_value — number — 下限（ドル、直近12か月か前の12か月。既定 1,000,000） / Minimum value in USD (last 12 months or the 12 before; default 1,000,000)

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• get_ranking read-only

  Item ranking. For export or import, by value or yoy; for both, by balance (order=asc for the largest deficits). Set country to rank trade with one country. / 品目のランキング。export・import は金額（value）か前年比（yoy）、both は差し引き（balance、order=asc で輸入超過の大きい順）。country を指定するとその国との取引での順位。

  Parameters:

  • flow (required) — string — export＝輸出、import＝輸入、both＝両方と差し引き（6桁以上のみ） / export, import, or both with the balance (6-digit level and above only)
  • level (required) — string — 区切り（省略時はコードの桁数で判断） / Level (inferred from the code length if omitted)
  • by — string — value＝金額、yoy＝前年同月比、balance＝差し引き（flow=both のとき） / value, yoy (year-on-year), or balance (flow=both)
  • lang — string — 答えの言葉（ja＝日本語・既定、en＝英語） / Response language (ja default, en)
  • limit — integer — 返す件数の上限 / Maximum number of results
  • month — string — 月（YYYY-MM。省略時は最新の月） / Month as YYYY-MM (latest if omitted)
  • order — string — desc＝大きい順（既定）、asc＝小さい順 / desc (default) or asc
  • country — string — 国コード（税関の3桁。000＝全世界） / Country code (3-digit customs code, 000 = world)
  • min_value — integer — yoy の対象にする最小の金額（円） / Minimum value (JPY) for yoy

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• get_country_summary read-only

  Use this for the overall picture of trade with one country: exports, imports, balance, YoY and the main items, in one call. For one item's breakdown by partner, use get_partners. / ある国との貿易の全体像（輸出額・輸入額・差し引き・前年比・主な品目）を1回で知りたいときに使います。ある品目の相手国ごとの内訳は get_partners を使います。

  Parameters:

  • country (required) — string — 国コード（税関の3桁。000 は不可） / 3-digit customs country code (not 000)
  • lang — string — 答えの言葉（ja＝日本語・既定、en＝英語） / Response language (ja default, en)
  • month — string — 月（YYYY-MM。省略時は最新の月） / Month as YYYY-MM (latest if omitted)
  • window — integer — 1＝その月、12＝その月までの直近12か月 / 1 = that month, 12 = the last 12 months up to that month

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• report_data_issue

  Report a data problem (differs from official figures, missing, wrong name, etc.) to the operator. Returns no figures. / データの誤り（公表値と違う、欠けている、名前が違う など）を運営者に知らせます。数字の答えは返しません。

  Parameters:

  • flow (required) — string — export＝輸出、import＝輸入 / export or import
  • code (required) — string — 統計品目番号（9桁・6桁・4桁）か類（2桁）・部の番号。分からなければ search_items で探す / Statistical code (9, 6 or 4 digits) or chapter (2 digits) or section; use search_items to find it
  • message (required) — string — 内容（2,000文字まで） / What is wrong (up to 2,000 characters)
  • month — string — 月（YYYY-MM。省略時は最新の月） / Month as YYYY-MM (latest if omitted)

  Hints: read-only no · destructive no · idempotent no · open-world no

• get_meta read-only

  Latest month and each month's status for exports and imports, the latest month common to both, the first month of data for each level (chapters and sections from 1988), and sources. For which tool to use and known data gaps, use get_catalog instead. / 輸出・輸入それぞれの最新の月と各月の速報／確報、両方にある最新の月、区切りごとのデータの開始月（類・部は1988年から）、出典を返します。道具の使い分けや欠けの一覧も知りたいときは get_catalog を使います。

  Parameters:

  • lang — string — 答えの言葉（ja＝日本語・既定、en＝英語） / Response language (ja default, en)

  Hints: read-only yes · destructive no · idempotent yes · open-world no

Publisher website

Measured by MCPYP probing. Untested fields are omitted, never estimated. Listing is always free; MCPYP never proxies calls or stores user tokens.