# Imf MCP Server

> Imf MCP Server is an open-source MCP server for analytics and data. Query IMF macroeconomic data for 190 countries, with SQL over large results. It can run locally on your machine or as a hosted remote server.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, API, self-hosted
- **Repository:** https://github.com/cyanheads/imf-mcp-server
- **MCP Registry name:** io.github.cyanheads/imf-mcp-server
- **Categories:** [analytics and data](https://ai-powered.com/categories/analytics-and-data), [finance and payments](https://ai-powered.com/categories/finance-and-payments)
- **Listing updated:** 2026-11-18

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http imf-mcp-server https://imf.caseyjhand.com/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://imf.caseyjhand.com/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "imf-mcp-server": {
      "url": "https://imf.caseyjhand.com/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "imf-mcp-server": {
      "type": "http",
      "url": "https://imf.caseyjhand.com/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "imf-mcp-server": {
      "serverUrl": "https://imf.caseyjhand.com/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "imf-mcp-server": {
      "type": "http",
      "url": "https://imf.caseyjhand.com/mcp"
    }
  }
}
```

## Tools

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

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

## Alternatives

- [Agent-Native Analytics](https://ai-powered.com/mcp/agent-native-analytics): Agent-Native Analytics is an open-source MCP server for analytics and data.
- [Google Ads + Meta Ads + SEO/GEO MCP](https://ai-powered.com/mcp/google-ads-meta-ads-seo-geo-mcp): Google Ads + Meta Ads + SEO/GEO MCP is a freemium MCP server for marketing and seo.
- [dashboard-icons](https://ai-powered.com/mcp/dashboard-icons): dashboard-icons is an open-source MCP server for analytics and data.
- [Solana MCP by Vybe](https://ai-powered.com/mcp/solana-mcp-by-vybe): Solana MCP by Vybe is an MCP server for finance and payments.
- [Tapetide - Indian Stock Market MCP](https://ai-powered.com/mcp/tapetide-indian-stock-market-mcp): Tapetide - Indian Stock Market MCP is a freemium MCP server for finance and payments.
- [World Monitor](https://ai-powered.com/mcp/world-monitor): World Monitor is a freemium MCP server for analytics and data.
- [Budget Tracker](https://ai-powered.com/mcp/budget-tracker-2): Budget Tracker is a freemium MCP server for finance and payments.
- [DataArcus for Power BI](https://ai-powered.com/mcp/dataarcus-for-power-bi): DataArcus for Power BI is a free MCP server for analytics and data.

---
Source: https://ai-powered.com/mcp/imf-mcp-server
