imf-mcp-server — Claude Code MCP server: what it does, how to install
MCP server for querying IMF SDMX 3.0 macroeconomic data across 190 countries. Connects agents to WEO projections, CPI, and exchange rates without an API key.
Apache-2.0 1,492 installs ★ 4 updated 2026-10-17
claude mcp add --transport http imf-mcp-server https://imf-mcp-server--cyanheads.run.toolsWhat imf-mcp-server does
This server brings International Monetary Fund statistics directly into your coding agent. You can inspect dataflows covering balance of payments, consumer price indexes, exchange rates, and national accounts. The toolset starts by discovering dataflows via imf_list_databases and inspecting dimension codelists using imf_get_database, which expects standard 3-letter ISO country codes.
Data retrieval runs through imf_query_dataset with dot-separated dimension keys. Responses fit within a 100,000-character budget. Whenever a query exceeds this limit, rows spill into DataCanvas storage, where you can inspect schema types and run read-only DuckDB SQL queries via imf_dataframe_query.
External access requires no credentials or API tokens. Upstream IMF outages or rate limits are handled through automatic retries within a 45-second call budget. Note that dataframe tools remain disabled when CANVAS_PROVIDER_TYPE=none.
What it helps with
- pull World Economic Outlook projections and exchange rates
- resolve macroeconomic dimension codes and ISO country identifiers
- query multi-country historical time series within specified dates
- execute SQL queries over large staged datasets using DuckDB
Example prompts for the agent
- Search for available inflation datasets using
imf_list_databases - Check dimension codes and format for WEO with
imf_get_database - Query annual GDP series for USA and DEU via
imf_query_dataset
How to install imf-mcp-server
Platform CLI: remote server
claude mcp add --transport http imf-mcp-server https://imf-mcp-server--cyanheads.run.toolsPlatform CLI: remote server
codex mcp add imf-mcp-server --url https://imf-mcp-server--cyanheads.run.toolsConfig file
{
"mcpServers": {
"imf-mcp-server": {
"url": "https://imf-mcp-server--cyanheads.run.tools"
}
}
}Config file
{
"servers": {
"imf-mcp-server": {
"type": "http",
"url": "https://imf-mcp-server--cyanheads.run.tools"
}
}
}Platform CLI: remote server
gemini mcp add -t http imf-mcp-server https://imf-mcp-server--cyanheads.run.toolsStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about imf-mcp-server
How do I install imf-mcp-server in Claude Code?
Run the command claude mcp add --transport http imf-mcp-server https://imf-mcp-server--cyanheads.run.tools.
Is an API key required to access IMF data?
No API key or token is needed. The server connects directly to IMF public SDMX endpoints.
How does the server handle large query responses?
Payloads exceeding 100,000 characters are staged into DataCanvas tables. You can then inspect columns with imf_dataframe_describe and run read-only SQL queries with imf_dataframe_query.