Back to Browse

Hs Code Classifier MCP Server

Developer ToolsUse Caution3.8MCP RegistryLocalRemote
Free

Server data from the Official MCP Registry

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

About

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

Remote endpoints: streamable-http: https://hs-code-classifier-mcp-server-production.up.railway.app

Security Report

3.8
Use Caution3.8High Risk

The HS Code Classifier MCP server implements reasonable authentication and rate-limiting mechanisms for a freemium service, with appropriate use of environment variables for sensitive credentials. However, there are several security and code quality concerns: environment variables are logged to stderr in error messages, the free tier tracking system is vulnerable to IP spoofing attacks, request context is stored in global variables creating concurrency risks in production, and the stripe webhook signature verification could be more robust. Permissions align with the server's purpose (network access for APIs, file I/O for stats persistence), but the rate-limiting implementation lacks proper protection against distributed abuse. Supply chain analysis found 10 known vulnerabilities in dependencies (0 critical, 7 high severity). Package verification found 1 issue.

4 files analyzed · 20 issues found

Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.

Permissions Required

This plugin requests these system permissions. Most are normal for its category.

env_vars

Check that this permission is expected for this type of plugin.

HTTP Network Access

Connects to external APIs or services over the internet.

File System Write

Writes or modifies files on your machine. Check that this is expected for the tool.

File System Read

Reads files on your machine. Normal for tools that analyze or process local data.

What You'll Need

Set these up before or after installing:

Anthropic API key for AI-assisted classification reasoningRequired

Environment variable: ANTHROPIC_API_KEY

HSPing API key for official tariff schedule accessRequired

Environment variable: HSPING_API_KEY

How to Install & Connect

Available as Local & Remote

This plugin can run on your machine or connect to a hosted endpoint. during install.

Documentation

View on GitHub

From the project's GitHub 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)

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.

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

Reviews

No reviews yet

Be the first to review this server!

Hs Code Classifier MCP Server - Classify products to official HS codes and validate | MCP Marketplace