HTS with its legal notes, 222,000+ CBP rulings with status, what they quote on a heading. Keyless.
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
Optional. Without a key the seven read tools run 50 calls a day per IP. A key (from https://htsapi.dev) adds classify_product, our classifier as a second opinion, at 1 credit a call.
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
Classify a product to a US HTS code. COSTS 1 CREDIT (refunded if it fails). Takes 10-60 s. Read `answer` first. `answer.code` is as deep as the facts given decide (10 digits when they do). When they do not, `answer.options` are the codes it could be, each with its `condition`, base rate and `importers_paid`, and `answer.question` is the fact that decides: ask the user, then call again with the answer added to the description (a new call, 1 credit). `candidates` carry the reasoning and the CBP rulings behind each code.
What the product is, what it is made of and what it is for, in plain words (3-2000 characters). Several listings of the same product may be pasted together.
Main material, if not already in the description.
Country of origin: name, ISO code or common alias (China, CN, PRC, Viet Nam). Adds what importers from there paid on the code (Census, the latest 3 published months).
This tool isn't marked read-only, so it may change something on the server or in an account you connected.
Pick your client. Values in capitals, like YOUR_TOKEN, are yours to fill in.
Run in a terminal
claude mcp add --transport http mcp https://htsapi.dev/mcp
Headers
X-API-Key (optional, not in the config above): Optional. Without a key the seven read tools run 50 calls a day per IP. A key (from https://htsapi.dev) adds classify_product, our classifier as a second opinion, at 1 credit a call.Classify a product to a US HTS code. COSTS 1 CREDIT (refunded if it fails). Takes 10-60 s. Read `answer` first. `answer.code` is as deep as the facts given decide (10 digits when they do). When they do not, `answer.options` are the codes it could be, each with its `condition`, base rate and `importers_paid`, and `answer.question` is the fact that decides: ask the user, then call again with the answer added to the description (a new call, 1 credit). `candidates` carry the reasoning and the CBP rulings behind each code.
| Argument | Type | Description |
|---|---|---|
| material | any | Main material, if not already in the description. |
| description* | string | What the product is, what it is made of and what it is for, in plain words (3-2000 characters). Several listings of the same product may be pasted together. |
| country_of_origin | any | Country of origin: name, ISO code or common alias (China, CN, PRC, Viet Nam). Adds what importers from there paid on the code (Census, the latest 3 published months). |
{
"type": "object",
"title": "classify_productArguments",
"required": [
"description"
],
"properties": {
"material": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Material",
"default": null,
"description": "Main material, if not already in the description."
},
"description": {
"type": "string",
"title": "Description",
"description": "What the product is, what it is made of and what it is for, in plain words (3-2000 characters). Several listings of the same product may be pasted together."
},
"country_of_origin": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Country Of Origin",
"default": null,
"description": "Country of origin: name, ISO code or common alias (China, CN, PRC, Viet Nam). Adds what importers from there paid on the code (Census, the latest 3 published months)."
}
}
}The legal text that decides between headings, from the official US schedule. With a code: its section's notes and its chapter's notes, subheading notes, Additional U.S. Notes and statistical notes. These have legal force (GRI 1): they exclude goods from a chapter ("this chapter does not cover...") and define terms. Without a code: the General Rules of Interpretation and the Additional U.S. Rules of Interpretation. The WCO Explanatory Notes are not included (copyrighted); heading_scope gives the passages CBP rulings quote from them.
| Argument | Type | Description |
|---|---|---|
| code | any | Any HTS chapter, heading or code (82, 8205, 8205.51.30): its section's and chapter's notes. Leave it out for the General Rules of Interpretation. |
{
"type": "object",
"title": "get_notesArguments",
"properties": {
"code": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Code",
"default": null,
"description": "Any HTS chapter, heading or code (82, 8205, 8205.51.30): its section's and chapter's notes. Leave it out for the General Rules of Interpretation."
}
}
}One CBP ruling: its full text, HTS codes, status and, when revoked or modified, the ruling that did it, the codes it moved the goods to, and the sentence that says so. Codes the current schedule no longer has are listed in `obsolete_codes`. `cites`: the explanatory notes, legal notes and GRIs it relies on (heading_scope shows what rulings say a heading covers).
| Argument | Type | Description |
|---|---|---|
| ruling_number* | string | A CBP ruling number: N338413, H301540, 881984. |
{
"type": "object",
"title": "get_rulingArguments",
"required": [
"ruling_number"
],
"properties": {
"ruling_number": {
"type": "string",
"title": "Ruling Number",
"description": "A CBP ruling number: N338413, H301540, 881984."
}
}
}What CBP's rulings quote and decide on a heading: for deciding whether a product falls in it. Give the product to get what decides for it first. `passages`: the lines rulings quote when deciding (mostly from the WCO Explanatory Notes, not published free; fragments, not the whole note), each with the rulings that quote it: their goods, HQ or NY, date, status and what CBP concluded; `exclusion` marks text on what the heading does not cover. `notes_applied`: the legal notes rulings applied to the heading. `cited_without_quote`: rulings that relied on its explanatory note without quoting it. Each passage is as a ruling quotes it.
| Argument | Type | Description |
|---|---|---|
| heading* | string | An HTS heading (9505) or any code under it (9505.10.25). |
| product | any | The product in plain words. Puts first the passages and rulings on goods closest to it: what decides for this product, not what is quoted most. |
{
"type": "object",
"title": "heading_scopeArguments",
"required": [
"heading"
],
"properties": {
"heading": {
"type": "string",
"title": "Heading",
"description": "An HTS heading (9505) or any code under it (9505.10.25)."
},
"product": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Product",
"default": null,
"description": "The product in plain words. Puts first the passages and rulings on goods closest to it: what decides for this product, not what is quoted most."
}
}
}What importers from a country actually paid on a code in the latest 3 months Census has published: base rate plus Chapter 99 duties (Section 301, 232 and the like), as a percent of value, by month. Not the duty a shipment will owe today (Census is about 2 months behind and the rules change), and anti-dumping/countervailing duties are not included. For "what will this cost", not for classifying.
| Argument | Type | Description |
|---|---|---|
| code* | string | An HTS code, 6 to 10 digits, dotted or not (8205.51.30). |
| country_of_origin* | string | Country of origin: name, ISO code or common alias (China, CN, PRC, Viet Nam). |
{
"type": "object",
"title": "importers_paidArguments",
"required": [
"code",
"country_of_origin"
],
"properties": {
"code": {
"type": "string",
"title": "Code",
"description": "An HTS code, 6 to 10 digits, dotted or not (8205.51.30)."
},
"country_of_origin": {
"type": "string",
"title": "Country Of Origin",
"description": "Country of origin: name, ISO code or common alias (China, CN, PRC, Viet Nam)."
}
}
}The tariff schedule, one level at a time, the way a classifier reads it. No code: the 22 sections and their chapters, for goods no ruling covers. A chapter (82) lists its headings with their legal text; a heading (8205) lists its subheadings in words; a subheading or line gives its path from the heading (an "Other" line says what it is not), base rates with the special-rate programs named, the 10-digit lines under it and the newest current CBP rulings under it. A code no longer in the schedule falls back to the nearest level that is. What importers paid is a separate tool, importers_paid.
| Argument | Type | Description |
|---|---|---|
| code | any | An HTS chapter, heading or code, 2 to 10 digits, dotted or not (82, 8205, 8205.51, 8205517500). Leave it out for the sections and chapters. |
{
"type": "object",
"title": "lookup_hts_codeArguments",
"properties": {
"code": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Code",
"default": null,
"description": "An HTS chapter, heading or code, 2 to 10 digits, dotted or not (82, 8205, 8205.51, 8205517500). Leave it out for the sections and chapters."
}
}
}Every CBP ruling that classifies goods under a code: for checking a code someone already has. `rulings` are current (not revoked), newest first, or closest to `product` first, each with what its goods were; `moved_away` are rulings CBP revoked off this code and the codes the revoking ruling put the goods under. If similar goods were moved away, the code is in doubt.
| Argument | Type | Description |
|---|---|---|
| code* | string | An HTS heading, subheading or line, 4 to 10 digits (8205, 8205.51, 8205.51.30.30). Old codes no longer in the schedule work too. |
| limit | integer | Rulings to return, 1-50. |
| offset | integer | Rulings to skip, for the next page. |
| product | any | Optional: the product in plain words, to put the rulings closest to it first. |
{
"type": "object",
"title": "rulings_under_codeArguments",
"required": [
"code"
],
"properties": {
"code": {
"type": "string",
"title": "Code",
"description": "An HTS heading, subheading or line, 4 to 10 digits (8205, 8205.51, 8205.51.30.30). Old codes no longer in the schedule work too."
},
"limit": {
"type": "integer",
"title": "Limit",
"default": 20,
"description": "Rulings to return, 1-50."
},
"offset": {
"type": "integer",
"title": "Offset",
"default": 0,
"description": "Rulings to skip, for the next page."
},
"product": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Product",
"default": null,
"description": "Optional: the product in plain words, to put the rulings closest to it first."
}
}
}CBP rulings for a product described in plain words, by meaning. Each ruling comes with its HTS codes, its status (current, modified, superseded) and the product facts CBP classified. `by_code` lists the subheadings current rulings point to, in the order of the rulings, each with its HQ rulings, newest ruling and `lines`: the full codes under it with the rulings for each, which is where the facts that decide between lines show.
| Argument | Type | Description |
|---|---|---|
| limit | integer | Rulings to return, 1-30. |
| query* | string | The product in plain words: what it is, what it is made of, what it is for. |
{
"type": "object",
"title": "search_rulingsArguments",
"required": [
"query"
],
"properties": {
"limit": {
"type": "integer",
"title": "Limit",
"default": 10,
"description": "Rulings to return, 1-30."
},
"query": {
"type": "string",
"title": "Query",
"description": "The product in plain words: what it is, what it is made of, what it is for."
}
}
}We read every tool's name, description and inputs the way the model will, looking for instructions hidden from you. A clean result means no warning signs, not a guarantee. Scanned Nov 19, 2026.