OpenBtoB

HS編碼查詢，支援英文、越南文、中文及更多語言，按路線查詢進入美國、歐盟、中國和越南的關稅，制裁篩查，買家搜尋，附來源。

託管 MCP 伺服器

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

可安裝到 Claude Code、Codex、Cursor 等客戶端

文件

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.