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 toimfp, which targets the currentdata.imf.orgSDMX 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
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