IMF Data MCP

IMF Data MCP

Un servidor de Model Context Protocol para datos económicos del FMI, construido sobre imfp y la API SDMX del FMI en data.imf.org.

v0.2.0 — Cambio importante: El servidor anterior se llamaba dataservices.imf.org, que el FMI retiró en 2025. Todas las solicitudes expiraban como resultado. Esta versión migra a imfp, que apunta a la API actual data.imf.org SDMX 3.0 y se mantiene activamente.

---

Instalación

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

---

Configuración de Claude Desktop

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

O, si se instaló mediante pip:

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

---

Herramientas disponibles

Herramienta	Descripción
imf_list_databases	Lista las ~155 bases de datos del FMI con sus IDs
imf_search_databases	Filtra bases de datos por palabra clave (p. ej. "inflation", "trade")
imf_get_parameter_defs	Lista las dimensiones de consulta para una base de datos
imf_get_parameter_codes	Lista códigos válidos para una dimensión, con búsqueda opcional
imf_fetch_data	Obtiene datos de series temporales con rango de años y filtros de dimensión

---

Flujo de trabajo 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 comunes de bases de datos

Tema	ID
Precios al Consumidor	CPI
Precios al Productor	PPI
Cuentas Nacionales (Anual)	ANEA
Cuentas Nacionales (Trimestral)	QNEA
Balanza de Pagos	BOP_AGG
Tipos de Cambio	ER_2026_JAN_VINTAGE
Precios de Materias Primas	PCPS
Monitor Fiscal	FM
Estadísticas de Finanzas Públicas	GFS_COFOG
Estadísticas Monetarias	MFS_CBS, MFS_MA, MFS_IR
Solidez Financiera	FSIC
Comercio de Servicios	ITS
Datos ODS	SDG

---

Límites de tasa

La API del FMI permite aproximadamente 10 solicitudes / 5 segundos. imfp maneja los límites de tasa y los reintentos automáticamente.

---

Depuración

npx @modelcontextprotocol/inspector imf-data-mcp

---

Licencia

Apache 2.0