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.
O que dá para fazer com 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
Instalação
Adicione HS Code Classifier ao seu cliente. Escolha o que você usa.
{
"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.
Pontuação
39 / 100
Incompleta
- Documentação22/25
- Manutenção25/25
- Confiança13/20
- Capacidade0/15
- Instalação15/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
Histórico de versões
| Versões | Publicada |
|---|---|
| 1.0.26Mais recente | 25 de jun. de 2026 |
| 1.0.25 | 24 de jun. de 2026 |
| 1.0.7 | 2 de mai. de 2026 |
| 1.0.5 | 28 de abr. de 2026 |
| 1.0.4 | 26 de abr. de 2026 |
| 1.0.3 | 26 de abr. de 2026 |
| 1.0.2 | 26 de abr. de 2026 |
| 1.0.1 | 24 de abr. de 2026 |
| 1.0.0 | 24 de abr. de 2026 |