OpenBtoB

HS 코드 조회(영어, 베트남어, 중국어 등), 미국·EU·중국·베트남으로의 경로별 관세, 제재 스크리닝, 바이어 검색, 출처 포함.

openbtob.com에서 보기

호스팅형 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

ToolWhat it does
### search_buyersFind companies importing a product (buyers).
### search_suppliersFind companies exporting a product (suppliers).
### get_companyFull 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_exposureTariff 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_buyerScreen 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.
### watchAdd 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).
### unwatchRemove a company, HS code or tariff line from YOUR watchlist.
### get_watchlistList YOUR tracked companies/HS codes/tariff lines with current activity.
### lookup_hsLook up HS codes by product description or code prefix.
### export_dataExport 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.