`jp_tariff_search`

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_search for the schema, then POST the same URL with its arguments for the data.

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 Japan applies to a product such as beans, green tea, lithium batteries, wine or cotton fabric, then call jp_tariff_lookup for every partnership rate. Optional chapter (1-97) limits the search to one HS chapter. Returns the schedule edition date; no match returns found:false with a hint.

Parameters

Name	Type	Required	Description
`keyword`	string	yes	Product words in English, e.g. “adzuki beans”, “green tea”, “lithium battery”. All words must appear.
`chapter`	number	no	Optional HS chapter 1-97 to search within (rates then come from that chapter live).
`limit`	number	no	Maximum matches (default 10, max 30).

Example call

Arguments

{
  "keyword": "adzuki beans",
  "chapter": 7
}

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_search","arguments":{"keyword":"adzuki beans","chapter":7}}}'

TypeScript (@pipeworx/sdk)

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

const result = await pipeworx.call('jp_tariff_search', {
  "keyword": "adzuki beans",
  "chapter": 7
});

Response shape

Field	Type	Description
`found`	boolean
`keyword`	string
`searched`	string
`match_mode`	string
`match_count`	number
`returned`	number
`results`	array
`hint`	string
`data_as_of`	string
`source`	string
`attribution`	string

Full JSON Schema

{
  "type": "object",
  "properties": {
    "found": {
      "type": "boolean"
    },
    "keyword": {
      "type": "string"
    },
    "searched": {
      "type": "string"
    },
    "match_mode": {
      "type": "string"
    },
    "match_count": {
      "type": "number"
    },
    "returned": {
      "type": "number"
    },
    "results": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "statistical_code": {
            "type": "string"
          },
          "chapter": {
            "type": "number"
          },
          "description_path": {
            "type": "string"
          },
          "rates": {
            "type": "object",
            "properties": {
              "general": {
                "type": "string"
              },
              "ldc": {
                "type": "string"
              }
            },
            "additionalProperties": true
          }
        },
        "additionalProperties": true
      }
    },
    "hint": {
      "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_search