HS Codes Classifier
Classify a product description into a 6-digit HS customs code
- Pricing
- Open source
- Platforms
- CLI, API
- Runs
- Remotely
- Version
- 1.0.0
- Listing updated
- today
Similar MCP servers
About HS Codes Classifier
HS Codes Classifier is an open-source MCP server for freight and logistics. It runs as a hosted remote server, so there is nothing to install locally.
A single tool takes free-text product descriptions and returns a Harmonized System code at six-digit level. Classification is done by GPT-4o-mini, and the README says it supports more than 200 countries.
The package is started with npx hs-codes-mcp and the registry entry also lists a hosted streamable HTTP endpoint, so it can be run locally or called remotely. It is released under the MIT licence.
The README is short and gives no accuracy figures, so classifications are best treated as a first suggestion to confirm with a customs broker.
Install
Run in a terminal
claude mcp add --transport http hs-codes-mcp https://hs-codes-classifier.boring-saas-infra.workers.dev/mcpAdd to Settings → Connectors → Add custom connector
https://hs-codes-classifier.boring-saas-infra.workers.dev/mcpAdd to ~/.cursor/mcp.json
{
"mcpServers": {
"hs-codes-mcp": {
"url": "https://hs-codes-classifier.boring-saas-infra.workers.dev/mcp"
}
}
}Add to .vscode/mcp.json
{
"servers": {
"hs-codes-mcp": {
"type": "http",
"url": "https://hs-codes-classifier.boring-saas-infra.workers.dev/mcp"
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"hs-codes-mcp": {
"serverUrl": "https://hs-codes-classifier.boring-saas-infra.workers.dev/mcp"
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"hs-codes-mcp": {
"type": "http",
"url": "https://hs-codes-classifier.boring-saas-infra.workers.dev/mcp"
}
}
}Using several servers? Build one config file with the MCP config generator.
Tools this server provides (1)
Taken from the project documentation; the running server may differ.
- classify_product
- Get the HS code for a product description.
What it does
- Description to HS code
- Maps any plain product description to a 6-digit HS code.
- LLM-backed matching
- Uses GPT-4o-mini to interpret the description.
- Wide country coverage
- The README says it supports 200+ countries.
- Run locally or remotely
- Start it with npx or use the hosted HTTP endpoint.
Good for
- Pre-fill customs fields for a shipment
- Tag a product catalogue with HS codes
- Let a logistics assistant answer classification questions
- Draft commercial invoices faster
Pricing
Open source
MIT licensed; the classifier calls an OpenAI model.
HS Codes Classifier FAQ
Which model does the classification?
GPT-4o-mini, according to the README.
How precise are the codes?
It returns 6-digit HS codes; the README gives no accuracy numbers.
How do I run it?
Use npx hs-codes-mcp, or connect to the hosted streamable HTTP endpoint.
What licence applies?
MIT.
Is HS Codes Classifier free?
Yes. HS Codes Classifier is open source, so you can use and self-host it for free.
How do I add HS Codes Classifier to Claude Code?
Run this command in your terminal: claude mcp add --transport http hs-codes-mcp https://hs-codes-classifier.boring-saas-infra.workers.dev/mcp
What are the best alternatives to HS Codes Classifier?
The closest alternatives to HS Codes Classifier are ChatGPT for Amazon, O'So MCP Server for PrestaShop, Ebid, Zovo Product Recall Check and Trackkr MCP Server — Smart Lockerless Parcel Management.
Where this comes from
- Description: written from the project's README.
- Install steps: from the official MCP Registry entry.
