HS Code Classifier

io.github.OjasKordPublished by GitHub account OjasKordv1.0.26Updated Oct 24, 2026

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

The publisher's own server: classifier.dev

VerifiedStreamable HTTPWeb executableFinanceBusiness & Commerce

Overview

AI-generated overview

Classifies product descriptions into official HS tariff codes and validates supplier-provided codes against government tariff schedules before customs filings.

What you can do
Classify a product description into the correct HS code for customs declarations, shipping manifests or duty calculations (free tier: 10 calls per month). Validate a supplier-provided HS code before approving a shipment or purchase order, flagging mismatches, outdated codes and misclassification risks (Pro tier). Draw on official tariff schedules for the US, Singapore, Canada, Australia and others via the HSPing API, with AI-assisted reasoning.
When to use it
Useful when preparing customs paperwork, shipping manifests or duty estimates and you want an assistant to suggest or check HS codes, or when reviewing a supplier's declared code before approving a shipment or purchase order.
Requirements
Runs as a hosted remote endpoint (tools are exposed at the /mcp path, not the root URL) or locally via the npm package with npx, which needs Node.js. Both ANTHROPIC_API_KEY and HSPING_API_KEY are required; the README's local configuration also lists an API_KEY for a Pro key. A paid bundle is needed beyond the free 10 calls per month.
Before you install
Requires two third-party API keys (ANTHROPIC_API_KEY, HSPING_API_KEY) and, for paid tiers, a Pro key; product descriptions are sent to Anthropic and HSPing. Paid bundles cost money ($40 for 500 calls, $130 for 2,000). Results are stated to be informational only and not legal or customs advice, so verify codes before official submissions.

Installation

In SourceWeft

  1. Open HS Code Classifier in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.OjasKord%2Fhs-code-classifier-mcp-server/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "hs-code-classifier": {
      "type": "http",
      "url": "https://hs-code-classifier-mcp-server-production.up.railway.app/"
    }
  }
}

README

[smithery badge]

HS Code Classifier MCP Server

[ToolRank]

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)

bash
npx hs-code-classifier-mcp

Configure in claude_desktop_config.json:

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)

json
{  "mcpServers": {    "hs-code-classifier": {      "type": "http",      "url": "https://hs-code-classifier-mcp-server-production.up.railway.app/mcp"    }  }}

LangChain (Python)

python
from langchain_mcp_adapters.client import MultiServerMCPClientclient = 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)

python
from agents import Agent, HostedMCPToolagent = 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.

Legal

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

Source: README.md at commit 30ce407

Tools

0
SourceWeft has not read this server's tools yet.

Version history

1
  1. v1.0.26LatestSep 16, 2026

Score

85% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

Other Classifier integrations