IMF Data MCP Server

Recupere e processe dados econômicos da API do Fundo Monetário Internacional (FMI), incluindo conjuntos de dados, séries temporais, indicadores e países.

GitHub

Documentação

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