OpenBtoB

HS code lookup in English, Vietnamese, Chinese and more, duty by route into the US, EU, China and Vietnam, sanctions screening, buyer search, with sources.

View on openbtob.com

Hosted MCP Server

npx add-mcp 'https://mcp.openbtob.com/mcp'

Installs into Claude Code, Codex, Cursor and more

Documentation

OpenBtoB MCP Server

Give your AI agent direct access to shipment records, buyer screening, and HS code and duty lookup. Every shipment answer cites its records and the date its data runs through.

Connection

Endpoint

https://mcp.openbtob.com/mcp

Transport

Streamable HTTP (JSON-RPC 2.0)

Auth

Bearer API key: create one in Settings after you sign up.

Rate limit

100 tool calls a day on a free account, counted per UTC day. Paid plans are not available yet.

Add to your client

Add this to claude_desktop_config.json, then restart Claude Desktop. It needs Node.js.

{
  "mcpServers": {
    "openbtob": {
      "command": "npx",
      "args": ["-y", "mcp-remote@latest", "https://mcp.openbtob.com/mcp", "--header", "Authorization:${AUTH_HEADER}"],
      "env": { "AUTH_HEADER": "Bearer YOUR_API_KEY" }
    }
  }
}

Other clients: an installer manifest is served at https://mcp.openbtob.com/mcp/installer.json. For opencode, with your key in the OPENBTOB_API_KEY environment variable:

{
  "mcp": {
    "openbtob": {
      "type": "remote",
      "url": "https://mcp.openbtob.com/mcp",
      "oauth": false,
      "headers": { "Authorization": "Bearer {env:OPENBTOB_API_KEY}" }
    }
  }
}

The 10 tools

Tool	What it does
### search_buyers	Find companies importing a product (buyers).
### search_suppliers	Find companies exporting a product (suppliers).
### get_company	Full company profile: overview, top products (HS code as stored with its digit level, HS6 code and description; a bill with no code finer than a chapter uses its heading inferred from the description, marked hs_basis 'inferred'), purchase rhythm, partners, ports, recent shipments.
### get_tariff_exposure	Tariff exposure of a company's US imports only: for its top 5 products by shipment count, per HS6 and origin, the US duty layers from the loaded US tariff.
### screen_buyer	Screen a company: exact-name sanctions check against the OFAC SDN, EU, UK and UN lists (never a model guess), a score computed from the company's shipment records, and risk signals from an AI model (an estimate). A "clear" sanctions status means no exact-name match on those lists, not a clearance.
### watch	Add a company, an HS code or a tariff line (a destination tariff line plus the origin of the goods, to follow its duty) to YOUR watchlist (max 50 items of all types).
### unwatch	Remove a company, HS code or tariff line from YOUR watchlist.
### get_watchlist	List YOUR tracked companies/HS codes/tariff lines with current activity.
### lookup_hs	Look up HS codes by product description or code prefix.
### export_data	Export search results as CSV.

Response contract

Every result includes citation (the shipment IDs it is based on), freshness (a “data through{month}” stamp), and a confidence score. Unknown values are null — never fabricated zeros: US manifests publish no dollar values, and the API says so instead of inventing numbers.

All response fields, errors and runnable examples: read the agent docs.