mcpbeat

Imf MCP Server

io.github.cyanheads/imf-mcp-server
answering

Imf MCP Server is answering right now. Last checked 3 min ago. 52 installs a week from npm. It exposes 5 tools. Last commit 11 Jul 2026.

Query IMF SDMX 3.0 macroeconomic dataflows — WEO, BOP, CPI, exchange rates, 190 countries.

Installs per day peak 381 · avg 24 · -32% w/w
a month agotoday
Uptime history 39 hours of history · worst hour 75%
39 hours agonow
100.0%
Uptime 24h
91 of 91 checks
5
Tools
read from the server
393 ms
Response time
average over 24h
52
Installs / week
npm and PyPI

Connect this server

Endpoint below is the one we actually reach during checks — not the one copied from a README. Last verified 3 min ago.

run in your terminal
claude mcp add imf-mcp-server --transport http https://imf.caseyjhand.com/mcp
~/Library/Application Support/Claude/claude_desktop_config.json
{
  "mcpServers": {
    "imf-mcp-server": {
      "url": "https://imf.caseyjhand.com/mcp"
    }
  }
}
~/.codex/config.toml
[mcp_servers.imf-mcp-server]
url = "https://imf.caseyjhand.com/mcp"
.cursor/mcp.json
{
  "mcpServers": {
    "imf-mcp-server": {
      "url": "https://imf.caseyjhand.com/mcp"
    }
  }
}
.vscode/mcp.json
{
  "mcpServers": {
    "imf-mcp-server": {
      "url": "https://imf.caseyjhand.com/mcp"
    }
  }
}

Available tools 5

Read directly from the server with tools/list, grouped by what they act on. If a tool disappears, we record the date.

imf
imf_dataframe_describe
List DataCanvas tables and columns staged by a prior imf_query_dataset call. Returns each table's name, row count, and column schema (name + DuckDB type). Required before imf_dataframe_query to discover the table and column names for SQL.
imf_dataframe_query
Run a read-only SQL SELECT against a DataCanvas table staged by imf_query_dataset. Supports multi-country comparisons, time-series aggregation, and cross-indicator joins. Requires imf_dataframe_describe first to discover table and column names. Only SELECT statements are accepted — DML and DDL are rejected.
imf_get_database
Fetch a dataflow's dimension list and complete codelist for each dimension. Resolves human-readable terms to SDMX codes (e.g. "United States" → USA, "real GDP growth" → NGDP_RPCH). Required before imf_query_dataset — SDMX keys are opaque without codelist lookups. Country codes are ISO 3-letter (USA, GBR, DEU), not ISO 2-letter (US, GB, DE). The key_format field shows the exact dimension order required by imf_query_dataset. Note: codelists enumerate the code universe, not actual coverage — valid codes can still return no_data if the combination has no series in this dataflow.
imf_list_databases
List IMF SDMX dataflows available on the portal. Entry point for every query: imf_get_database and imf_query_dataset both require a dataflow id obtained here. Vintage (historical snapshot) dataflows such as WEO_2025_OCT_VINTAGE are excluded by default; set include_vintages=true to include them. The returned total_count reflects the current live catalog size.
imf_query_dataset
Query an IMF SDMX dataflow by dimension key over a time range. Returns observations with time_period, value, unit, scale, and status attributes. Requires imf_get_database first to obtain the correct key_format and valid dimension codes. Country codes are ISO 3-letter (USA, GBR, DEU — not US, GB, DE). Key format: dot-separated codes in DSD keyPosition order (e.g. USA.NGDP_RPCH.A for WEO). Use + to specify multiple codes per position (e.g. USA+GBR.NGDP_RPCH.A). Codelists from imf_get_database enumerate the code universe, not actual coverage — valid codes can still return no_data if the combination has no series. start_period and end_period must be valid period strings (YYYY, YYYY-QN, or YYYY-MM) with start_period no later than end_period; malformed or reversed ranges are rejected. Large analytical result sets (multi-country, long time range) spill to DataCanvas; imf_dataframe_query provides SQL analysis of spilled results.

Endpoints

URLTransportStateLatencyChecked
https://imf.caseyjhand.com/mcp streamable-http answering 379 ms 3 min ago

Imf MCP Server — questions

Answers built from our own checks of this server.

What can Imf MCP Server do?
It exposes 5 tools, read directly from the server on our last check. Among them: imf_dataframe_describe, imf_dataframe_query, imf_get_database, imf_list_databases, imf_query_dataset. The full list with descriptions is on this page — we take it from the server itself via tools/list, not from a README. How MCP servers expose tools in the first place →
Is Imf MCP Server working right now?
We send a real MCP handshake every 15 minutes. Over the last 24 hours 91 of 91 checks got a reply (100.0%), average response time 393 ms. The bar chart above shows every period we have measured.
How do I connect Imf MCP Server?
Copy the ready config from this page — we generate it for Claude Code, Claude Desktop, Codex, Cursor and VS Code, each with the file path that client actually reads. It is a remote server, so there is nothing to install — the client connects to the address.
Does Imf MCP Server need an API key?
No. Imf MCP Server completed a full MCP handshake with us as an anonymous client and listed its tools without asking for anything. All 5 of them are readable on this page. This is what we observed, not what the docs claim.
How fast is Imf MCP Server?
It answers our handshake in 393 ms on average, which is faster than 34% of all working MCP servers we measure. The comparison comes from our own checks across the whole registry, every 15 minutes.
How many people use Imf MCP Server?
The npm package @cyanheads/imf-mcp-server was installed 52 times in the last week. Week over week that is -32%. We show installs rather than GitHub stars on purpose: a star is a bookmark, an install is someone actually running it.
Is Imf MCP Server open source?
Yes — it is published under the Apache-2.0 licence, written in TypeScript, 1 stars on GitHub and 15 open issues. The source link is on this page, so you can read exactly what it does with your data before you connect it.