Koskamo

htsapi.dev MCP

An MCP server providing US tariff schedules, CBP rulings, and import payment data to AI agents for customs classification assistance. It allows agents to look up HTS codes, search rulings, and understand legal notes, leaving the final classification decision to the user.

Endpoint and access

No sign-in to connect and list tools. Individual tools may still need a vendor account, credentials, or permissions; check the documented prerequisites.

htsapi.dev MCP logo, by htsapi.devVendor evidenceStreamable HTTPNo sign-inEndpoint checked 2026-11-19Operated by htsapi.dev
You need:Free allowance, prices and limits: Price . MCP server https://htsapi.dev/mcp Remote MCP over Streamable HTTP. With an API key (needed only for classify_product ), send it as the X-API-Key header.
MCP endpoint (Streamable HTTP)
https://htsapi.dev/mcp
Vendor documentation

What its tools do

8 tools, grouped by the hints the server advertises. Hints are self-declared, not verified behavior.

Can change data (1)

8 of 8 have a description · 8 of 8 declare behavior hints · 8 of 8 with parameters document them all

Checks and signals

Each line is separate evidence, not a trust score.

  • Passed Endpoint answered the live check ·
  • Passed Official MCP Registry namespace is tied to htsapi.dev ·
  • Passed Endpoint is on the registry namespace domain ·
  • Availability 1 of 1 checks passed in 30 days

What you can do with it

  • Search CBP rulings for a product description
  • Look up HTS code details and rates
  • Find what importers paid on a specific code
  • Get section and chapter legal notes

Source and maintenance

Vendor evidenceRegistry 1.0.0
Maintenance checked

Protocol and capabilities

Server
htsapi 1.0.0
MCP protocol negotiated in check
2025-11-25
Tools
8 advertised
Resources
0 advertised
Resource templates
0 advertised
Prompts
1 advertised
Server-advertised capabilities
{
  "tools": {
    "listChanged": false
  },
  "prompts": {
    "listChanged": false
  },
  "resources": {
    "subscribe": false,
    "listChanged": false
  },
  "experimental": {}
}

Server-provided instructions

Untrusted server output shown for inspection. It is not Koskamo guidance and is excluded from knowledge search.

Official sources for US tariff classification: the Harmonized Tariff Schedule with its legal notes (USITC), CBP's rulings with their current status (CROSS), and what importers actually paid (Census). You classify; the importer decides. Work the way a licensed broker builds a classification file: 1. Facts first: what the product is, what it is made of (with percentages), how it works, what it is for, and how it is imported (set, kit, unassembled, packaging). If a fact that decides between headings is missing, ask for it rather than guess. 2. Candidate headings (GRI 1): heading terms and section and chapter notes decide, not titles or keywords. search_rulings shows how CBP classified similar goods: use it to find candidates, not to copy a code. lookup_hts_code reads the schedule: sections, a chapter's headings, a heading's subheadings. 3. Read the notes: get_notes for each candidate's section and chapter. Their exclusions and definitions override heading text and rulings alike. heading_scope with the product shows what CBP's rulings say each candidate heading covers, on the goods closest to it, and what they decided. 4. Only if several headings still fit: GRI 2 to 5 (3(b): essential character). Then go down one level at a time (GRI 6) with lookup_hts_code; an "Other" line says what it is not. 5. Check before relying on a code: rulings_under_code with the product (CODE IN DOUBT means CBP moved similar goods to another code), and get_ruling on each ruling you rely on: only a current ruling is authority (see superseded_by, modified_by, code_conflict, obsolete_codes, replaced_by). 6. Report the code, or the codes still open and the question that decides; the notes and GRIs applied; the rulings relied on and any against, by number and date. The classification_file prompt sets out the full file. Cite rulings and notes only as a tool returned them, and say when you rely on your own knowledge. A ruling binds only its own goods: compare facts. low_match on a search means no close precedent. For goods to be entered, a code beyond 6 digits is the importer's decision (CBP HQ H350722); when it stays unclear, the importer can ask CBP for a binding ruling (19 CFR part 177). Cost: general_duty is the schedule's base rate. importers_paid gives what importers from a country paid in the latest 3 Census months, base rate plus Chapter 99 duties (not anti-dumping or countervailing duties). It is history, not the duty owed today, which these tools do not compute. classify_product (1 credit, needs an API key) is our own classifier: a second opinion after these steps, not a substitute for them. The other tools work without a key, 50 calls a day. Everything here is guidance, not a binding ruling.

Tools

8 advertised

lookup_hts_code
Advertised by the server during the last successful anonymous check.
Advertised read-only

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.

