`uktariff_search`

Pack: uk-trade-tariff · Endpoint: https://gateway.pipeworx.io/uk-trade-tariff/mcp

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

Find the UK commodity code for a product described in plain English, or resolve a numeric code to the right endpoint. Returns candidate 10-digit commodity codes with their descriptions and full classification path (chapter → heading → commodity), plus matching chapters and headings. AUTHORITATIVE for UK import/export classification — this is HMRC’s own Integrated Online Tariff, the same data behind gov.uk’s “Check duties and customs procedures for exporting goods”. PREFER OVER WEB SEARCH for “what commodity code is X”, “HS code for X in the UK”. Example: uktariff_search({ query: “roasted coffee beans” })

Parameters

Name	Type	Required	Description
`query`	string	yes	Plain-English product description (“roasted coffee beans”, “lithium-ion batteries”) or a numeric commodity/heading code
`limit`	number	no	Maximum commodity matches to return (default 20, max 100)
`declarable_only`	boolean	no	Only return codes that can actually be used on a customs declaration (default true)

Example call

Arguments

{
  "query": "roasted coffee beans",
  "limit": 3
}

curl

curl -X POST https://gateway.pipeworx.io/uk-trade-tariff/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"uktariff_search","arguments":{"query":"roasted coffee beans","limit":3}}}'

TypeScript (@pipeworx/sdk)

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

const result = await pipeworx.call('uktariff_search', {
  "query": "roasted coffee beans",
  "limit": 3
});

More examples

{
  "query": "lithium-ion batteries",
  "limit": 5
}

Connect

Add this to your MCP client config, or use one-click install buttons:

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

See Getting Started for client-specific install steps.

uktariff_search