Skip to content
MCP server

Imf MCP Server

Query IMF macroeconomic data for 190 countries, with SQL over large results

Install
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/mcp

Add to Settings → Connectors → Add custom connector

https://imf.caseyjhand.com/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "imf-mcp-server": {
      "url": "https://imf.caseyjhand.com/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

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.

How AIPoweredBot checks servers