MCP server

Un Comtrade

io.github.cyanheads/un-comtrade-mcp-server

Checked 26 Oct 2026, 08:29 UTC · Connected to it and listed its tools

UN Comtrade international trade statistics via MCP. Country/HS lookups, flows, balances, rankings.

Working at last checkAbout 4,111 tokens per request once connected9 tools

Source

https://un-comtrade.caseyjhand.com/mcp

At a glance

Type: MCP server
Publisher: Not verified
Status: Working at last check
Tools: 9
Token cost: About 4,111 tokens per request
Sets up in: Claude Code, Claude Desktop, Codex, Gemini CLI, Cursor, VS Code, Antigravity, ChatGPT, OpenAI API, Grok
Last checked: 26 Oct 2026, 08:29 UTC

Connect it to your agent

Add to Cursor Add to VS Code VS Code Insiders

Opens the app, which shows the server and asks you to confirm. For other apps, copy the setup below.

Claude Code

claude mcp add --transport http un-comtrade-mcp-server https://un-comtrade.caseyjhand.com/mcp

Claude Desktop

Settings → Connectors → Add custom connector, and paste the URL.

Codex (config.toml)

[mcp_servers.un-comtrade-mcp-server]
url = "https://un-comtrade.caseyjhand.com/mcp"

Gemini CLI

{"mcpServers":{"un-comtrade-mcp-server":{"httpUrl":"https://un-comtrade.caseyjhand.com/mcp"}}}

Cursor

{"mcpServers":{"un-comtrade-mcp-server":{"url":"https://un-comtrade.caseyjhand.com/mcp"}}}

VS Code

{"servers":{"un-comtrade-mcp-server":{"type":"http","url":"https://un-comtrade.caseyjhand.com/mcp"}}}

Antigravity

agy mcp add un-comtrade-mcp-server https://un-comtrade.caseyjhand.com/mcp

ChatGPT

Settings → Apps & Connectors → Advanced settings: turn on Developer mode, then Create a connector and paste the URL. Which plans can do this varies.

OpenAI API (Responses tools)

{"type":"mcp","server_label":"un-comtrade-mcp-server","server_url":"https://un-comtrade.caseyjhand.com/mcp","require_approval":"always"}

Grok (xAI API tools)

{"type":"mcp","server_label":"un-comtrade-mcp-server","server_url":"https://un-comtrade.caseyjhand.com/mcp"}

Tools

comtrade_get_data_availability ~389 tokens
Check which reporter/period/classification combinations have published data before constructing expensive trade queries. Returns dataset records with period, classification, record count, and first/latest release dates. Call this before querying recent periods — annual data is typically published 3–
comtrade_get_services_trade ~465 tokens
Fetch international trade-in-services data (EBOPS 2010 classification). Same bilateral structure as goods trade: returns flow value in USD, period, and reporter/partner/category metadata for each row. Use comtrade_list_service_categories to find the right service code before querying. Preview makes
comtrade_get_top_commodities ~446 tokens
Rank commodity categories for a reporter by trade value for a given flow direction and period. Returns the top N HS chapters (2-digit) or headings (4-digit) sorted by descending value — answers "what does country X mainly export?" or "what does country X mainly import?". Symmetric counterpart to com
comtrade_get_top_partners ~384 tokens
Rank trading partners for a reporter by trade value for a given commodity and flow direction. Returns the top N partners sorted by descending value — answers "who does country X mainly export product Y to?" or "where does country X mainly import product Z from?" for a single period. Fetches a disagg
comtrade_get_trade_balance ~491 tokens
Compute the trade balance for a country over one or more periods — total exports minus total imports — with optional HS or SITC commodity filter. Preview makes two paced requests per served period; authenticated calls batch periods. Returns the signed balance (USD), export value, import value, and c
comtrade_get_trade_flows ~696 tokens
Fetch bilateral trade flow records — the primary data retrieval tool. Returns trade value in USD (primaryValue — FOB for exports, CIF for imports), quantity, net weight, and period/commodity/partner metadata for each row. Accepts multiple periods and commodity codes per call; pass partner_code 0 to
comtrade_list_service_categories ~314 tokens
List EBOPS 2010 service trade categories — the equivalent of comtrade_search_commodities for the services domain. Returns category codes, descriptions, and parent codes. Filter by keyword to find a specific service type (e.g. "transport", "financial", "travel"), or browse from a parent category code
comtrade_lookup_countries ~417 tokens
Resolve country and area names to Comtrade M49 numeric codes used in all data queries. Accepts a partial name, full name, or ISO alpha-2/alpha-3 code (e.g. "United States", "USA", "US"). Returns matching entries with their numeric code, ISO identifiers, and a validAsReporter flag — regional grouping
comtrade_search_commodities ~509 tokens
Find HS commodity codes by keyword, partial description, or known code prefix. Returns matched codes at the requested aggregation level (2-, 4-, or 6-digit) with full descriptions, parent code, leaf status, and a recommended_query_code field indicating the best code level for subsequent trade querie

Browse

Related MCP servers

Comtrade
Comtrade MCP — UN Comtrade API for international bilateral trade data
Fuze Data Tools
No-code web scraping & data-extraction Apify actors: scrape and enrich web data at scale.
Tollbooth
37 paid x402 MCP tools for OSINT, prediction markets, web intel, and agent security on Base USDC.
Brazil Comex Stat
Brazil Comex Stat MCP — Brazilian foreign trade statistics from MDIC (Ministério do…
Semi Data
US-government semiconductor & quantum supply-chain intelligence: controls, entities, funding.
Trade Intel
Trade Intel MCP — Compound tools that chain Comtrade, Census, Treasury,
Census Trade
Census Trade MCP — US Census Bureau International Trade data
Gapup
271 agent-payable tools: competitive intel, finance, KYC, compliance, ESG. x402 per-call.

Badge for your README

[![AptLynx](https://aptlynx.net/badge/io.github.cyanheads/un-comtrade-mcp-server.svg)](https://aptlynx.net/servers/io.github.cyanheads/un-comtrade-mcp-server)

Listing text is written by the maker; AptLynx lists tools and does not vouch for them. Find another tool · Browse by topic · For agents