# HS Code Classifier

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

- **Type:** MCP server
- **Install:** `agentstack add mcp-ojaskord-hs-code-classifier-mcp-server`
- **Verified:** Pending review
- **Seller:** [OjasKord](https://agentstack.voostack.com/s/ojaskord)
- **Installs:** 0
- **Latest version:** 1.0.0
- **License:** MIT
- **Upstream author:** [OjasKord](https://github.com/OjasKord)
- **Source:** https://github.com/OjasKord/hs-code-classifier-mcp-server
- **Website:** https://kordagencies.com/

## Install

```sh
agentstack add mcp-ojaskord-hs-code-classifier-mcp-server
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

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

# HS Code Classifier MCP Server

[](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

## Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [OjasKord](https://github.com/OjasKord)
- **Source:** [OjasKord/hs-code-classifier-mcp-server](https://github.com/OjasKord/hs-code-classifier-mcp-server)
- **License:** MIT
- **Homepage:** https://kordagencies.com/

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Versions

- **1.0.0** — security scan: pending review — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-ojaskord-hs-code-classifier-mcp-server
- Seller: https://agentstack.voostack.com/s/ojaskord
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.