htsapi.dev

● Active

dev.htsapi/mcp

HTS with its legal notes, 222,000+ CBP rulings with status, what they quote on a heading. Keyless.

Connect this server

One click to install, or copy the config below. Suits: Cursor · HTTP clients.

Add to Cursor Add to VS CodeClaude Desktop / Claude Code: paste the config below.

Or add it manually — claude_desktop_config.json (Claude Desktop) or .cursor/mcp.json (Cursor):

{
  "mcpServers": {
    "mcp": {
      "url": "https://htsapi.dev/mcp"
    }
  }
}
One line, from the terminal
Claude Code
claude mcp add --transport http mcp https://htsapi.dev/mcp
VS Code
code --add-mcp '{"name":"mcp","type":"http","url":"https://htsapi.dev/mcp"}'

Syntax from each client's docs (Claude Code: claude mcp add; Codex: codex mcp add; VS Code: code --add-mcp). Placeholders in angle brackets are values you fill in. Codex takes hosted servers in config.toml ([mcp_servers.<name>] url = …) rather than on the command line.

A starting point — check the repository for exact arguments and setup. Restart your client after editing the config.

Category
Legal & Government
Version
1.0.0
Registry
active
Published
11/19/2026
Listed in:Official MCP registry ↗how this is checked

Is it safe? Is it maintained?

Serverdex check: Nov 22, 2026

Looks healthy: htsapi.dev is maintained, open source, hosted endpoint answering without a key.

Maintained
Active
Last commit 3 days ago (Nov 19, 2026), 0 open issues.
Official registry
Active
Published as dev.htsapi/mcp in the official MCP registry, version 1.0.0.
Source
Open source, MIT
Public repository under the MIT licence, 0 stars, 0 forks.
Runs
Hosted by the publisher
Your client talks to htsapi.dev: prompts and tool arguments leave your machine for that host.
Credentials
None needed to connect
The hosted endpoint completed the Serverdex initialize + tools/list handshake with no key (checked Nov 22, 2026); individual tools may still ask for one.
Owner
Unclaimed
Nobody has claimed this page yet; the data above comes from the registry, GitHub and the live check.

Facts only: last commit and licence from GitHub, the entry's status from the official registry, credentials from the live check. Not a code audit — run the security scan on the endpoint yourself and see the status history.

Live check

checked Nov 22, 2026, 07:08 UTCStatus history & uptime →
● Working334 msprotocol 2025-06-18v1.0.0promptsresourcestools

The endpoint answered the MCP handshake as "htsapi" and listed 8 tools. Answering since Nov 21, 2026.

Context cost ≈ 2.4k tokens of tool definitions a client loads per conversation (estimate: characters ÷ 4) across 8 tools.

Tools (8)

  • lookup_hts_code1 param

    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.

    Show parameters
    • codeAn 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.
  • importers_paid2 params

    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.

    Show parameters
    • codestringrequiredAn HTS code, 6 to 10 digits, dotted or not (8205.51.30).
    • country_of_originstringrequiredCountry of origin: name, ISO code or common alias (China, CN, PRC, Viet Nam).
  • get_notes1 param

    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.

    Show parameters
    • codeAny 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.
  • heading_scope2 params

    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.

    Show parameters
    • headingstringrequiredAn HTS heading (9505) or any code under it (9505.10.25).
    • productThe 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.
  • rulings_under_code4 params

    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.

    Show parameters
    • codestringrequiredAn 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.
    • productOptional: the product in plain words, to put the rulings closest to it first.
    • limitintegerRulings to return, 1-50.
    • offsetintegerRulings to skip, for the next page.
  • search_rulings2 params

    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.

    Show parameters
    • querystringrequiredThe product in plain words: what it is, what it is made of, what it is for.
    • limitintegerRulings to return, 1-30.
  • get_ruling1 param

    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).

    Show parameters
    • ruling_numberstringrequiredA CBP ruling number: N338413, H301540, 881984.
  • classify_product3 params

    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.

    Show parameters
    • descriptionstringrequiredWhat 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_originCountry 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 mo
    • materialMain material, if not already in the description.

Checked by Serverdex with a plain initialize + tools/list call to htsapi.dev/mcp, no credentials, about once a day. A failed check is never a removal.

On GitHub

read Nov 21, 2026
Stars
0
Forks
0
Last push
Nov 19, 2026
License
MIT

TypeScriptcbp-rulingscustomshtsmcpmcp-servermodel-context-protocoltariff-classificationtrade-compliance

From the README

htsapi.dev MCP server -brightgreen) Give your AI agent what a customs classifier reads when it picks a US tariff code: • the Harmonized Tariff Schedule (USITC) one level at a time, with its section and chapter notes and the General Rules of Interpretation; • over 222,000 CBP rulings (CROSS) in full text, each with its status: revoked or modified, by which ruling, and where the goods went; • what CBP's rulings quote and decide on a heading: the Explanatory Note passages and legal notes CBP relied on, grouped across rulings, with what each ruling concluded; • what importers paid on a code from a country in the latest 3 months of US Census data. Your agent classifies; the importer decides. Everything is guidance from public sources, not legal advice or a binding ruling. Why sources rather than a code from us: htsapi.dev/method. What you can ask • "What HTS code fits a stainless steel vacuum bottle made in China, and what did importers actually pay on it?" • "Has CBP ruled on silicone baking mats? Are those rulings still in force?" • "What do CBP's rulings say separates heading 9021 from 6406 for shoe insoles?" • "Read ruling N046655 and tell me whether anything revoked or modified it." • "Write a classification file for a battery-powered milk frother from Vietnam." (the classification_file prompt) Connect The hosted server is https://htsapi.dev/mcp (Streamable HTTP).…

