Uk Trade Tariff

@pipeworx/uk-trade-tariff

HMRC trade-tariff 服务提供的英国综合在线关税——商品编码、按原产地划分的第三国和优惠关税税率、增值税和消费税、进出口条件，以及实时关税配额余额。

属于 Pipeworx——一个将 AI Agent 连接至 1784+ 个实时数据源的 MCP 网关。这是一个独立的非官方集成，与上游提供方无关联、未经其认可，也未由其发布。

工具

• uktariff_search(query, limit?, declarable_only?) — 根据通俗易懂的商品描述查找商品编码，或解析数字编码。
• uktariff_commodity(code, origin?, max_measures?) — 查询单个 10 位编码的完整关税详情，并根据 JSON:API included 图解析措施。
• uktariff_heading(heading, limit?) — 查询一个 4 位税目下的编码。
• uktariff_quota(order_number?, goods_nomenclature_item_id?, geographical_area_id?, year?, critical?, limit?) — 查询包含剩余余额和状态的关税配额。

认证

无需密钥。

数据源

• https://www.trade-tariff.service.gov.uk/api/v2/search?q= — 分类搜索。
• https://www.trade-tariff.service.gov.uk/api/v2/commodities/{code} — 关税和措施。
• https://www.trade-tariff.service.gov.uk/api/v2/headings/{id} — 税目内容。
• https://www.trade-tariff.service.gov.uk/api/v2/quotas/search — TRQ 余额。

值得注意的事项：

• 主机名是 www.，不是 api.。 api.trade-tariff.service.gov.uk 会将每个 /api/v2 路径通过 301 重定向到文档站点，并返回 content-length: 0，因此会跟随重定向的客户端会收到 200 响应和空正文——调用看似成功，却没有返回任何内容。
• 模糊搜索会对每个词进行 AND 匹配。 q=roasted coffee beans 没有匹配结果，因为命名目录中没有“beans”，而 q=roasted coffee 会返回 40 个商品。两者的响应状态都是 200，且都带有三个空数组，看起来就像“英国不对咖啡征收关税”。因此，uktariff_search 会逐步删除末尾词，直到找到匹配项，并报告 query_used 和 narrowed_to_match。
• /search 是多态接口。 数字查询会返回 {type: "exact_match", entry: {endpoint, id}}，且完全不包含结果数组。
• 税目会将每个编码列出两次，一次使用 producline_suffix "10"（中间子目行），一次使用 "80"（可申报的末级项）。两者的描述不同，因此不包含后缀时，看起来就像是相互矛盾的重复项。
• /quotas/search 会因 status= 返回 400 错误，尽管每一行都有状态。请按年份、order_number、区域或商品筛选，并读取状态。
• 只有 declarable: true 的编码才可用于海关申报。

快速开始

添加到你的 MCP 客户端（Claude Desktop、Cursor、Windsurf 等）：

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

此端点实际提供的内容

https://gateway.pipeworx.io/uk-trade-tariff/mcp 上的 tools/list 会返回上表中的工具，以及 Pipeworx 共享元工具——ask_pipeworx、 discover_tools、search_within、remember/recall，还有其余全网关范围的工具。因此，你看到的工具数量会多于此表：单个工具包端点目前会列出约 30 个共享工具，以及该工具包自身的工具。连接的 initialize 响应会说明确切的范围，是当天最权威的答案。

这是有意为之，并非意外的多路复用。元工具可以让限定范围的连接回答此工具包未涵盖的问题——通过 ask_pipeworx 在整个目录中路由——而无需添加第二个 MCP 服务。目前无法在不包含这些工具的情况下挂载工具包端点；如果额外的架构定义占用的上下文超过了路由带来的价值，请连接一次完整网关，而不是连接多个工具包端点。

或者连接完整的 Pipeworx 网关，直接列出每个工具包的工具，而不只是此工具包的工具：

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

两个 URL 都连接到同一个网关和同样的 1784+ 个数据源。唯一的区别是哪个工具包的工具会被直接列出；无论连接哪个端点，ask_pipeworx 都能访问所有工具。

没有 MCP 客户端？通过 HTTP 调用

curl -X POST https://gateway.pipeworx.io/v1/tools/uktariff_search \
  -H 'Content-Type: application/json' \
  -d '{"query":"roasted coffee beans","limit":3}'

首次调用无需账号。检查任意工具：GET https://gateway.pipeworx.io/v1/tools/uktariff_search。查找工具：使用 {"query":"..."} 调用 POST https://gateway.pipeworx.io/v1/tools/search_packs。

独立运行（无需网关账号）

此软件包也可以作为本地 stdio MCP 服务运行——无需 Pipeworx 账号，也无需经过网关往返：

{
  "mcpServers": {
    "uk-trade-tariff": {
      "command": "npx",
      "args": ["-y", "@pipeworx/mcp-uk-trade-tariff"]
    }
  }
}

也可以直接运行，以确认它能正常启动：

npx -y @pipeworx/mcp-uk-trade-tariff

它通过 stdin/stdout 使用 MCP，并响应 initialize/tools/list/tools/call，但仅提供此工具包的工具——不包含上方网关连接额外提供的任何共享元工具。数据源相同，工具相同，但没有 ask_pipeworx 路由。

使用 ask_pipeworx

你可以用通俗易懂的英语提问，而不是直接调用工具——上述工具包端点和完整网关都支持此方式：

ask_pipeworx({ question: "your question about Uk Trade Tariff data" })

网关会选择合适的工具并自动填入参数。

更多信息

• 文档和指南
• pipeworx.io

许可证

MIT