HS Code Classifier
Classify products to official HS codes and validate supplier codes before customs submissions
التثبيت
أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: .cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «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>"
}
}
}
}
متغيرات البيئة
ANTHROPIC_API_KEYإلزامي سري Anthropic API key for AI-assisted classification reasoningHSPING_API_KEYإلزامي سري HSPing API key for official tariff schedule access
التوثيق
مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على 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
الأسئلة الشائعة
ما هو HS Code Classifier؟
Classify products to official HS codes and validate supplier codes before customs submissions
كيف أثبّت HS Code Classifier؟
يعمل كخادم بعيد. في Claude Code: claude mcp add --transport http hs-code-classifier 'https://hs-code-classifier-mcp-server-production.up.railway.app'. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.
هل يحتاج HS Code Classifier إلى مفتاح API؟
نعم. يتطلب ANTHROPIC_API_KEY, HSPING_API_KEY، وتضبطها في إعداداته.
هل HS Code Classifier مفتوح المصدر؟
نعم. شيفرته متاحة على GitHub بترخيص MIT.
من يصون HS Code Classifier؟
ينشره OjasKord. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.
من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.