IMF Data

by c-cf

1 stars

329 downloads

Not rated

GitHub

About

Provides structured access to International Monetary Fund datasets, enabling retrieval of economic indicators and financial statistics for research and analysis workflows.

Details

Author: c-cf
Repository: c-cf/imf-data-mcp
GitHub stars: 1
Downloads: 329
License: Apache License 2.0
Categories: Database, Other, Finance, API, Productivity, Developer Tools, Design, AI, Search, Security, Infrastructure, Frontend

- Lists all ~155 IMF databases with IDs.
- Searches databases by keyword (e.g., inflation, trade).
- Fetches time series data with year range and dimension filters.
- Handles IMF API rate limits automatically.
- Uses the current data.imf.org SDMX 3.0 API.
- Compatible with Claude Desktop and other MCP clients.

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

Download and install Highlight from highlightai.com/download
Navigate to the plugins tab and select "Add Custom Plugin"
Configure the plugin with the settings below
Plugin Name IMF Data

Command (node, npx, python, etc.) uvx
Arguments
- Argument 1 --from
- Argument 2 git+https://github.com/c-cf/imf-data-mcp
- Argument 3 imf-data-mcp
Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
Enable "Start Automatically" if you want the plugin to start when Highlight launches

Setting up with Cursor

Open Cursor's settings
Navigate to the MCP section
Click "Add new Global MCP server"
Copy and paste the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "imf data": {
            "env": {},
            "args": [
                "--from",
                "git+https://github.com/c-cf/imf-data-mcp",
                "imf-data-mcp"
            ],
            "shell": false,
            "command": "uvx"
        }
    }
}

JSON

{
    "mcpServers": {
        "imf data": {
            "env": {},
            "args": [
                "--from",
                "git+https://github.com/c-cf/imf-data-mcp",
                "imf-data-mcp"
            ],
            "shell": false,
            "command": "uvx"
        }
    }
}

JSON

{
    "mcpServers": {
        "imf data": {
            "env": {},
            "args": [
                "--from",
                "git+https://github.com/c-cf/imf-data-mcp",
                "imf-data-mcp"
            ],
            "shell": false,
            "command": "uvx"
        }
    }
}

Setting up with Claude Desktop

Open Claude Desktop's settings
Go to the Integrations tab
Click "Add MCP Server"
Use the configuration below based on your operating system

Note: Make sure Claude Desktop is running before attempting to connect.

JSON

{
    "mcpServers": {
        "imf data": {
            "env": {},
            "args": [
                "--from",
                "git+https://github.com/c-cf/imf-data-mcp",
                "imf-data-mcp"
            ],
            "shell": false,
            "command": "uvx"
        }
    }
}

JSON

{
    "mcpServers": {
        "imf data": {
            "env": {},
            "args": [
                "--from",
                "git+https://github.com/c-cf/imf-data-mcp",
                "imf-data-mcp"
            ],
            "shell": false,
            "command": "uvx"
        }
    }
}

JSON

{
    "mcpServers": {
        "imf data": {
            "env": {},
            "args": [
                "--from",
                "git+https://github.com/c-cf/imf-data-mcp",
                "imf-data-mcp"
            ],
            "shell": false,
            "command": "uvx"
        }
    }
}

Setting up with Windsurf

Open Windsurf's preferences
Go to the Integrations section
Click "Add MCP Integration"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "imf data": {
            "env": {},
            "args": [
                "--from",
                "git+https://github.com/c-cf/imf-data-mcp",
                "imf-data-mcp"
            ],
            "shell": false,
            "command": "uvx"
        }
    }
}

JSON

{
    "mcpServers": {
        "imf data": {
            "env": {},
            "args": [
                "--from",
                "git+https://github.com/c-cf/imf-data-mcp",
                "imf-data-mcp"
            ],
            "shell": false,
            "command": "uvx"
        }
    }
}

JSON

{
    "mcpServers": {
        "imf data": {
            "env": {},
            "args": [
                "--from",
                "git+https://github.com/c-cf/imf-data-mcp",
                "imf-data-mcp"
            ],
            "shell": false,
            "command": "uvx"
        }
    }
}

Setting up with Cline

Open Cline's settings
Navigate to the Integrations section
Click "Add MCP Server"
Copy and paste the configuration below based on your operating system

Note: Make sure to restart Cline after adding the configuration.

JSON

{
    "mcpServers": {
        "imf data": {
            "env": {},
            "args": [
                "--from",
                "git+https://github.com/c-cf/imf-data-mcp",
                "imf-data-mcp"
            ],
            "shell": false,
            "command": "uvx"
        }
    }
}

JSON

{
    "mcpServers": {
        "imf data": {
            "env": {},
            "args": [
                "--from",
                "git+https://github.com/c-cf/imf-data-mcp",
                "imf-data-mcp"
            ],
            "shell": false,
            "command": "uvx"
        }
    }
}

JSON

{
    "mcpServers": {
        "imf data": {
            "env": {},
            "args": [
                "--from",
                "git+https://github.com/c-cf/imf-data-mcp",
                "imf-data-mcp"
            ],
            "shell": false,
            "command": "uvx"
        }
    }
}

Setting up with Goose

Open Goose's preferences
Go to the Integrations tab
Select "MCP Servers"
Click "Add New Server"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "imf data": {
            "env": {},
            "args": [
                "--from",
                "git+https://github.com/c-cf/imf-data-mcp",
                "imf-data-mcp"
            ],
            "shell": false,
            "command": "uvx"
        }
    }
}

JSON

