Skip to content

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

10 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

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

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

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

About

This MCP server integrates with the free IMF data API to provide a set of tools and resources for retrieving and processing economic data. It enables users to query datasets, fetch time series data, and list available indicators and countries, making it easier to work with IMF data in a structured and programmatic way.

Resources

Stars

12 stars

Watchers

1 watching

Forks

Releases

Packages

Used by

Contributors

Languages