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
- Antidumping and countervailing duties (AD/CVD): Commerce sets them per producer and exporter, so a code and a country alone cannot give the rate.
- Over-quota rates and quota limits (tariff-rate quotas).
- Duties that depend on facts a code does not show, such as a product exclusion, an end use or the metal content: these are listed as possible, not added.
- The per-unit part of specific and compound rates, which needs the quantity.
- Federal excise taxes and other fees collected at entry besides the MPF and HMF.
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.