Klassifiziert Produktbeschreibungen in offizielle HS-Codes und validiert vom Lieferanten bereitgestellte Codes anhand von staatlichen Zolltariflisten.
Auch bekannt als OjasKord/hs-code-classifier-mcp-server, hs-code-classifier-mcp-server, hs-code-classifier-mcp
- Stars
- 0
- Tools
- —
- Downloads, 30 Tage
- —
- Neueste Version
- 1.0.26
- Letzter Commit
- 7. Sept. 2026
- Lizenz
- MIT
Was ist HS Code Classifier MCP?
Klassifiziert Produktbeschreibungen in offizielle HS-Codes und validiert vom Lieferanten bereitgestellte Codes anhand von staatlichen Zolltariflisten.
Zusammenfassung generiert aus dem README des Projekts
Über HS Code Classifier MCP server
Dieser MCP server ermöglicht es Logistik- und Handelsexperten, Produktbeschreibungen in offizielle HS-Codes zu klassifizieren und Lieferantendaten zu validieren. Er verbindet sich über die HSPing API mit offiziellen staatlichen Zolltariflisten von Behörden wie USITC, Singapore Customs, CBSA und Australia Border Force. Nutzer können den Server lokal via npx ausführen oder eine gehostete HTTP-Version über Claude Desktop, LangChain oder das OpenAI Agents SDK nutzen.
Entwickler nutzen das Tool hs_classify_product, um Beschreibungen für Zollanmeldungen oder Zollberechnungen in Codes umzuwandeln; dies ist in einem Free-Tier mit einem Limit von 10 Aufrufen pro Monat verfügbar. Das Tool hs_validate_code ist im Pro-Tier enthalten, um vom Lieferanten bereitgestellte Codes auf Unstimmigkeiten oder veraltete Informationen zu prüfen. Für die Einrichtung des Servers sind ein ANTHROPIC_API_KEY, ein HSPING_API_KEY und ein Pro-Key von kordagencies.com für erweiterte Funktionen erforderlich.
Was du damit machen kannst
- 1Zolldeklarations-Codes generierenWandle eine Textbeschreibung eines Produkts in den offiziellen HS-Code für Versandmanifeste um.
- 2Genauigkeit von Lieferanten prüfenÜberprüfe, ob ein vom Anbieter bereitgestellter Code korrekt ist und mit den aktuellen staatlichen Zolltarifdaten übereinstimmt.
- 3Risiken durch Fehlklassifizierung minimierenIdentifiziere potenzielle Fehler oder veraltete Codes in deiner Handelsdokumentation mithilfe von KI-Analysen.
Geschrieben aus dem README des Projekts. Jeder Use Case wurde gegen ein Zitat daraus geprüft.
So installierst du HS Code Classifier MCP
Formate geprüft am 10. Nov. 2026Zu Cursor hinzufügenZu Goose hinzufügenHS Code Classifier MCP in Claude Code installieren
$ claude mcp add --env 'ANTHROPIC_API_KEY=<YOUR_ANTHROPIC_API_KEY>' --env 'HSPING_API_KEY=<YOUR_HSPING_API_KEY>' hs-code-classifier-mcp-server -- npx -y hs-code-classifier-mcpHS Code Classifier MCP in Cursor installieren
~/.cursor/mcp.json
{
"mcpServers": {
"hs-code-classifier-mcp-server": {
"command": "npx",
"args": [
"-y",
"hs-code-classifier-mcp"
],
"env": {
"ANTHROPIC_API_KEY": "<YOUR_ANTHROPIC_API_KEY>",
"HSPING_API_KEY": "<YOUR_HSPING_API_KEY>"
}
}
}
}HS Code Classifier MCP in VS Code installieren
.vscode/mcp.json
{
"servers": {
"hs-code-classifier-mcp-server": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"hs-code-classifier-mcp"
],
"env": {
"ANTHROPIC_API_KEY": "<YOUR_ANTHROPIC_API_KEY>",
"HSPING_API_KEY": "<YOUR_HSPING_API_KEY>"
}
}
}
}HS Code Classifier MCP in VS Code CLI installieren
$ code --add-mcp '{"name":"hs-code-classifier-mcp-server","type":"stdio","command":"npx","args":["-y","hs-code-classifier-mcp"],"env":{"ANTHROPIC_API_KEY":"<YOUR_ANTHROPIC_API_KEY>","HSPING_API_KEY":"<YOUR_HSPING_API_KEY>"}}'HS Code Classifier MCP in Claude Desktop installieren
claude_desktop_config.json
{
"mcpServers": {
"hs-code-classifier-mcp-server": {
"command": "npx",
"args": [
"-y",
"hs-code-classifier-mcp"
],
"env": {
"ANTHROPIC_API_KEY": "<YOUR_ANTHROPIC_API_KEY>",
"HSPING_API_KEY": "<YOUR_HSPING_API_KEY>"
}
}
}
}HS Code Classifier MCP in Codex installieren
$ codex mcp add hs-code-classifier-mcp-server --env 'ANTHROPIC_API_KEY=<YOUR_ANTHROPIC_API_KEY>' --env 'HSPING_API_KEY=<YOUR_HSPING_API_KEY>' -- npx -y hs-code-classifier-mcpHS Code Classifier MCP in Codex config.toml installieren
~/.codex/config.toml
[mcp_servers.hs-code-classifier-mcp-server] command = "npx" args = ["-y", "hs-code-classifier-mcp"] [mcp_servers.hs-code-classifier-mcp-server.env] ANTHROPIC_API_KEY = "<YOUR_ANTHROPIC_API_KEY>" HSPING_API_KEY = "<YOUR_HSPING_API_KEY>"
HS Code Classifier MCP in Gemini CLI installieren
$ gemini mcp add -s user -e 'ANTHROPIC_API_KEY=<YOUR_ANTHROPIC_API_KEY>' -e 'HSPING_API_KEY=<YOUR_HSPING_API_KEY>' hs-code-classifier-mcp-server npx -- -y hs-code-classifier-mcpHS Code Classifier MCP in Gemini settings.json installieren
~/.gemini/settings.json
{
"mcpServers": {
"hs-code-classifier-mcp-server": {
"command": "npx",
"args": [
"-y",
"hs-code-classifier-mcp"
],
"env": {
"ANTHROPIC_API_KEY": "<YOUR_ANTHROPIC_API_KEY>",
"HSPING_API_KEY": "<YOUR_HSPING_API_KEY>"
}
}
}
}Konfiguration
ANTHROPIC_API_KEYErforderlichSecretAnthropic API key for AI-assisted classification reasoning
HSPING_API_KEYErforderlichSecretHSPing API key for official tariff schedule access
API_KEY
| Name | Beschreibung | Typ |
|---|---|---|
| ANTHROPIC_API_KEY | Anthropic API key for AI-assisted classification reasoning | ErforderlichSecret |
| HSPING_API_KEY | HSPing API key for official tariff schedule access | ErforderlichSecret |
| API_KEY | — |
Automatisierte Checks
Geluften am 14. Nov. 2026Vollständiger Bericht →Unsere automatisierten Checks bestanden. Das ist kein Security-Audit: Lies den Code und gib dem Server nur den minimal notwendigen Zugriff. Wie die Checks funktionieren · Was du für mehr Punkte verbessern kannst
- Source Repository verknüpft und erreichbarojaskord/hs-code-classifier-mcp-server is public and reachablegithub.com/ojaskord/hs-code-classifier-mcp-server ↗Bestanden
- Paket nennt dieses Repository als QuelleNicht geprüft
- Build-Provenienz (Sigstore-Attestierung)No build attestation published for this releaseNicht geprüft
- Open Source Lizenz (OSI)MITspdx.org/licenses/MIT.html ↗Bestanden
- Commit oder Release im letzten JahrLast commit or release 2026-09-07github.com/ojaskord/hs-code-classifier-mcp-server ↗Bestanden
- OpenSSF ScorecardNicht geprüft
- Package-Name ähnelt keinem populären PackageNo popular package one edit away from hs-code-classifier-mcpBestanden
- Keine kritischen Advisories im Paket oder seinen Abhängigkeiten161 resolved dependencies checked; no critical advisoryosv.dev ↗Bestanden
- Keine versteckten Anweisungen an das Modell0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersBestanden
- Destruktive Tools sind markiertNicht geprüft
- Remote-Endpoint beantwortet den MCP-HandshakeEndpoint did not answer initialize: HTTP 404Befund
README
Auf GitHub ansehenHS 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 MCP Fragen
Wie füge ich HS Code Classifier MCP zu Claude Code hinzu?
Führe claude mcp add --env 'ANTHROPIC_API_KEY=<YOUR_ANTHROPIC_API_KEY>' --env 'HSPING_API_KEY=<YOUR_HSPING_API_KEY>' hs-code-classifier-mcp-server -- npx -y hs-code-classifier-mcp in deinem Terminal aus. Füge --scope user hinzu, damit der Server in jedem Projekt verfügbar ist.
Wie füge ich HS Code Classifier MCP zu Cursor hinzu?
Öffne ~/.cursor/mcp.json und füge den Server unter mcpServers hinzu, mit der Cursor-Config aus dem Installationsabschnitt oben.
Wie hoch ist das Limit des Free-Tiers?
Das Free-Tier erlaubt 10 Aufrufe pro Monat.
Welche Länder werden unterstützt?
Es werden die USA (USITC), Singapur (Singapore Customs), Kanada (CBSA), Australien (Australia Border Force) und weitere über die HSPing API unterstützt.
Kann ich Codes von Lieferanten validieren?
Ja, das Pro-Tier enthält ein Tool, um vom Lieferanten bereitgestellte HS-Codes zu validieren, um Unstimmigkeiten und Risiken durch Fehlklassifizierungen zu erkennen.