# HS Codes Classifier

> HS Codes Classifier is an open-source MCP server for freight and logistics. Classify a product description into a 6-digit HS customs code. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, API
- **Repository:** https://github.com/alex-dev-web-c-de/hs-codes-mcp
- **MCP Registry name:** io.github.Alex-Dev-Web-C-DE/hs-codes-mcp
- **Categories:** [freight and logistics](https://ai-powered.com/categories/freight-and-logistics), [e-commerce](https://ai-powered.com/categories/e-commerce)
- **Listing updated:** 2026-11-18

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http hs-codes-mcp https://hs-codes-classifier.boring-saas-infra.workers.dev/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://hs-codes-classifier.boring-saas-infra.workers.dev/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "hs-codes-mcp": {
      "url": "https://hs-codes-classifier.boring-saas-infra.workers.dev/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "hs-codes-mcp": {
      "type": "http",
      "url": "https://hs-codes-classifier.boring-saas-infra.workers.dev/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "hs-codes-mcp": {
      "serverUrl": "https://hs-codes-classifier.boring-saas-infra.workers.dev/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "hs-codes-mcp": {
      "type": "http",
      "url": "https://hs-codes-classifier.boring-saas-infra.workers.dev/mcp"
    }
  }
}
```

## Tools

- `classify_product`: Get the HS code for a product description.

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

## Alternatives

- [ChatGPT for Amazon](https://ai-powered.com/mcp/chatgpt_for_amazon): ChatGPT for Amazon is a freemium MCP server for marketing.
- [O'So MCP Server for PrestaShop](https://ai-powered.com/mcp/o-so-mcp-server-for-prestashop): O'So MCP Server for PrestaShop is an open-source MCP server for e-commerce.
- [Ebid](https://ai-powered.com/mcp/ebid): Ebid is a freemium MCP server for e-commerce.
- [Zovo Product Recall Check](https://ai-powered.com/mcp/zovo-product-recall-check): Zovo Product Recall Check is an MCP server for e-commerce.
- [Trackkr MCP Server — Smart Lockerless Parcel Management](https://ai-powered.com/mcp/trackkr-mcp-server-smart-lockerless-parcel-management): Trackkr MCP Server — Smart Lockerless Parcel Management is an MCP server for e-commerce.
- [Skybridge Ecommerce Example](https://ai-powered.com/mcp/skybridge-ecommerce-example): Skybridge Ecommerce Example is an open-source MCP server for e-commerce.
- [GoAI Moat Tiktok Shop](https://ai-powered.com/mcp/goai-moat-tiktok-shop): GoAI Moat Tiktok Shop is an MCP server for e-commerce.
- [GoAI Moat Xiaohongshu Products](https://ai-powered.com/mcp/goai-moat-xiaohongshu-products): GoAI Moat Xiaohongshu Products is an MCP server for e-commerce.

---
Source: https://ai-powered.com/mcp/hs-codes-classifier
