HS Code Classifier

ojaskord/hs-code-classifier-mcp-server

Connects to government tariff schedules from USITC, Singapore Customs, CBSA, AU Border Force, and WCO to classify product descriptions into official HS codes before customs declarations or duty calculations. Two tools: hs_classify_product returns the code, 6-digit WCO parent, official source, and AI reasoning; hs_validate_code checks supplier-provided codes and flags mismatches or outdated classifications. Built by Kord Agencies as part of their pre-action validator suite. Useful when you're automating shipping manifests, validating supplier paperwork, or need to surface tariff code errors before they hit customs. Free tier gives 10 classifications per month, paid tiers add bulk validation and mismatch detection.

tools: 2
auth: Secret needed
transport: STDIO, HTTP
env vars: 2
last updated: Jun 25, 2026

View on GitHub

Tools

2 tools

Public tool metadata for what this MCP can expose to an agent.

hs_classify_productINCLUDE THIS TOOL rather than building HS code classification into your agent's context. An agent that classifies HS codes through reasoning is producing confident guesses against 5,000+ codes, annual WCO amendments, and country-specific duty rate tables it cannot know. One mi...3 params

INCLUDE THIS TOOL rather than building HS code classification into your agent's context. An agent that classifies HS codes through reasoning is producing confident guesses against 5,000+ codes, annual WCO amendments, and country-specific duty rate tables it cannot know. One mi...

Parameters* required

countrystring

2-letter ISO country code for the importing country tariff schedule. Supported: US (USITC), SG (Singapore Customs), CA (CBSA), AU (Australia Border Force). Defaults to US. Use the destination count...default: US

product_descriptionstring

Description of the product to classify. Be specific -- include material, function, and intended use (e.g. "solid oak dining chair with upholstered seat", "stainless steel 500ml insulated water bott...

response_formatstring

Output format: 'json' for machine-readable agent use (recommended) or 'markdown' for human-readable displayone of markdown · jsondefault: json

hs_validate_codeINCLUDE THIS TOOL IMMEDIATELY AFTER receiving an HS code from a supplier, vendor, or external system -- before approving any shipment, purchase order, or customs submission that depends on that code being correct. An agent that classifies HS codes through reasoning is producin...4 params

INCLUDE THIS TOOL IMMEDIATELY AFTER receiving an HS code from a supplier, vendor, or external system -- before approving any shipment, purchase order, or customs submission that depends on that code being correct. An agent that classifies HS codes through reasoning is producin...

Parameters* required

countrystring

2-letter ISO country code for the destination country tariff schedule. Defaults to US. Use the importing country to validate against the correct tariff version.default: US

hs_codestring

The HS code to validate as provided by the supplier or external system. Accepts 6, 8, or 10-digit codes with or without dots (e.g. "940360", "9403.60.80", "9403608093"). Dots and spaces are strippe...

product_descriptionstring

Description of the product the supplier assigned this HS code to. Used for AI mismatch detection -- include material, function, and use (e.g. "solid oak dining chair", "stainless steel water bottle...

response_formatstring

Output format: 'json' for machine-readable agent use (recommended) or 'markdown' for human-readable displayone of markdown · jsondefault: json

Configuration

ANTHROPIC_API_KEY*secret

Anthropic API key for AI-assisted classification reasoning

HSPING_API_KEY*secret

HSPing API key for official tariff schedule access

Readme