Read the full README on GitHub →

Remotes

  • streamable-httphttps://htsapi.dev/mcp

The most-starred Legal & Government servers in the index, with their live-check result.

ServerStarsLast pushLive check
Korean Law MCP2,891Nov 2026Working
EdgarTools2,859Nov 2026Local / not checked
Global law2,167Nov 2026Working
MCP Fiscal Brasil433Nov 2026Local / not checked
Legal Data Hunter422Nov 2026Needs sign-in

htsapi.dev: questions people ask

Is htsapi.dev a remote or a local MCP server?
According to its entry in the official MCP registry, htsapi.dev ships as a hosted endpoint (streamable-http) that your client connects to by URL.
Does htsapi.dev need an API key?
Its hosted endpoint completed the Serverdex live check — an MCP initialize + tools/list call — with no credentials on Nov 22, 2026. Individual tools may still ask for a key when called.
Is htsapi.dev safe to use?
Looks healthy: htsapi.dev is maintained, open source, hosted endpoint answering without a key. In detail — maintained: Active; official registry: Active; source: Open source, MIT; runs: Hosted by the publisher; credentials: None needed to connect. Serverdex check of Nov 22, 2026. This is a reading of the repository, the registry entry and the live check, not a code audit; run the Serverdex security scan on the endpoint before trusting it with real data.
Is htsapi.dev still maintained?
Active: the repository's last commit 3 days ago. Last push Nov 19, 2026, 0 GitHub stars, MIT licence. Read from GitHub on Nov 21, 2026.
What tools does htsapi.dev expose?
8 tools as listed by the server itself during the live check, including lookup_hts_code, importers_paid, get_notes, heading_scope, rulings_under_code. The full list with parameters is in the Live check section above.
How do I add htsapi.dev to Claude, Cursor or VS Code?
Copy the config in "Connect this server" into your client's MCP config file (claude_desktop_config.json, ~/.cursor/mcp.json or .vscode/mcp.json), or use the one-click Add to Cursor / Add to VS Code buttons and the one-line commands for Claude Code and Codex; then restart the client.
  1. Emission FactorsKeyless US grid carbon + power cost by ZIP: eGRID Scope 2, Scope 1 fuels, site ranking, clean hours★ 1
  2. vulntelFree hosted CVE intel for bug-bounty agents: CVE fact-check, attack approaches from paid H1 reports
  3. vuln-intelFree hosted CVE intel for bug-bounty agents: CVE fact-check, attack approaches from paid H1 reports
  4. GrounderWeb grounding for local & cloud LLMs: search, fetch, token-capped evidence packs, and research.
Browse all Legal & Government →

Add the badge to your site

Show visitors that htsapi.dev is listed here — it’s also the link we check for a free listing.

htsapi.dev — listed on Serverdex

HTML — for your website

<a href="https://serverdex.io/server/dev-htsapi-mcp?utm_source=badge"><img src="https://serverdex.io/brand/badge.svg" alt="htsapi.dev — listed on Serverdex" width="123" height="40" loading="lazy"></a>

Recommended. A dofollow link from your own domain is the one that counts for search engines, and it's the link we check for a free listing.

Markdown — for your README

[![htsapi.dev — listed on Serverdex](https://serverdex.io/brand/badge.svg)](https://serverdex.io/server/dev-htsapi-mcp?utm_source=badge)

Nice for visibility, but GitHub marks README links nofollow, so it doesn't pass authority. Use the HTML badge on your site as well.

Add to CursorAdd to VS CodeOpen in Claude Code

Install buttons — for your README

[![Add to Cursor](https://serverdex.io/brand/install-cursor.svg)](https://serverdex.io/install/cursor/dev-htsapi-mcp) [![Add to VS Code](https://serverdex.io/brand/install-vscode.svg)](https://serverdex.io/install/vscode/dev-htsapi-mcp) [![Open in Claude Code](https://serverdex.io/brand/install-claude-code.svg)](https://serverdex.io/install/claude-code/dev-htsapi-mcp)

One click opens Cursor or VS Code with this server's config prefilled; the Claude Code button lands on the one-line command. The links point at Serverdex, so when your config changes the buttons keep working.

Install buttons — HTML for your docs

<a href="https://serverdex.io/install/cursor/dev-htsapi-mcp"><img src="https://serverdex.io/brand/install-cursor.svg" alt="Add to Cursor — via Serverdex" width="140" height="28"></a>
<a href="https://serverdex.io/install/vscode/dev-htsapi-mcp"><img src="https://serverdex.io/brand/install-vscode.svg" alt="Add to VS Code — via Serverdex" width="147" height="28"></a>
<a href="https://serverdex.io/install/claude-code/dev-htsapi-mcp"><img src="https://serverdex.io/brand/install-claude-code.svg" alt="Open in Claude Code — via Serverdex" width="180" height="28"></a>

Same buttons as plain links for a docs page or website.

Prefer a live badge with the score, stars and live check? Score badge (links to a page that explains the number and back to this listing).