MCP server for AI assistants

Let an AI assistant answer US tariff questions from the same data as HTS Alerts: the duty on an HTS code by country of origin, the changes we picked up, and the HTS itself. It is free and public: no account and no key.

Connect

Endpoint: https://htsalerts.com/api/mcp · Transport: Streamable HTTP · Auth: none. In a client that takes a JSON config (Claude Desktop, Cursor and others), add:

{
  "mcpServers": {
    "hts-alerts": { "url": "https://htsalerts.com/api/mcp" }
  }
}

In clients that add remote servers by address, such as Claude and ChatGPT connectors, paste the endpoint.

Tools

lookup_hts_rate

Current US import duty for an HTS code and country of origin: each layer (column 1 or column 2 rate, Section 301, 232, 338, 201) with its Chapter 99 heading and source, the total ad valorem rate, the duty on a customs value, MPF and HMF, measures that may also apply, changes announced for the next 12 months, and what the total leaves out. Informational, not customs or legal advice.

lookup_hts_rate { "hts_code": "8542.31.00.15", "country_of_origin": "CN", "customs_value_usd": 100000 }

recent_tariff_changes

US duty changes HTS Alerts picked up, newest first (up to 50): new measures, end dates and HTS revisions, each with the legal effective date and the date HTS Alerts first had it.

recent_tariff_changes { "days": 30 }

search_hts_codes

Search the current US Harmonized Tariff Schedule by product words or by the start of a code. Returns up to 10 codes with descriptions.

search_hts_codes { "query": "lithium-ion batteries" }

What the totals leave out

The lookup tool returns this list with every total, so an assistant can say so. Answers are informational, not customs or legal advice. How we work out a total is on the About page; what changed lately is on the tariff change log. Heavy automated use is rate limited.