comtrade_trade_data
ActiveTool of mcp-comtrade
declared in 0.1.0
AUTHORITATIVE bilateral trade data between two countries from UN Comtrade — the official international-trade statistics database (every country's customs filings, harmonized). Returns trade values USD, quantities, and HS commodity-level detail for imports and exports between reporter + partner. Use for "how much X did US import from China in 2024", "what does Germany export to Brazil", "Mexico's top trade partners by commodity". UN Comtrade reporter/partner codes (842=US — Comtrade uses 842, NOT the ISO 840; 156=China, 276=Germany, 0=World — see comtrade_country_codes). Annual data, lags ~3 months from reporting period.
Parameters schema
{
"type": "object",
"examples": [
{
"year": "2024",
"partner_code": "156",
"reporter_code": "842"
},
{
"flow": "M",
"year": "2023",
"hs_code": "8471",
"partner_code": "156",
"reporter_code": "842"
}
],
"required": [
"reporter_code",
"partner_code",
"year"
],
"properties": {
"flow": {
"type": "string",
"description": "Trade flow: \"M\" for imports, \"X\" for exports. Optional — defaults to both \"M,X\"."
},
"year": {
"type": "string",
"description": "Trade year (e.g., \"2024\")"
},
"hs_code": {
"type": "string",
"description": "HS commodity code at 2/4/6 digit level (e.g., \"8471\" for computers). Optional — omit for all commodities."
},
"partner_code": {
"type": "string",
"description": "ISO numeric country code for the partner country (e.g., \"156\" for China, \"0\" for World)"
},
"reporter_code": {
"type": "string",
"description": "ISO numeric country code for the reporting country (e.g., \"842\" for US, \"156\" for China)"
}
}
}No endpoints wrapped at confidence ≥ 0.50.
Parent server
mcp-comtrade
https://github.com/pipeworx-io/mcp-comtrade
2/7 registries