{
    "mcpServers": {
        "imf data": {
            "env": {},
            "args": [
                "--from",
                "git+https://github.com/c-cf/imf-data-mcp",
                "imf-data-mcp"
            ],
            "shell": false,
            "command": "uvx"
        }
    }
}

JSON

{
    "mcpServers": {
        "imf data": {
            "env": {},
            "args": [
                "--from",
                "git+https://github.com/c-cf/imf-data-mcp",
                "imf-data-mcp"
            ],
            "shell": false,
            "command": "uvx"
        }
    }
}

From the repository

{
  "mcpServers": {
    "imf": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/c-cf/imf-data-mcp", "imf-data-mcp"]
    }
  }
}

Or, if installed via pip:

{
  "mcpServers": {
    "imf": {
      "command": "imf-data-mcp"
    }
  }
}

---

`imf_list_databases`

List all ~155 IMF databases with their IDs.

`imf_search_databases`

Filter databases by keyword (e.g. 'inflation', 'trade').

`imf_get_parameter_defs`

List query dimensions for a database.

`imf_get_parameter_codes`

List valid codes for a dimension, with optional search.

`imf_fetch_data`

Fetch time series data with year range and dimension filters.

| Tool | Description |
|---|---|
| imf_list_databases | List all ~155 IMF databases with their IDs |
| imf_search_databases | Filter databases by keyword (e.g. "inflation", "trade") |
| imf_get_parameter_defs | List query dimensions for a database |
| imf_get_parameter_codes | List valid codes for a dimension, with optional search |
| imf_fetch_data | Fetch time series data with year range and dimension filters |

---

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "imf data": {
            "env": {},
            "args": [
                "--from",
                "git+https://github.com/c-cf/imf-data-mcp",
                "imf-data-mcp"
            ],
            "shell": false,
            "command": "uvx"
        }
    }
}

Linux

{
    "env": [],
    "args": [
        "--from",
        "git+https://github.com/c-cf/imf-data-mcp",
        "imf-data-mcp"
    ],
    "shell": false,
    "command": "uvx"
}

Macos

{
    "env": [],
    "args": [
        "--from",
        "git+https://github.com/c-cf/imf-data-mcp",
        "imf-data-mcp"
    ],
    "shell": false,
    "command": "uvx"
}

Windows

{
    "env": [],
    "args": [
        "--from",
        "git+https://github.com/c-cf/imf-data-mcp",
        "imf-data-mcp"
    ],
    "shell": false,
    "command": "uvx"
}

IMF Data MCP

A Model Context Protocol server for IMF economic data, built on
imfp and the
IMF SDMX API at data.imf.org.

> v0.2.0 — Breaking change: The old server called dataservices.imf.org,
> which the IMF decommissioned in 2025. All requests timed out as a result.
> This version migrates to imfp, which targets the current data.imf.org
> SDMX 3.0 API and is actively maintained.

---

Installation

Using `uv` (recommended)

uvx --from git+https://github.com/c-cf/imf-data-mcp imf-data-mcp

Using pip

pip install git+https://github.com/c-cf/imf-data-mcp.git

---

Claude Desktop configuration

{
  "mcpServers": {
    "imf": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/c-cf/imf-data-mcp", "imf-data-mcp"]
    }
  }
}

Or, if installed via pip:

{
  "mcpServers": {
    "imf": {
      "command": "imf-data-mcp"
    }
  }
}

---

Available tools

---

Typical workflow

1. imf_search_databases(keyword="consumer price")
   → CPI, CPI_WCA, ...
2. imf_get_parameter_defs(database_id="CPI")

   → country, index_type, coicop_1999, frequency, ...
3. imf_get_parameter_codes(database_id="CPI", parameter="country", search="austria")

   → AUT
4. imf_fetch_data(

       database_id="CPI",

       start_year=2015, end_year=2023,

       filters={"country": ["AUT"], "frequency": ["M"]}

   )

---

Common database IDs

| Topic | ID |
|---|---|
| Consumer Prices | CPI |
| Producer Prices | PPI |
| National Accounts (Annual) | ANEA |
| National Accounts (Quarterly) | QNEA |
| Balance of Payments | BOP_AGG |
| Exchange Rates | ER_2026_JAN_VINTAGE |
| Commodity Prices | PCPS |
| Fiscal Monitor | FM |
| Gov. Finance Statistics | GFS_COFOG |
| Monetary Statistics | MFS_CBS, MFS_MA, MFS_IR |
| Financial Soundness | FSIC |
| Trade in Services | ITS |
| SDG Data | SDG |

---

Rate limits

The IMF API allows roughly 10 requests / 5 seconds. imfp handles
rate limiting and retries automatically.

---

Debugging

npx @modelcontextprotocol/inspector imf-data-mcp

---

License

Apache 2.0

No reviews yet — be the first

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.

About

Details

Jump to

Setting up with Highlight

From the repository

imf_list_databases

imf_search_databases

imf_get_parameter_defs

imf_get_parameter_codes

imf_fetch_data

Claude Desktop / Cursor

Linux

Macos

Windows

IMF Data MCP

Installation

Using uv (recommended)

Using pip

Claude Desktop configuration

Available tools

Typical workflow

Common database IDs

Rate limits

Debugging

License

Install

More like this

Sequential Thinking

Redis

Filesystem

EverArt

Google Drive

Sqlite

`imf_list_databases`

`imf_search_databases`

`imf_get_parameter_defs`

`imf_get_parameter_codes`

`imf_fetch_data`

Using `uv` (recommended)