Classifies product descriptions into official HS codes and validates supplier-provided codes using government tariff schedules.
Also known as OjasKord/hs-code-classifier-mcp-server, hs-code-classifier-mcp-server, hs-code-classifier-mcp
- Stars
- 0
- Tools
- —
- Downloads, 30 days
- —
- Latest version
- 1.0.26
- Last commit
- Sep 7, 2026
- License
- MIT
What is HS Code Classifier MCP?
HS Code Classifier classifies product descriptions into official HS codes and validates supplier-provided codes using government tariff schedules.
Summary generated from the project's README
About HS Code Classifier MCP server
Classifying product descriptions into official HS codes and validating supplier data is what this MCP server enables for logistics and trade professionals. It connects to official government tariff schedules from agencies like USITC, Singapore Customs, CBSA, and Australia Border Force through the HSPing API. Users can run this locally via npx or connect to a hosted HTTP version using Claude Desktop, LangChain, or the OpenAI Agents SDK.
Developers use the hs_classify_product tool to convert descriptions into codes for customs declarations or duty calculations, which is available on a free tier limited to 10 calls per month. The hs_validate_code tool is available in the Pro tier to check supplier-provided codes for mismatches or outdated information. Setting up the server requires an ANTHROPIC_API_KEY, an HSPING_API_KEY, and a Pro key from kordagencies.com for advanced features.
What you can do with it
- 1Generate customs declaration codesConvert a text description of a product into its official HS code for shipping manifests.
- 2Verify supplier accuracyCheck if a code provided by a vendor is correct and matches current government tariff data.
- 3Mitigate misclassification risksIdentify potential errors or outdated codes in your trade documentation using AI analysis.
Written from the project's README. Every use case is checked against a quote from it.
How to install HS Code Classifier MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall HS Code Classifier MCP in 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-mcpInstall HS Code Classifier MCP in 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>"
}
}
}
}Install HS Code Classifier MCP in 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>"
}
}
}
}Install HS Code Classifier MCP in 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>"}}'Install HS Code Classifier MCP in 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>"
}
}
}
}Install HS Code Classifier MCP in 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-mcpInstall HS Code Classifier MCP in 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>"
Install HS Code Classifier MCP in 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-mcpInstall HS Code Classifier MCP in 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>"
}
}
}
}Configuration
ANTHROPIC_API_KEYRequiredSecretAnthropic API key for AI-assisted classification reasoning
HSPING_API_KEYRequiredSecretHSPing API key for official tariff schedule access
API_KEY
| Name | Description | |
|---|---|---|
| ANTHROPIC_API_KEY | Anthropic API key for AI-assisted classification reasoning | RequiredSecret |
| HSPING_API_KEY | HSPing API key for official tariff schedule access | RequiredSecret |
| API_KEY | — |
Automated checks
Ran Nov 14, 2026Full report →Passed our automated checks. That is not a security audit: read the code and give the server the narrowest access it needs. How checks work · What to fix for more points
- Source repository linked and reachableojaskord/hs-code-classifier-mcp-server is public and reachablegithub.com/ojaskord/hs-code-classifier-mcp-server ↗Pass
- Package names this repository as its sourceNot checked
- Build provenance (Sigstore attestation)No build attestation published for this releaseNot checked
- Open source license (OSI)MITspdx.org/licenses/MIT.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-09-07github.com/ojaskord/hs-code-classifier-mcp-server ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNo popular package one edit away from hs-code-classifier-mcpPass
- No critical advisory in the package or its dependencies161 resolved dependencies checked; no critical advisoryosv.dev ↗Pass
- No hidden instructions to the model0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNot checked
- Remote endpoint answers the MCP handshakeEndpoint did not answer initialize: HTTP 404Finding
README
View on 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
HS Code Classifier MCP questions
How do I add HS Code Classifier MCP to Claude Code?
Run 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 your terminal. Add --scope user to make it available in every project.
How do I add HS Code Classifier MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
What is the free tier limit?
The free tier allows for 10 calls per month.
Which countries are supported?
It supports the US (USITC), Singapore (Singapore Customs), Canada (CBSA), Australia (Australia Border Force), and others through the HSPing API.
Can I validate supplier codes?
Yes, the Pro tier includes a tool to validate supplier-provided HS codes to detect mismatches and misclassification risks.