Meta Agent Tools
PT

Back to the catalog

HS Code Classifier

Classify products to official HS codes and validate supplier codes before customs submissions

Open source Repository Open in the app JSON README (API)

About

Classify products to official HS codes and validate supplier codes before customs submissions

Details

Kind
MCP servers
Topic
No topic detected
Publisher
ojaskord
Origin
official
Category
ferramentas
Transport
http
Version
1.0.26
Last push
2026-08-24T07:36:35Z
Repository state
ativo
Language
TypeScript
License
MIT
Added
2026-08-29 03:02:08
Updated
2026-08-29 03:02:08
Origin id
io.github.OjasKord/hs-code-classifier-mcp-server

README

[![smithery badge](https://smithery.ai/badge/OjasKord/hs-code-classifier-mcp-server)](https://smithery.ai/servers/OjasKord/hs-code-classifier-mcp-server)

# HS Code Classifier MCP Server

[![ToolRank](https://toolrank.dev/badge/dominant.svg)](https://toolrank.dev/ranking)

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)
```bash
npx hs-code-classifier-mcp
```

Configure in `claude_desktop_config.json`:
```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)
```json
{
  "mcpServers": {
    "hs-code-classifier": {
      "type": "http",
      "url": "https://hs-code-classifier-mcp-server-production.up.railway.app/mcp"
    }
  }
}
```

### LangChain (Python)
```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)
```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](https://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

More