Skip to content
MCP server

HS Codes Classifier

Classify a product description into a 6-digit HS customs code

Install
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/mcp

Add to Settings → Connectors → Add custom connector

https://hs-codes-classifier.boring-saas-infra.workers.dev/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "hs-codes-mcp": {
      "url": "https://hs-codes-classifier.boring-saas-infra.workers.dev/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

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.

How AIPoweredBot checks servers