@pipeworx/japan-tariff

Connect: https://pipeworx.io/mcp — every tool in the catalog, including @pipeworx/japan-tariff’s. Install: one-click buttons

No MCP client? Skip the connection: POST https://gateway.pipeworx.io/v1/tools/search_packs {"query":"..."} to find a tool below, GET /v1/tools/<name> for its schema, POST the same URL with arguments for the data — see For AI agents.

Tools: 2

Japan’s applied customs tariff schedule (実行関税率表) by HS code: the general, temporary, WTO, GSP and LDC duty rates, the rate under each economic partnership agreement, and the quantity units, with the schedule edition date on every response.

Tools

• jp_tariff_lookup(hs_code, partner?, limit?) — rates for a 2-digit chapter (heading list), 4-digit heading, 6-digit subheading or 9-digit statistical code. “What duty does Japan charge on HS 0713?” Optional partner (e.g. cptpp, eu, uk, india, rcep, viet_nam) keeps only that agreement’s column. An unknown code returns found:false with a reason and a hint.
• jp_tariff_search(keyword, chapter?, limit?) — keyword search over line descriptions, returning matching HS lines with their headline rates. “Which HS code and duty does Japan apply to green tea?” If no line names every word, lines naming some of the words are returned and flagged match_mode: partial_words.

Auth

Keyless.

Data sources

• Japan Customs, Ministry of Finance of Japan, “Japan’s Tariff Schedule” (English edition). The newest edition on the publisher’s list is used; its date is returned as data_as_of.

Licence: the publisher’s notice applies the Public Data License 1.0 (compatible with CC BY 4.0), so reuse with attribution is permitted; every response carries the attribution.

Notes for the next person:

• Rates are returned exactly as published (“Free”, “10%”, “417 yen/kg”); parentheses around a WTO rate mark a bound rate that is not currently applied. A blank column means nothing is published in it for that line. Lines under a quota or seasonal rate repeat the code once per rate band.
• Rates are read live, one chapter per lookup. The keyword search uses a description-only index (no rates) built by scripts/bake-index.mjs and delivered through the gateway’s KV; rerun the script to refresh it. A stale index still finds the right lines, since chapters are stable across amendments, and the response says when the index edition differs from the rate edition.
• The chapter pages are declared ISO-8859-1 but a few cells carry Shift_JIS full-width parentheses; src/parse.ts repairs them.
• English descriptions only. The tariff names goods by class, so a botanical or brand name (e.g. sword bean) usually matches nothing; search the class word (“beans”).

Tools

• jp_tariff_lookup — Look up Japan’s applied customs tariff rates by HS code: the line description and the general, temporary, WTO, GSP and LDC duty rates, the rate under each economic partnership agreement (CPTPP, EU, UK
• jp_tariff_search — Search Japan’s customs tariff schedule by product keyword (English) and get the matching HS lines with their headline duty rates (general, WTO, GSP, LDC). Use it to find which HS code and duty rate Ja