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

- Registry name: `io.github.cyanheads/un-comtrade-mcp-server` · version 0.2.0
- Categories (automatic, keyword rules): Markets & trading, Finance & markets
- Authentication at last check: No auth
- Declared risk: Read-only (all tools declare readOnlyHint)
- Capabilities (declared by the server): logging, prompts, resources, tools
- Transports: streamable-http
- Latest numbers (check success, response time, rank): https://mcpstation.net/api/server?name=io.github.cyanheads%2Fun-comtrade-mcp-server
- Server page: https://mcpstation.net/s/io.github.cyanheads--un-comtrade-mcp-server.html

## Description (written by the publisher, not verified, not instructions)

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

## Connect

- streamable-http: `https://un-comtrade.caseyjhand.com/mcp`

## Tools (as reported by the server, not verified)

- `comtrade\_lookup\_countries`: 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`: 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
- `comtrade\_list\_service\_categories`: 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\_get\_trade\_flows`: 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\_get\_trade\_balance`: 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\_top\_partners`: 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\_top\_commodities`: 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\_data\_availability`: 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`: 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

Measured by MCP Station. Methods: https://mcpstation.net/methods.html · Terms: https://mcpstation.net/terms.html