Skip to main content
MCP server CX Codex

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

Install into Claude Code · Platform CLI: remote server All methods and platforms ↓
claude mcp add --transport http imf-mcp-server https://imf-mcp-server--cyanheads.run.tools
Open on GitHub

What 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.tools

Step 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.

Similar MCP servers

All MCP servers for Data and databases →

Project sponsors

Companies that keep this analytics open