npm hs-code-classifier-mcpstreamable-httpMITupdated 15d ago
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.
What can you do with HS Code Classifier?
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
| 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
Install
Add HS Code Classifier to your client. Pick the one you use.
{
"servers": {
"hs-code-classifier-mcp": {
"type": "http",
"url": "https://hs-code-classifier-mcp-server-production.up.railway.app"
}
}
}Add to `.vscode/mcp.json` in your workspace.
claude mcp add hs-code-classifier-mcp -- npx -y hs-code-classifier-mcpcodex mcp add hs-code-classifier-mcp -- npx -y hs-code-classifier-mcpamp mcp add hs-code-classifier-mcp -- npx -y hs-code-classifier-mcp{
"mcpServers": {
"hs-code-classifier-mcp": {
"command": "npx",
"args": [
"-y",
"hs-code-classifier-mcp"
]
}
}
}Add to `claude_desktop_config.json`, then restart Claude Desktop.
{
"mcpServers": {
"hs-code-classifier-mcp": {
"command": "npx",
"args": [
"-y",
"hs-code-classifier-mcp"
]
}
}
}Add to `~/.cursor/mcp.json`, or `.cursor/mcp.json` for a single project.
{
"mcpServers": {
"hs-code-classifier-mcp": {
"command": "npx",
"args": [
"-y",
"hs-code-classifier-mcp"
]
}
}
}Add to `~/.codeium/windsurf/mcp_config.json`.
{
"mcpServers": {
"hs-code-classifier-mcp": {
"command": "npx",
"args": [
"-y",
"hs-code-classifier-mcp"
]
}
}
}Add to `cline_mcp_settings.json` via the MCP Servers panel.
{
"mcpServers": {
"hs-code-classifier-mcp": {
"command": "npx",
"args": [
"-y",
"hs-code-classifier-mcp"
]
}
}
}Add to `~/.gemini/settings.json`.
{
"mcpServers": {
"hs-code-classifier-mcp": {
"type": "local",
"command": "npx",
"args": [
"-y",
"hs-code-classifier-mcp"
],
"tools": [
"*"
]
}
}
}Add to `~/.copilot/mcp-config.json`, or run `/mcp add` inside the CLI.
{
"context_servers": {
"hs-code-classifier-mcp": {
"command": {
"path": "npx",
"args": [
"-y",
"hs-code-classifier-mcp"
]
}
}
}
}Add to your Zed `settings.json`.
npx -y hs-code-classifier-mcpRun `goose configure`, choose **Add Extension → Command-line Extension**, and paste this command.
Score
39 / 100
Incomplete
- Documentation22/25
- Maintenance25/25
- Trust13/20
- Capability0/15
- Install experience15/15
- Documents what it does and how to connect
- Has a resolvable package or endpoint
- Exposes at least one tool, prompt or resource
- README has substantive content
- Includes a code example
- Documents its configuration
- Mentions credentials or security posture
- Last commit 8 days ago
- Has a release history
- Repository is not archived
- Licensed MIT
- Namespace verified in the official MCP registry
- Claimed by its owner
- Published under an organisation
- 0 tool(s) documented
- Provides prompt templates
- Provides resources
- 18 documented install method(s)
- Published to a package registry
- Offers a hosted endpoint — no local install
Version history
| Versions | Published |
|---|---|
| 1.0.26Latest | Jun 25, 2026 |
| 1.0.25 | Jun 24, 2026 |
| 1.0.7 | May 2, 2026 |
| 1.0.5 | Apr 28, 2026 |
| 1.0.4 | Apr 26, 2026 |
| 1.0.3 | Apr 26, 2026 |
| 1.0.2 | Apr 26, 2026 |
| 1.0.1 | Apr 24, 2026 |
| 1.0.0 | Apr 24, 2026 |