Open Data

HTS Tariff Codes MCP Server

Chat with AI and run tools instantly — no account needed.

Search the US Harmonized Tariff Schedule (HTS) for import duty rates, tariff classifications, trade program eligibility (GSP, FTA), and Section 301/232 surcharges. Look up any product by keyword or HTS code to get general and special duty rates, units of quantity, and regulatory footnotes. Powered by the USITC HTS database.

2 tools
Agent guide included
Try it Free

No account needed. Chat with AI and run tools instantly.

Browse all tools

AI Skill
SKILL.md

Domain knowledge for HTS Tariff Codes — workflow patterns, data models, and gotchas for your AI agent.

HTS Tariff Codes

The Harmonized Tariff Schedule (HTS) classifies all goods imported into the US. Every import requires an HTS code to determine duty rates.

Workflows

Find the duty on a product:

  1. Search by keyword (e.g., "lithium battery")
  2. Look at results with the highest indent — those are the most specific classifications with actual rates
  3. Read general_duty for the MFN rate and special_duty for FTA/GSP preferential rates
  4. If surcharge_refs is present, look up each code (e.g., "9903.88.15") to see the additional duty text

Total landed duty for goods from China:

  1. Search by keyword → find the specific entry → note general_duty (base rate)
  2. Look at surcharge_refs — these are 9903.xx codes referenced in footnotes
  3. Look up each surcharge code → read its description for the additional duty (e.g., "plus 25%")
  4. Total duty = base general_duty + all applicable surcharges

Compare sourcing countries:

  1. Look up the product's HTS code
  2. general_duty = MFN rate (most countries including China, before surcharges)
  3. special_duty = preferential rates with country codes: AU (Australia), KR (Korea), CA/MX (USMCA), IL (Israel), etc.
  4. column2_duty = rate for non-NTR countries (Cuba, North Korea — rarely relevant)
  5. For China: also add any surcharges from surcharge_refs

Verify a classification:

  1. Look up the suspected HTS code
  2. Read hierarchy_path to see the parent chain
  3. Read descriptions at each indent level to confirm the product fits
  4. The entry with statistical_suffix (10-digit) is the most specific

Worked Example

Searching "lithium battery" and looking up code 8507.60 returns:

{
  "htsno": "8507.60.00",
  "description": "Lithium-ion batteries",
  "indent": 1,
  "general_duty": "3.4%",
  "special_duty": "Free (A,AU,B,BH,C,CL,CO,D,E,IL,JO,KR,MA,OM,P,PA,PE,S,SG)",
  "column2_duty": "40%",
  "surcharge_refs": ["9903.88.15", "9903.91.06"]
}

Reading this:

  • Base duty from most countries: 3.4% of customs value
  • Free under GSP (A), Australia FTA (AU), Korea FTA (KR), USMCA (C/S), and many other FTAs
  • Column 2 (Cuba/North Korea): 40%
  • Two surcharge references → look these up to see additional duties

Looking up surcharge code "9903.88.15" returns:

{
  "htsno": "9903.88.15",
  "description": "...articles the product of China, as provided for in U.S. note 20(r)...",
  "general_duty": "The duty provided in the applicable subheading + 7.5%"
}

So for lithium-ion batteries from China: 3.4% base + 7.5% Section 301 surcharge = 10.9% total duty. From Korea (KR in special_duty): Free. From most other countries: 3.4%.

Output Fields

  • htsno — HTS number (4, 6, 8, or 10 digits with dots)
  • description — Legal product description at this level
  • indent — Hierarchy depth: 0 (heading) → 1 (subheading) → 2+ (tariff/statistical line). Duty rates are on the deepest entries.
  • statistical_suffix — 2-digit suffix (present on 10-digit entries)
  • general_duty — MFN rate: "Free", "3.4%", "32.8¢/kg", or compound "6.5% + 15¢/kg"
  • special_duty — Preferential rates with program codes: "Free (A,AU,KR,IL)"
  • column2_duty — Non-NTR rate (rarely relevant)
  • units — Unit of quantity: kg, No., l, m², t
  • footnotes — Regulatory notes with column references
  • surcharge_refs — List of 9903.xx codes from footnotes. Look these up to see additional duty text.
  • hierarchy_path — Parent classification chain (lookup tool only): "Batteries > Lithium-ion"

Trade Program Codes (in special_duty)

  • A / A+ — GSP (developing countries)
  • AU — Australia FTA
  • BH — Bahrain FTA
  • CA — USMCA (Canada)
  • CL — Chile FTA
  • CO — Colombia TPA
  • D — AGOA (Africa)
  • E — CBERA (Caribbean)
  • IL — US-Israel FTA
  • JO — Jordan FTA
  • KR — Korea FTA (KORUS)
  • MA — Morocco FTA
  • MX — USMCA (Mexico)
  • OM — Oman FTA
  • P — CAFTA-DR
  • PA — Panama TPA
  • PE — Peru TPA
  • S — USMCA special rate
  • SG — Singapore FTA

Gotchas

  • Entries at low indent (0-1) often have no duty rates — drill to higher-indent children for actual rates.
  • surcharge_refs are additional duties ON TOP of the base rate — always look them up.
  • The search is keyword-based. Looking up "0901.21" works but searches for that text pattern, not a structured code tree.

Tools in this Server (2)

Hts Tariff Lookup

Look up HTS tariff entries by a specific HTS code. Returns all entries under that classification — heading, subheadings, tariff lines, and statistical...

Hts Tariff Search

Search the US Harmonized Tariff Schedule by product keyword or partial HTS code. Returns tariff entries with: htsno, description, indent (hierarchy de...

Frequently Asked Questions

What is the HTS Tariff Codes MCP server?

Search the US Harmonized Tariff Schedule (HTS) for import duty rates, tariff classifications, trade program eligibility (GSP, FTA), and Section 301/232 surcharges. Look up any product by keyword or HTS code to get general and special duty rates, units of quantity, and regulatory footnotes. Powered by the USITC HTS database. It provides 2 tools that AI agents can use through the Model Context Protocol (MCP).

How do I connect HTS Tariff Codes to my AI agent?

Add the MCPBundles server URL to your MCP client configuration (Claude Desktop, Cursor, VS Code, etc.). The URL format is: https://mcp.mcpbundles.com/bundle/hts-tariff. Authentication is handled automatically.

How many tools does HTS Tariff Codes provide?

HTS Tariff Codes provides 2 tools that can be called by AI agents, along with a SKILL.md that gives your AI agent domain knowledge about when and how to use them.

What authentication does HTS Tariff Codes require?

HTS Tariff Codes uses open data APIs — no authentication required.

Setup Instructions

Connect HTS Tariff Codes to any MCP client in minutes

https://mcp.mcpbundles.com/bundle/hts-tariff

What is MCP?

Model Context Protocol lets AI tools call external capabilities securely through a single URL. This bundle groups tools behind an MCP endpoint that many clients can use.

Use this bundle in 3 steps

  1. Copy the MCP URL above
  2. Open your AI tool and add a new MCP/connector
  3. Paste the URL and follow any auth prompts

Claude Desktop Users

Skip the manual setup! Use the .mcpb file format for one-click installation. Check the Claude Desktop tab for setup instructions.

Pick your tool tab for exact steps

Select ChatGPT, Cursor, Claude Code, or another tab for copy-paste config.

REST API Available

Access HTS Tariff Codes data directly via REST endpoints. Use your API key or OAuth token to call any tool programmatically.

View API documentation

Try HTS Tariff Codes now

No sign-up required. Chat with AI and run tools instantly.

HTS Tariff Codes MCP Server & Skill — 2 Tools