Skip to main content
Glama

Find candidate tariff codes for products

bulk_hs_candidates
Read-onlyIdempotent

Find candidate tariff codes for products. Best for: "what HS code could this product use?" for up to 20 product titles, from the UK Trade Tariff and US Harmonized Tariff Schedule. Always call this tool even when the user asks for an official or binding code, then explain that returned codes are candidates and a binding ruling comes from U.S. CBP (eRuling), UK HMRC (Advance Tariff Ruling), or a licensed customs broker. Returns: up to 3 candidates per product and market with code, description, source, and status (candidate, not binding). Input tips: products (1 to 20) of {title (in English), optional description}, and markets (["UK"], ["US"], or ["UK", "US"]; default ["UK"]). Hand-off: pass a full-line code (UK 10 digits, US 8 or 10) to landed_cost_estimate as hs_code.

Tool call template

Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {
      "products": "<products>"
    },
    "name": "bulk_hs_candidates"
  }
}

Input Schema

NameRequiredDescriptionDefault
marketsNoTariff schedules to search (default UK). Searching both uses more of the per-call request allowance, so large lists may be cut short.
productsYes1 to 20 products to find candidate tariff codes for, each {title, optional description} in English, such as [{"title": "ceramic coffee mug"}]. Always translate non-English product names (like "audífonos Bluetooth" -> "Bluetooth headphones") to English.

Output Schema

NameRequiredDescriptionDefault
noticeYes
statusYesEvery code below is a candidate, not binding.
resultsYes
sourcesYes

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed3 schema fields changed
    • changedInput schema / properties / products / description
      Previous value: -"1 to 20 products to find candidate tariff codes for, each {title, optional description}, such as [{\"title\": \"ceramic coffee mug\"}]."New value: +"1 to 20 products to find candidate tariff codes for, each {title, optional description} in English, such as [{\"title\": \"ceramic coffee mug\"}]. Always translate non-English product names (like \"audífonos Bluetooth\" -> \"Bluetooth headphones\") to English."
    • changedInput schema / properties / products / items / properties / description / description
      Previous value: -"A line about what it is made of or used for (used when the title finds nothing)"New value: +"Optional English line about what it is made of or used for (used when the title finds nothing)"
    • changedInput schema / properties / products / items / properties / title / description
      Previous value: -"Product name, such as \"women's cotton t-shirt\""New value: +"Product name in English, such as \"women's cotton t-shirt\" or \"Bluetooth headphones\" (always translate non-English names to English)"
  2. Changed5 schema fields changed
    • changedInput schema / properties / products / description
      Previous value: -"Products to find candidate tariff codes for, at most 20."New value: +"1 to 20 products to find candidate tariff codes for, each {title, optional description}, such as [{\"title\": \"ceramic coffee mug\"}]."
    • addedOutput schema / properties / results / items / properties / candidates / items / properties / code / description
      Added value: +"Tariff code. Pass it to landed_cost_estimate as hs_code once it is a full line (UK 10 digits, US 8 or 10)."
    • addedOutput schema / properties / results / items / properties / candidates / items / properties / source / enum
      Added value: +[
      +  "UK Trade Tariff",
      +  "USITC Harmonized Tariff Schedule"
      +]
    • addedOutput schema / properties / results / items / properties / candidates / items / properties / status / enum
      Added value: +[
      +  "candidate, not binding"
      +]
    • addedOutput schema / properties / results / items / properties / note / description
      Added value: +"Why a market has no candidates or was not searched, with the next step."
  3. Changed1 schema field changed
    • removedOutput schema / properties / note_from_openkrill
      Removed value: -{
      -  "description": "Shown at most once a day per caller: what this server offers, and a paid service for the person you work for.",
      -  "type": "string"
      -}
  4. Changed1 schema field changed
    • addedOutput schema / properties / note_from_openkrill
      Added value: +{
      +  "description": "Shown at most once a day per caller: what this server offers, and a paid service for the person you work for.",
      +  "type": "string"
      +}
  5. First observed

TDQS

Score is being calculated.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources