Imf MCP Server
Query IMF macroeconomic data for 190 countries, with SQL over large results
- Pricing
- Open source
- Platforms
- CLI, API, self-hosted
- Runs
- Locally or Remotely
- Version
- 0.6.0
- Listing updated
- today
Similar MCP servers
About Imf MCP Server
Imf MCP Server is an open-source MCP server for analytics and data. It can run locally on your machine or as a hosted remote server.
The IMF server talks to the public IMF SDMX 3.0 portal without an API key. It covers 100+ dataflows, including World Economic Outlook projections, balance of payments, CPI, exchange rates and national accounts. A typical flow is to list dataflows, fetch one to see its dimensions and codelists (countries use ISO 3-letter codes such as USA), then query it with a dot-separated key and a time range.
Large multi-country or long-range results do not have to be pasted into the chat. With DataCanvas, they are staged into DuckDB tables, and two further tools describe those tables and run read-only SQL SELECT queries over them. A drop tool for removing staged tables exists but is off unless IMF_ENABLE_DATAFRAME_DROP is set.
The typed client checks the key's dimension count before each query and returns observation status flags for data-quality caveats. A bundled imf-guide skill explains how to route a macro question to the right dataflow without mixing projections, group aggregates or currency units. It runs over stdio or HTTP, and a public hosted endpoint is listed.
Install
Run in a terminal
claude mcp add --transport http imf-mcp-server https://imf.caseyjhand.com/mcpAdd to Settings → Connectors → Add custom connector
https://imf.caseyjhand.com/mcpAdd to ~/.cursor/mcp.json
{
"mcpServers": {
"imf-mcp-server": {
"url": "https://imf.caseyjhand.com/mcp"
}
}
}Add to .vscode/mcp.json
{
"servers": {
"imf-mcp-server": {
"type": "http",
"url": "https://imf.caseyjhand.com/mcp"
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"imf-mcp-server": {
"serverUrl": "https://imf.caseyjhand.com/mcp"
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"imf-mcp-server": {
"type": "http",
"url": "https://imf.caseyjhand.com/mcp"
}
}
}Using several servers? Build one config file with the MCP config generator.
Configuration
IMF_ENABLE_DATAFRAME_DROPEnable imf_dataframe_drop for removing staged DataCanvas tables and views.MCP_LOG_LEVELSets the minimum log level for output (e.g., 'debug', 'info', 'warn').MCP_TRANSPORT_TYPESelects the HTTP transport.IMF_ENABLE_DATAFRAME_DROPEnable imf_dataframe_drop for removing staged DataCanvas tables and views.MCP_HTTP_HOSTThe hostname for the HTTP server.MCP_HTTP_PORTThe port to run the HTTP server on.MCP_HTTP_ENDPOINT_PATHThe endpoint path for the MCP server.MCP_AUTH_MODEAuthentication mode to use: 'none', 'jwt', or 'oauth'.MCP_LOG_LEVELSets the minimum log level for output (e.g., 'debug', 'info', 'warn').
Tools this server provides (6)
Taken from the project documentation; the running server may differ.
- imf_list_databases
- Lists IMF SDMX dataflows.
- imf_get_database
- Fetches a dataflow's dimensions and codelists.
- imf_query_dataset
- Queries a dataflow by key over a time range.
- imf_dataframe_describe
- Lists staged DataCanvas tables and columns.
- imf_dataframe_query
- Runs a read-only SQL SELECT on staged tables.
- imf_dataframe_drop
- Removes a staged table or view; disabled by default.
What it does
- Dataflow catalogue
- List and filter 100+ IMF dataflows.
- Code resolution
- Look up dimensions and codelists to build valid keys.
- Time-series queries
- Query by key, period range or last N observations.
- SQL over results
- DuckDB-backed staging for large queries.
- Status flags
- Observations carry data-quality status codes.
- Keyless access
- Uses the public IMF portal with no API key.
Good for
- Compare inflation across countries over several years
- Pull World Economic Outlook projections for a country
- Track exchange rates or balance of payments series
- Run SQL aggregations over multi-country results
Pricing
Open source
Imf MCP Server FAQ
Do I need an API key?
No. The README says it uses the public IMF SDMX 3.0 portal without a key.
How are big results handled?
With DataCanvas they are staged as tables and queried with read-only SQL.
Why use USA instead of US?
Countries are ISO 3-letter codes in the IMF dataflows.
Is there a hosted instance?
Yes, a public endpoint at imf.caseyjhand.com/mcp is listed.
Is Imf MCP Server free?
Yes. Imf MCP Server is open source, so you can use and self-host it for free.
How do I add Imf MCP Server to Claude Code?
Run this command in your terminal: claude mcp add --transport http imf-mcp-server https://imf.caseyjhand.com/mcp
What are the best alternatives to Imf MCP Server?
The closest alternatives to Imf MCP Server are Agent-Native Analytics, Google Ads + Meta Ads + SEO/GEO MCP, dashboard-icons, Solana MCP by Vybe and Tapetide - Indian Stock Market MCP.
Where this comes from
- Description: written from the project's README.
- Install steps: from the official MCP Registry entry.


