@pipeworx/uk-trade-tariff

Connect: https://gateway.pipeworx.io/uk-trade-tariff/mcp · 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: 4

The UK Integrated Online Tariff from HMRC’s trade-tariff service — commodity codes, third-country and preferential duty rates by origin, VAT and excise, import/export conditions, and live tariff-rate quota balances.

Tools

• uktariff_search(query, limit?, declarable_only?) — find a commodity code from a plain-English product description, or resolve a numeric code.
• uktariff_commodity(code, origin?, max_measures?) — full duty detail for one 10-digit code, with measures resolved against the JSON:API included graph.
• uktariff_heading(heading, limit?) — the codes under one 4-digit heading.
• uktariff_quota(order_number?, goods_nomenclature_item_id?, geographical_area_id?, year?, critical?, limit?) — tariff-rate quotas with remaining balance and status.

Auth

Keyless.

Data sources

• https://www.trade-tariff.service.gov.uk/api/v2/search?q= — classification search.
• https://www.trade-tariff.service.gov.uk/api/v2/commodities/{code} — duties and measures.
• https://www.trade-tariff.service.gov.uk/api/v2/headings/{id} — heading contents.
• https://www.trade-tariff.service.gov.uk/api/v2/quotas/search — TRQ balances.

Things worth knowing:

• The host is www., not api.. api.trade-tariff.service.gov.uk 301s every /api/v2 path to the documentation site with content-length: 0, so a client that follows redirects gets a 200 and an empty body — a call that looks successful and returns nothing.
• Fuzzy search ANDs every term. q=roasted coffee beans matches nothing because “beans” is not in the nomenclature, while q=roasted coffee returns 40 commodities. Both are 200s with three empty arrays, which reads as “the UK does not tariff coffee”. uktariff_search therefore drops trailing words until something matches and reports query_used and narrowed_to_match.
• /search is polymorphic. A numeric query returns {type: "exact_match", entry: {endpoint, id}} with no result arrays at all.
• A heading lists each code twice, once with producline_suffix "10" (the intermediate subheading line) and once with "80" (the declarable leaf). They carry different descriptions, so without the suffix it looks like contradictory duplicates.
• /quotas/search rejects status= with a 400 even though every row has a status. Filter on year / order_number / area / commodity and read it off.
• Only declarable: true codes may be used on a customs declaration.

Tools

• uktariff_search — 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 classi
• uktariff_commodity — Full UK tariff detail for one 10-digit commodity code: the third-country (MFN) duty rate, every preferential rate by country or trading bloc, VAT and excise measures, quota-linked rates, and the impor
• uktariff_heading — List the commodity codes that sit under one 4-digit UK tariff heading, with descriptions, indent level and whether each is declarable. Use this to drill down after uktariff_search returns a heading, o
• uktariff_quota — Search UK tariff-rate quotas (TRQs) — the limited volumes of a good that may be imported at a reduced or zero duty rate. Returns each quota definition with its order number, initial volume, REMAINING