lookup_hts_code input schema
{
  "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."
    }
  }
}
lookup_hts_code output schema
{
  "type": "object",
  "title": "lookup_hts_codeDictOutput",
  "additionalProperties": true
}
lookup_hts_code annotations
{
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
importers_paid
Advertised by the server during the last successful anonymous check.
Advertised read-only

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.

importers_paid input schema
{
  "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)."
    }
  }
}
importers_paid output schema
{
  "type": "object",
  "title": "importers_paidDictOutput",
  "additionalProperties": true
}
importers_paid annotations
{
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
get_notes
Advertised by the server during the last successful anonymous check.
Advertised read-only

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.

get_notes input schema
{
  "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."
    }
  }
}
get_notes output schema
{
  "type": "object",
  "title": "get_notesDictOutput",
  "additionalProperties": true
}
get_notes annotations
{
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
heading_scope
Advertised by the server during the last successful anonymous check.
Advertised read-only

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.

heading_scope input schema
{
  "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."
    }
  }
}
heading_scope output schema
{
  "type": "object",
  "title": "heading_scopeDictOutput",
  "additionalProperties": true
}
heading_scope annotations
{
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
rulings_under_code
Advertised by the server during the last successful anonymous check.
Advertised read-only

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.

rulings_under_code input schema
{
  "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."
    }
  }
}
rulings_under_code output schema
{
  "type": "object",
  "title": "rulings_under_codeDictOutput",
  "additionalProperties": true
}
rulings_under_code annotations
{
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
search_rulings
Advertised by the server during the last successful anonymous check.
Advertised read-only

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.

search_rulings input schema
{
  "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."
    }
  }
}
search_rulings output schema
{
  "type": "object",
  "title": "search_rulingsDictOutput",
  "additionalProperties": true
}
search_rulings annotations
{
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
get_ruling
Advertised by the server during the last successful anonymous check.
Advertised read-only

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

get_ruling input schema
{
  "type": "object",
  "title": "get_rulingArguments",
  "required": [
    "ruling_number"
  ],
  "properties": {
    "ruling_number": {
      "type": "string",
      "title": "Ruling Number",
      "description": "A CBP ruling number: N338413, H301540, 881984."
    }
  }
}
get_ruling output schema
{
  "type": "object",
  "title": "get_rulingDictOutput",
  "additionalProperties": true
}
get_ruling annotations
{
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
classify_product
Advertised by the server during the last successful anonymous check.

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.

classify_product input schema
{
  "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)."
    }
  }
}
classify_product output schema
{
  "type": "object",
  "title": "classify_productDictOutput",
  "additionalProperties": true
}
classify_product annotations
{
  "readOnlyHint": false,
  "openWorldHint": false,
  "idempotentHint": false,
  "destructiveHint": false
}

Prompts

1 advertised

classification_file — Classification file

Advertised by the server during the last successful anonymous check.

Classify one product for US import the way a broker documents it, and write the classification file: facts, headings considered, notes, GRIs, code, rulings, open points.

product
No description (required)
country_of_origin
No description

Resources

0 advertised

No resource definitions available.

90-day uptime

A lightweight connection check about every six hours, sampled on hosts with many listings. It shows the server answered, not that its tools work.

Too few checks for a percentage yet (10 of 10 answered).

  1. 2026-11-19: 2 of 2 checks answered
  2. 2026-11-20: 3 of 3 checks answered
  3. 2026-11-21: 4 of 4 checks answered
  4. 2026-11-22: 1 of 1 checks answered

30-day availability

Aggregated from read-only remote checks; this is not a tool-execution or security guarantee.

Successful checks
1 of 1 (100%)
Average latency
1654 ms
95th percentile latency
1654 ms

Maintenance history

Public check and source-refresh events. Editorial and ownership records remain private.

  • · probe · passed · 1654 ms · metadata changed · 8 tool(s), 0 resource(s), 0 resource template(s), 1 prompt(s)

Connect from your client

Each snippet registers the same endpoint; pick the client you use.

This server is operated by the named third party. Listing and endpoint checks are not an endorsement or a security audit. Review the operator's permissions, terms, and data handling before connecting. How listings are checked and corrected.

Claude Code

Run this once in a terminal. It registers the remote server. Use --scope project to write .mcp.json for the repo.
Claude Code configuration
claude mcp add --transport http htsapi-dev-mcp https://htsapi.dev/mcp

Codex

Run this once. Codex stores MCP servers in ~/.codex/config.toml (or .codex/config.toml in a trusted project).
Codex configuration
codex mcp add htsapi-dev-mcp --url https://htsapi.dev/mcp

Cursor

Merge this server into .cursor/mcp.json in your project, then enable htsapi-dev-mcp in your MCP settings.
Cursor configuration
{
  "mcpServers": {
    "htsapi-dev-mcp": {
      "url": "https://htsapi.dev/mcp"
    }
  }
}

Cline

Merge this into cline_mcp_settings.json (Cline → MCP Servers → Configure).
Cline configuration
{
  "mcpServers": {
    "htsapi-dev-mcp": {
      "type": "streamableHttp",
      "url": "https://htsapi.dev/mcp",
      "disabled": false
    }
  }
}

VS Code

Merge this server into .vscode/mcp.json. Use MCP: List Servers to start htsapi-dev-mcp and inspect its tools.
VS Code configuration
{
  "servers": {
    "htsapi-dev-mcp": {
      "type": "http",
      "url": "https://htsapi.dev/mcp"
    }
  }
}

Gemini CLI

Run this once. It writes .gemini/settings.json in the current project; pass --scope user for ~/.gemini/settings.json.
Gemini CLI configuration
gemini mcp add --transport http htsapi-dev-mcp https://htsapi.dev/mcp

Claude Desktop

Open Claude Settings > Connectors > Add custom connector, enter this server URL and enable it for the conversation. This is a manual remote-connector handoff, not a desktop JSON configuration.
Claude Desktop configuration
https://htsapi.dev/mcp

Windsurf

Merge this into ~/.codeium/windsurf/mcp_config.json, then refresh MCP in Cascade. Windsurf remote servers use serverUrl, not url.
Windsurf configuration
{
  "mcpServers": {
    "htsapi-dev-mcp": {
      "serverUrl": "https://htsapi.dev/mcp"
    }
  }
}

Let your agent find its tools

Find servers like htsapi.dev MCP from your agent. Add Koskamo once to search the index for endpoints, access requirements, and client setup. Public discovery needs no key.

Do you run htsapi.dev MCP?

Prove ownership with a DNS record, a well-known file, or your Official MCP Registry entry, and your edits publish immediately. Proofs are re-checked weekly; admins can still hide or remove a listing.

Claim this listing