IMF Data MCP

IMF Data MCP

Um servidor Model Context Protocol para dados econômicos do IMF, construído sobre imfp e a API SDMX do IMF em data.imf.org.

v0.2.0 — Mudança significativa: O servidor antigo chamava dataservices.imf.org, que o IMF descontinuou em 2025. Todas as solicitações expiravam como resultado. Esta versão migra para imfp, que tem como alvo a API data.imf.org SDMX 3.0 atual e é mantida ativamente.

---

Instalação

Usando uv (recomendado)

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

Usando pip

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

---

Configuração do Claude Desktop

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

Ou, se instalado via pip:

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

---

Ferramentas disponíveis

Ferramenta	Descrição
imf_list_databases	Listar todos os ~155 bancos de dados do IMF com seus IDs
imf_search_databases	Filtrar bancos de dados por palavra-chave (ex.: "inflation", "trade")
imf_get_parameter_defs	Listar dimensões de consulta para um banco de dados
imf_get_parameter_codes	Listar códigos válidos para uma dimensão, com busca opcional
imf_fetch_data	Buscar dados de séries temporais com intervalo de anos e filtros de dimensão

---

Fluxo de trabalho típico

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"]}
   )

---

IDs comuns de bancos de dados

Tópico	ID
Preços ao Consumidor	CPI
Preços ao Produtor	PPI
Contas Nacionais (Anual)	ANEA
Contas Nacionais (Trimestral)	QNEA
Balanço de Pagamentos	BOP_AGG
Taxas de Câmbio	ER_2026_JAN_VINTAGE
Preços de Commodities	PCPS
Monitor Fiscal	FM
Estatísticas de Finanças Governamentais	GFS_COFOG
Estatísticas Monetárias	MFS_CBS, MFS_MA, MFS_IR
Solidez Financeira	FSIC
Comércio de Serviços	ITS
Dados ODS	SDG

---

Limites de taxa

A API do IMF permite aproximadamente 10 solicitações / 5 segundos. imfp lida com limites de taxa e novas tentativas automaticamente.

---

Depuração

npx @modelcontextprotocol/inspector imf-data-mcp

---

Licença

Apache 2.0