`jp_tariff_lookup`

Pack: japan-tariff · Connect: https://pipeworx.io/mcp (see Connect below for a single-pack URL)

No MCP client? Call it directly: GET https://gateway.pipeworx.io/v1/tools/jp_tariff_lookup for the schema, then POST the same URL with its arguments for the data.

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, RCEP, ASEAN, Australia, India, Switzerland and others, plus the JP-US trade agreement) and the quantity units. Accepts a 2-digit chapter, 4-digit heading (e.g. 0713 dried legumes), 6-digit subheading or 9-digit statistical code, with or without dots; a longer foreign code is cut to its first 6 digits. Answers ‘what duty does Japan charge on this HS code’, ‘Japan import tariff on X’, ‘Japan EPA preferential rate for Y’. Returns the schedule edition date; an unknown code returns found:false.

Parameters

Name	Type	Required	Description
`hs_code`	string	yes	HS code, 2 to 9 digits, dots optional (e.g. “0713”, “0713.32”, “071332010”). Codes longer than 9 digits are cut to 6.
`partner`	string	no	Optional trade-agreement partner to keep in epa_rates, e.g. “cptpp”, “eu”, “uk”, “india”, “rcep”, “viet_nam”, “australia”.
`limit`	number	no	Maximum lines to return (default 25, max 100).

Example call

Arguments

{
  "hs_code": "0713"
}

curl

curl -X POST https://gateway.pipeworx.io/japan-tariff/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"jp_tariff_lookup","arguments":{"hs_code":"0713"}}}'

TypeScript (@pipeworx/sdk)

import { Pipeworx } from '@pipeworx/sdk';
const pipeworx = new Pipeworx();

const result = await pipeworx.call('jp_tariff_lookup', {
  "hs_code": "0713"
});

Response shape

Field	Type	Description
`found`	boolean
`hs_code`	string
`heading`	object
`line_count`	number
`returned`	number
`truncated`	boolean
`lines`	array
`rate_notes`	string
`data_as_of`	string
`source`	string
`attribution`	string

Full JSON Schema

{
  "type": "object",
  "properties": {
    "found": {
      "type": "boolean"
    },
    "hs_code": {
      "type": "string"
    },
    "heading": {
      "type": "object",
      "properties": {
        "code": {
          "type": "string"
        },
        "description": {
          "type": "string"
        }
      },
      "additionalProperties": true
    },
    "line_count": {
      "type": "number"
    },
    "returned": {
      "type": "number"
    },
    "truncated": {
      "type": "boolean"
    },
    "lines": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "statistical_code": {
            "type": "string"
          },
          "description": {
            "type": "string"
          },
          "description_path": {
            "type": "string"
          },
          "rates": {
            "type": "object",
            "properties": {
              "general": {
                "type": "string"
              },
              "wto": {
                "type": "string"
              },
              "gsp": {
                "type": "string"
              },
              "ldc": {
                "type": "string"
              },
              "temporary": {
                "type": "string"
              }
            },
            "additionalProperties": true
          },
          "epa_rates": {
            "type": "object",
            "properties": {
              "singapore": {
                "type": "string"
              },
              "mexico": {
                "type": "string"
              },
              "malaysia": {
                "type": "string"
              },
              "chile": {
                "type": "string"
              },
              "thailand": {
                "type": "string"
              },
              "indonesia": {
                "type": "string"
              },
              "brunei": {
                "type": "string"
              },
              "asean": {
                "type": "string"
              },
              "philippines": {
                "type": "string"
              },
              "switzerland": {
                "type": "string"
              },
              "viet_nam": {
                "type": "string"
              },
              "india": {
                "type": "string"
              },
              "peru": {
                "type": "string"
              },
              "australia": {
                "type": "string"
              },
              "mongolia": {
                "type": "string"
              },
              "cptpp": {
                "type": "string"
              },
              "eu": {
                "type": "string"
              },
              "uk": {
                "type": "string"
              },
              "rcep_asean_australia_new_zealand": {
                "type": "string"
              },
              "rcep_china": {
                "type": "string"
              },
              "rcep_korea": {
                "type": "string"
              },
              "jp_us_trade_agreement": {
                "type": "string"
              }
            },
            "additionalProperties": true
          },
          "units": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "law_marks": {
            "type": "string"
          }
        },
        "additionalProperties": true
      }
    },
    "rate_notes": {
      "type": "string"
    },
    "data_as_of": {
      "type": "string"
    },
    "source": {
      "type": "string"
    },
    "attribution": {
      "type": "string"
    }
  },
  "additionalProperties": true
}

Connect

Add this to your MCP client config — every tool in the catalog, including this one — or use one-click install buttons:

{
  "mcpServers": {
    "pipeworx": {
      "url": "https://pipeworx.io/mcp"
    }
  }
}

Connect to just the japan-tariff pack

{
  "mcpServers": {
    "japan-tariff": {
      "url": "https://gateway.pipeworx.io/japan-tariff/mcp"
    }
  }
}

See Getting Started for client-specific install steps.

jp_tariff_lookup