HS Code Classifier

Name: HS Code Classifier
Author: OjasKord

OjasKord

Classify products to official HS codes and validate supplier codes before customs submissions. Uses USITC, Singapore Customs, CBSA, AU Border Force via HSPing API with AI reasoning.

Setup

Choose your client, copy the config, then fill in any required environment variables.

Add to Cursor Add to VS Code

Local

claude mcp add hs-code-classifier --env ANTHROPIC_API_KEY='<ANTHROPIC_API_KEY>' --env HSPING_API_KEY='<HSPING_API_KEY>' -- npx -y hs-code-classifier-mcp

~/.codex/config.toml

[mcp_servers.hs-code-classifier]
command = "npx"
args = ["-y", "hs-code-classifier-mcp"]
env = { ANTHROPIC_API_KEY = "<ANTHROPIC_API_KEY>", HSPING_API_KEY = "<HSPING_API_KEY>" }

# codex mcp add hs-code-classifier --env ANTHROPIC_API_KEY='<ANTHROPIC_API_KEY>' --env HSPING_API_KEY='<HSPING_API_KEY>' -- npx -y hs-code-classifier-mcp

~/.cursor/mcp.json

{
  "mcpServers": {
    "hs-code-classifier": {
      "command": "npx",
      "args": [
        "-y",
        "hs-code-classifier-mcp"
      ],
      "env": {
        "ANTHROPIC_API_KEY": "<ANTHROPIC_API_KEY>",
        "HSPING_API_KEY": "<HSPING_API_KEY>"
      }
    }
  }
}

.vscode/mcp.json

{
  "servers": {
    "hs-code-classifier": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "hs-code-classifier-mcp"
      ],
      "env": {
        "ANTHROPIC_API_KEY": "<ANTHROPIC_API_KEY>",
        "HSPING_API_KEY": "<HSPING_API_KEY>"
      }
    }
  }
}

~/.gemini/settings.json

{
  "mcpServers": {
    "hs-code-classifier": {
      "command": "npx",
      "args": [
        "-y",
        "hs-code-classifier-mcp"
      ],
      "env": {
        "ANTHROPIC_API_KEY": "<ANTHROPIC_API_KEY>",
        "HSPING_API_KEY": "<HSPING_API_KEY>"
      }
    }
  }
}

claude_desktop_config.json

{
  "mcpServers": {
    "hs-code-classifier": {
      "command": "npx",
      "args": [
        "-y",
        "hs-code-classifier-mcp"
      ],
      "env": {
        "ANTHROPIC_API_KEY": "<ANTHROPIC_API_KEY>",
        "HSPING_API_KEY": "<HSPING_API_KEY>"
      }
    }
  }
}

.trae/mcp.json

{
  "mcpServers": {
    "hs-code-classifier": {
      "command": "npx",
      "args": [
        "-y",
        "hs-code-classifier-mcp"
      ],
      "env": {
        "ANTHROPIC_API_KEY": "<ANTHROPIC_API_KEY>",
        "HSPING_API_KEY": "<HSPING_API_KEY>"
      }
    }
  }
}

Remote

claude mcp add --transport http hs-code-classifier https://hs-code-classifier-mcp-server-production.up.railway.app

~/.codex/config.toml

[mcp_servers.hs-code-classifier]
url = "https://hs-code-classifier-mcp-server-production.up.railway.app"

# codex mcp add hs-code-classifier --url https://hs-code-classifier-mcp-server-production.up.railway.app

~/.cursor/mcp.json

{
  "mcpServers": {
    "hs-code-classifier": {
      "url": "https://hs-code-classifier-mcp-server-production.up.railway.app"
    }
  }
}

.vscode/mcp.json

{
  "servers": {
    "hs-code-classifier": {
      "type": "http",
      "url": "https://hs-code-classifier-mcp-server-production.up.railway.app"
    }
  }
}

~/.gemini/settings.json

{
  "mcpServers": {
    "hs-code-classifier": {
      "httpUrl": "https://hs-code-classifier-mcp-server-production.up.railway.app"
    }
  }
}

claude_desktop_config.json · Customize › Connectors › Add custom connector

{
  "mcpServers": {
    "hs-code-classifier": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://hs-code-classifier-mcp-server-production.up.railway.app"
      ]
    }
  }
}

.trae/mcp.json

{
  "mcpServers": {
    "hs-code-classifier": {
      "url": "https://hs-code-classifier-mcp-server-production.up.railway.app"
    }
  }
}

Environment variables

ANTHROPIC_API_KEY
HSPING_API_KEY

Replace the placeholders with your own credentials and keep them out of version control.

Setup

Local

Remote

Environment variables

Related