HS Code Classifier
Classify products to official HS codes and validate supplier codes before customs submissions
Installation
Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).
claude mcp add --transport http hs-code-classifier 'https://hs-code-classifier-mcp-server-production.up.railway.app'
{
"mcpServers": {
"hs-code-classifier": {
"type": "http",
"url": "https://hs-code-classifier-mcp-server-production.up.railway.app"
}
}
}
hs-code-classifier-mcpclaude mcp add hs-code-classifier -e 'ANTHROPIC_API_KEY=<your anthropic_api_key>' -e 'HSPING_API_KEY=<your hsping_api_key>' -- npx -y hs-code-classifier-mcp@1.0.26
{
"mcpServers": {
"hs-code-classifier": {
"command": "npx",
"args": [
"-y",
"hs-code-classifier-mcp@1.0.26"
],
"env": {
"ANTHROPIC_API_KEY": "<your anthropic_api_key>",
"HSPING_API_KEY": "<your hsping_api_key>"
}
}
}
}
Variables d'environnement
ANTHROPIC_API_KEYobligatoire secret Anthropic API key for AI-assisted classification reasoningHSPING_API_KEYobligatoire secret HSPing API key for official tariff schedule access
Documentation
Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.
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
Questions fréquentes
Qu'est-ce que HS Code Classifier ?
Classify products to official HS codes and validate supplier codes before customs submissions
Comment installer HS Code Classifier ?
Il fonctionne comme serveur distant. Dans Claude Code : claude mcp add --transport http hs-code-classifier 'https://hs-code-classifier-mcp-server-production.up.railway.app'. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.
Faut-il une clé API pour HS Code Classifier ?
Oui. Il attend ANTHROPIC_API_KEY, HSPING_API_KEY, à renseigner dans sa configuration.
HS Code Classifier est-il open source ?
Oui. Son code est sur GitHub sous licence MIT.
Qui maintient HS Code Classifier ?
Il est publié par OjasKord. AI.tn le référence sans le maintenir ni le recommander.
Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.