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

Official

by cyanheads · TypeScript

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

Query UN Comtrade international trade statistics with country and commodity lookups.

Topics

ai-agentsai-toolscommoditiescomtradecyanheadsexportshs-codesimportsinternational-trademcpmcp-servermodel-context-protocoltradetypescriptunited-nationstrade-statistics

Install

Configuration

Environment variables

COMTRADE_SUBSCRIPTION_KEY

Azure API Management key from comtradedeveloper.un.org. Optional — without it, tools fall back to the public preview endpoint (500-record cap).

MCP_LOG_LEVELdefault info

Sets the minimum log level for output (e.g., 'debug', 'info', 'warn').

MCP_HTTP_HOSTdefault 127.0.0.1

The hostname for the HTTP server.

MCP_HTTP_PORTdefault 3010

The port to run the HTTP server on.

MCP_HTTP_ENDPOINT_PATHdefault /mcp

The endpoint path for the MCP server.

MCP_AUTH_MODEdefault none

Authentication mode to use: 'none', 'jwt', or 'oauth'.

claude_desktop_config.json

{
  "mcpServers": {
    "un-comtrade-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@cyanheads/un-comtrade-mcp-server@0.1.5",
        "run",
        "start:stdio"
      ],
      "env": {
        "COMTRADE_SUBSCRIPTION_KEY": "<YOUR_COMTRADE_SUBSCRIPTION_KEY>",
        "MCP_LOG_LEVEL": "info"
      }
    }
  }
}