Clasifica descripciones de productos en códigos HS oficiales y valida los códigos proporcionados por proveedores utilizando los aranceles gubernamentales.
También conocido como OjasKord/hs-code-classifier-mcp-server, hs-code-classifier-mcp-server, hs-code-classifier-mcp
- Stars
- 0
- Herramientas
- —
- Descargas, 30 días
- —
- Última versión
- 1.0.26
- Último commit
- 7 sept 2026
- Licencia
- MIT
¿Qué es HS Code Classifier MCP?
Clasifica descripciones de productos en códigos HS oficiales y valida los códigos proporcionados por proveedores utilizando los aranceles gubernamentales.
Resumen generado a partir del README del proyecto
Acerca del MCP server de HS Code Classifier
Clasificar descripciones de productos en códigos HS oficiales y validar los datos de los proveedores es lo que este MCP server permite a los profesionales de logística y comercio. Se conecta a los aranceles gubernamentales oficiales de agencias como USITC, Singapore Customs, CBSA y Australia Border Force a través de la API de HSPing. Los usuarios pueden ejecutarlo localmente mediante npx o conectarse a una versión HTTP alojada usando Claude Desktop, LangChain o el OpenAI Agents SDK.
Los desarrolladores utilizan la herramienta hs_classify_product para convertir descripciones en códigos para declaraciones de aduana o cálculos de aranceles, la cual está disponible en un nivel gratuito limitado a 10 llamadas por mes. La herramienta hs_validate_code está disponible en el nivel Pro para verificar si los códigos proporcionados por proveedores tienen discrepancias o información desactualizada. Configurar el servidor requiere una ANTHROPIC_API_KEY, una HSPING_API_KEY y una clave Pro de kordagencies.com para funciones avanzadas.
Qué puedes hacer con él
- 1Generar códigos para declaraciones de aduanaConvierte una descripción de texto de un producto en su código HS oficial para manifiestos de envío.
- 2Verificar la precisión del proveedorComprueba si un código proporcionado por un vendedor es correcto y coincide con los datos arancelarios gubernamentales actuales.
- 3Mitigar riesgos de clasificación incorrectaIdentifica posibles errores o códigos desactualizados en tu documentación comercial mediante análisis de IA.
Escrito a partir del README del proyecto. Cada caso de uso se verifica con una cita del mismo.
Cómo instalar HS Code Classifier MCP
Formatos verificados el 10 nov 2026Añadir a CursorAñadir a GooseInstalar HS Code Classifier MCP en Claude Code
$ 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-mcpInstalar HS Code Classifier MCP en Cursor
~/.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>"
}
}
}
}Instalar HS Code Classifier MCP en VS Code
.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>"
}
}
}
}Instalar HS Code Classifier MCP en VS Code CLI
$ 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>"}}'Instalar HS Code Classifier MCP en Claude Desktop
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>"
}
}
}
}Instalar HS Code Classifier MCP en Codex
$ 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-mcpInstalar HS Code Classifier MCP en Codex config.toml
~/.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>"
Instalar HS Code Classifier MCP en Gemini CLI
$ 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-mcpInstalar HS Code Classifier MCP en Gemini settings.json
~/.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>"
}
}
}
}Configuración
ANTHROPIC_API_KEYObligatorioSecretoAnthropic API key for AI-assisted classification reasoning
HSPING_API_KEYObligatorioSecretoHSPing API key for official tariff schedule access
API_KEY
| Nombre | Descripción | Tipo |
|---|---|---|
| ANTHROPIC_API_KEY | Anthropic API key for AI-assisted classification reasoning | ObligatorioSecreto |
| HSPING_API_KEY | HSPing API key for official tariff schedule access | ObligatorioSecreto |
| API_KEY | — |
Verificaciones automáticas
Ejecutado 14 nov 2026Informe completo →Pasó nuestras verificaciones automáticas. Esto no es una auditoría de seguridad: lee el código y dale al servidor el acceso más limitado que necesite. Cómo funcionan las verificaciones · Qué corregir para obtener más puntos
- Repositorio de origen vinculado y accesibleojaskord/hs-code-classifier-mcp-server is public and reachablegithub.com/ojaskord/hs-code-classifier-mcp-server ↗Aprobado
- El paquete indica este repositorio como su origenNo verificado
- Procedencia de la compilación (atestación de Sigstore)No build attestation published for this releaseNo verificado
- Licencia de código abierto (OSI)MITspdx.org/licenses/MIT.html ↗Aprobado
- Commit o lanzamiento en el último añoLast commit or release 2026-09-07github.com/ojaskord/hs-code-classifier-mcp-server ↗Aprobado
- OpenSSF ScorecardNo verificado
- El nombre del paquete no es similar a un paquete popularNo popular package one edit away from hs-code-classifier-mcpAprobado
- No hay avisos críticos en el paquete ni en sus dependencias161 resolved dependencies checked; no critical advisoryosv.dev ↗Aprobado
- Sin instrucciones ocultas para el modelo0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersAprobado
- Las herramientas destructivas están etiquetadasNo verificado
- El endpoint remoto responde al handshake de MCPEndpoint did not answer initialize: HTTP 404Hallazgo
README
Ver en GitHubHS 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
Preguntas sobre HS Code Classifier MCP
¿Cómo agrego HS Code Classifier MCP a Claude Code?
Ejecuta 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 en tu terminal. Añade --scope user para que esté disponible en todos los proyectos.
¿Cómo agrego HS Code Classifier MCP a Cursor?
Abre ~/.cursor/mcp.json y añade el servidor en mcpServers, usando la configuración de Cursor que se muestra en la sección de instalación de arriba.
¿Cuál es el límite del nivel gratuito?
El nivel gratuito permite 10 llamadas al mes.
¿Qué países están soportados?
Soporta EE. UU. (USITC), Singapur (Singapore Customs), Canadá (CBSA), Australia (Australia Border Force) y otros a través de la API de HSPing.
¿Puedo validar códigos de proveedores?
Sí, el nivel Pro incluye una herramienta para validar los códigos HS proporcionados por proveedores para detectar discrepancias y riesgos de clasificación incorrecta.