# imf-mcp-server

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.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · 1492 installs · ★ 4 repo stars
- Author: cyanheads
- License: Apache-2.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/cyanheads/imf-mcp-server
- Updated: 2026-10-17
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/imf-mcp-server

## What it 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`.

## Requirements
- Remote server: `https://imf-mcp-server--cyanheads.run.tools`

## Install

### Claude Code (native platform)

**Platform CLI: remote server**
```bash
claude mcp add --transport http imf-mcp-server https://imf-mcp-server--cyanheads.run.tools
```

### Codex

**Platform CLI: remote server**
```bash
codex mcp add imf-mcp-server --url https://imf-mcp-server--cyanheads.run.tools
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "imf-mcp-server": {
            "url": "https://imf-mcp-server--cyanheads.run.tools"
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "imf-mcp-server": {
            "type": "http",
            "url": "https://imf-mcp-server--cyanheads.run.tools"
        }
    }
}
```

### Gemini CLI

**Platform CLI: remote server**
```bash
gemini mcp add -t http imf-mcp-server https://imf-mcp-server--cyanheads.run.tools
```

## When to use it
- 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
- 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`

## Similar
- [treasury-fiscaldata-mcp-server](https://affpapa.org/en/nevibecode/mcp/treasury-fiscaldata-mcp-server.md) — MCP server · 947 installs
- [data-analysis](https://affpapa.org/en/nevibecode/skills/bytedance-data-analysis.md) — skill · 3700 installs
- [query](https://affpapa.org/en/nevibecode/skills/query.md) — skill · 1600 installs
- [attach-db](https://affpapa.org/en/nevibecode/skills/attach-db.md) — skill · 1200 installs
- [firetiger](https://affpapa.org/en/nevibecode/skills/firetiger.md) — skill · 827 installs
- [playwright-test-results](https://affpapa.org/en/nevibecode/skills/playwright-test-results.md) — skill · 521 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
