English Français العربية

HS Code Classifier

Official registry Developer tools

Classify products to official HS codes and validate supplier codes before customs submissions

Source code Website Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

Remote (streamable-http)
Claude Code 
claude mcp add --transport http hs-code-classifier 'https://hs-code-classifier-mcp-server-production.up.railway.app'
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "hs-code-classifier": {
            "type": "http",
            "url": "https://hs-code-classifier-mcp-server-production.up.railway.app"
        }
    }
}
NPM package hs-code-classifier-mcp
Claude Code 
claude mcp add hs-code-classifier -e 'ANTHROPIC_API_KEY=<your anthropic_api_key>' -e 'HSPING_API_KEY=<your hsping_api_key>' -- npx -y hs-code-classifier-mcp@1.0.26
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "hs-code-classifier": {
            "command": "npx",
            "args": [
                "-y",
                "hs-code-classifier-mcp@1.0.26"
            ],
            "env": {
                "ANTHROPIC_API_KEY": "<your anthropic_api_key>",
                "HSPING_API_KEY": "<your hsping_api_key>"
            }
        }
    }
}

Environment variables

  • ANTHROPIC_API_KEY required secret Anthropic API key for AI-assisted classification reasoning
  • HSPING_API_KEY required secret HSPing API key for official tariff schedule access

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. HS Code Classifier MCP Server
  2. Tools
  3. Usage
  4. Harness Integration
  5. Pricing
  6. Supported Countries
  7. Legal

HS Code Classifier MCP Server

Classify product descriptions to official HS codes and validate supplier-provided codes before customs submissions. Uses official government tariff schedules (USITC, Singapore Customs, CBSA, Australia Border Force) via HSPing API with AI-assisted classification reasoning.

Tools

hs_classify_product (free tier: 10 calls/month)

Convert a product description to the correct HS code before filling any customs declaration, shipping manifest, or duty calculation.

hs_validate_code (Pro tier)

Validate a supplier-provided HS code before approving any shipment or purchase order. Detects mismatches, outdated codes, and misclassification risks using official tariff data and AI analysis.

Usage

HTTP (hosted -- no install required)
https://hs-code-classifier-mcp-production.up.railway.app
npm (Claude Desktop / stdio)
npx hs-code-classifier-mcp

Configure in claude_desktop_config.json:

{
  "mcpServers": {
    "hs-code-classifier": {
      "command": "npx",
      "args": ["hs-code-classifier-mcp"],
      "env": {
        "ANTHROPIC_API_KEY": "sk-ant-...",
        "HSPING_API_KEY": "your-hsping-key",
        "API_KEY": "your-pro-key-from-kordagencies.com"
      }
    }
  }
}

Harness Integration

Note: this server exposes tools at /mcp not the root URL.

Claude Code / Claude Desktop (.mcp.json)
{
  "mcpServers": {
    "hs-code-classifier": {
      "type": "http",
      "url": "https://hs-code-classifier-mcp-server-production.up.railway.app/mcp"
    }
  }
}
LangChain (Python)
from langchain_mcp_adapters.client import MultiServerMCPClient
client = MultiServerMCPClient({
    "hs-code-classifier": {
        "url": "https://hs-code-classifier-mcp-server-production.up.railway.app/mcp",
        "transport": "http"
    }
})
tools = await client.get_tools()
OpenAI Agents SDK (Python)
from agents import Agent, HostedMCPTool
agent = Agent(
    name="Assistant",
    tools=[HostedMCPTool(tool_config={
        "type": "mcp",
        "server_label": "hs-code-classifier",
        "server_url": "https://hs-code-classifier-mcp-server-production.up.railway.app/mcp",
        "require_approval": "never"
    })]
)
LangGraph

Same as LangChain above — langchain-mcp-adapters works with LangGraph natively.

Pricing

TierCallsPrice
Free10/month$0
Starter500-call bundle$40
Pro2,000-call bundle$130

Get a Pro key: kordagencies.com

Supported Countries

US (USITC), SG (Singapore Customs), CA (CBSA), AU (Australia Border Force), and others via HSPing API.

Results sourced from official government tariff schedules via HSPing API. For informational purposes only -- not legal or customs advice. Full terms: kordagencies.com/terms.html

Frequently asked questions

What is HS Code Classifier?

Classify products to official HS codes and validate supplier codes before customs submissions

How do I install HS Code Classifier?

It runs as a remote server. In Claude Code: claude mcp add --transport http hs-code-classifier 'https://hs-code-classifier-mcp-server-production.up.railway.app'. For other clients, paste the JSON configuration from this page into their MCP settings.

Does HS Code Classifier need an API key?

Yes. It expects ANTHROPIC_API_KEY, HSPING_API_KEY, which you set in its configuration.

Is HS Code Classifier open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains HS Code Classifier?

It is published by OjasKord. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.