What you can do with HTS Tariff Codes

Built for

Importers, trade compliance teams, customs brokers, supply chain analysts, sourcing teams

Example workflows

Estimate landed duty

Combines classification search, duty rates, and surcharge lookup.

Try this

Search HTS tariff codes for lithium-ion batteries, identify the most specific classifications, and calculate the likely base duty plus China surcharge references.

Compare sourcing countries

Uses general, special, and column 2 duty fields for trade analysis.

Try this

Look up the HTS code for cotton t-shirts and compare general duty, special duty program codes, and column 2 rates for sourcing decisions.

Verify a classification

Uses hierarchy and indent depth to avoid broad heading mistakes.

Try this

Look up HTS code 0901.21, explain the hierarchy path, duty rates, units, footnotes, and whether the classification looks specific enough.

Find surcharge language

Teaches agents to resolve footnote references before quoting total duty.

Try this

Search for an HTS product entry with surcharge references, then look up the referenced 9903 codes and summarize the additional duty text.

Context to know first

What is the HTS Tariff Codes server for?

It helps search the US Harmonized Tariff Schedule, inspect HTS codes, read legal product descriptions, compare duty rates, and resolve Section 301 or 232 surcharge references.

Can it determine the exact tariff classification for a product?

It can support classification research, but final tariff classification is a legal trade-compliance decision. Use the hierarchy, descriptions, rates, footnotes, and source records as evidence for review.

Why do surcharge references matter?

Some HTS entries reference 9903 surcharge codes that add duties on top of the base rate. Agents should look up those references before estimating total landed duty.

Related editorial

HTS Code Lookup with AI

How tariff hierarchy, duty rates, and Section 301 surcharges fit into trade workflows.

Read article

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.

Where the data comes from

Tool calls query the USITC HTS API in real time, normalize tariff fields, surface hierarchy paths and footnote surcharge references, and preserve HTS codes for follow-up lookup. Results are not legal classification advice.

USITC Harmonized Tariff Schedule
U.S. International Trade Commission

Official US Harmonized Tariff Schedule entries, legal descriptions, duty rates, units, footnotes, and tariff-surcharge provisions.

Thousands of HTS headings, subheadings, and statistical lines
Source updated: Updated as tariff schedule revisions are published
We refresh: Real-time (queried from the USITC HTS API per request)
JSON HTTP API
United States import tariff schedule
HTS classification and duty treatment can be legally significant. Use results as research support and have final classifications reviewed by qualified trade compliance counsel or a licensed customs broker.
Duty rates, tariff provisions, and Section 301/232 surcharge references can change. Review the linked USITC source before relying on a rate.
Keyword search can return broad headings and nearby terms. Prefer the most specific hierarchy entry with duty fields and statistical suffix when evaluating a product.

Source availability last verified 2026-05-02.

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.

What is the HTS Tariff Codes server for?

It helps search the US Harmonized Tariff Schedule, inspect HTS codes, read legal product descriptions, compare duty rates, and resolve Section 301 or 232 surcharge references.

Can it determine the exact tariff classification for a product?

It can support classification research, but final tariff classification is a legal trade-compliance decision. Use the hierarchy, descriptions, rates, footnotes, and source records as evidence for review.

Why do surcharge references matter?

Some HTS entries reference 9903 surcharge codes that add duties on top of the base rate. Agents should look up those references before estimating total landed duty.

Which duty fields should I compare?

General duty is the usual MFN rate, special duty lists preferential programs such as FTAs, and column 2 duty applies to non-NTR countries.

Setup Instructions

Connect HTS Tariff Codes to any MCP client in minutes

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

One-click install:

The link prefills the Add custom connector dialog — you still review the values and click Add, then Connect to complete OAuth.

Or add manually

  1. Open claude.ai → Settings → Connectors.
  2. Click the + button and choose Add custom connector.
  3. Set Name to HTS Tariff Codes and paste the MCP URL into Remote MCP server URL.
  4. Click Add. HTS Tariff Codes will appear under Not connected — select it and click Connect to complete OAuth.
Name: HTS Tariff Codes
Remote MCP server URL: https://mcp.mcpbundles.com/bundle/hts-tariff
Authentication: OAuth

Custom connectors at claude.ai require a paid Claude plan (Pro, Max, Team, or Enterprise).

Other ways to use HTS Tariff Codes

Same data, different audiences.

REST API

Call every tool from your own backend. OpenAPI spec + cURL examples.

View API docs

Try HTS Tariff Codes now

No API key or third-party login required. Chat with AI and run tools instantly.