About HS Code Classifier
HS Code Classifier is an MCP server for classifying product descriptions and checking supplier-provided HS codes before customs submissions. It uses official tariff schedules through the HSPing API with AI-assisted reasoning.
Key features
- 01Classify descriptions into HS codes
- 02Check supplier codes for mismatches
- 03Flag outdated codes and risks
- 04Use government tariff schedules
Use cases
- 01Prepare customs declarations
- 02Check codes on supplier shipments
- 03Review codes before purchase orders
MCP support
Exposes `hs_classify_product` and `hs_validate_code` tools to MCP clients. It is available over HTTP or through an npm stdio command.
Configuration
Remote servers need no local install. Pick your client, then copy the config or install in one click.
https://hs-code-classifier-mcp-server-production.up.railway.appclaude mcp add --transport http ojaskord-hs-code-classifier https://hs-code-classifier-mcp-server-production.up.railway.app{"mcpServers":{"ojaskord-hs-code-classifier":{"type":"http","url":"https://hs-code-classifier-mcp-server-production.up.railway.app"}}}Open in Cursor{"servers":{"ojaskord-hs-code-classifier":{"type":"http","url":"https://hs-code-classifier-mcp-server-production.up.railway.app"}}}Open in VS Code{"mcpServers":{"ojaskord-hs-code-classifier":{"type":"http","url":"https://hs-code-classifier-mcp-server-production.up.railway.app"}}}{"mcpServers":{"ojaskord-hs-code-classifier":{"serverUrl":"https://hs-code-classifier-mcp-server-production.up.railway.app"}}}Run commands in a terminal; paste JSON into the client’s MCP config and restart. Servers that need sign-in will prompt on first connect.
Tools
Details
From the project READMEHS 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
| Tier | Calls | Price |
|---|---|---|
| Free | 10/month | $0 |
| Starter | 500-call bundle | $40 |
| Pro | 2,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
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.