eiu-mcp-server

Un servidor del Model Context Protocol que ofrece a Claude (o a cualquier cliente LLM compatible con MCP) un acceso estructurado y eficiente en tokens a la API de datos de EIU — alrededor de 200 países y 320 series de indicadores económicos, con datos históricos y previsiones.

Expone tres herramientas:

Los datos de referencia se obtienen una vez por sesión y se guardan en caché en memoria, por lo que explorar y buscar no implican llamadas adicionales a la API.

Requisitos previos

• Acceso al Developer Portal de la API de EIU. No es autoservicio. Envía un correo a economicssupport@economist.com y solicita acceso al Developer Portal. Crearán tu cuenta manualmente. Necesitas las tres cosas: la dirección de correo de tu portal, la contraseña de tu portal y la clave de API que se muestra en el portal.

• uv instalado en tu máquina. Instalación en una línea:

  curl -LsSf https://astral.sh/uv/install.sh | sh

No es necesario clonar este repositorio ni gestionar un entorno virtual: uvx se encarga de todo desde la URL del repositorio.

Related MCP server: EODHD MCP Server

Instalación

Claude Code

La instalación en una línea, ejecutada desde una carpeta cuyo .env contiene tus tres valores de EIU. El shell los lee, de modo que las credenciales nunca aparecen en tu conversación:

set -a; source .env; set +a
claude mcp add --scope user eiu \
  -e EIU_API_KEY="$EIU_API_KEY" \
  -e EIU_EMAIL="$EIU_EMAIL" \
  -e EIU_PASSWORD="$EIU_PASSWORD" \
  -- uvx --from git+https://github.com/joshua-bailey/eiu-mcp-server.git eiu-mcp-server

O añade la entrada a .mcp.json manualmente:

{
  "mcpServers": {
    "eiu": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/joshua-bailey/eiu-mcp-server.git",
        "eiu-mcp-server"
      ],
      "env": {
        "EIU_API_KEY": "${EIU_API_KEY}",
        "EIU_EMAIL": "${EIU_EMAIL}",
        "EIU_PASSWORD": "${EIU_PASSWORD}"
      }
    }
  }
}

Después reinicia Claude Code. Las tres herramientas eiu_* deberían aparecer en /mcp.

Claude Desktop

El mismo fragmento JSON, colocado bajo mcpServers en:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

• Windows: %APPDATA%\Claude\claude_desktop_config.json

Claude Desktop no expande las referencias ${VAR}, así que pon ahí los valores literales.

Fijar una versión

uvx instala por defecto el último commit de main. Para fijar una versión etiquetada, añade @<tag> a la URL del repositorio, por ejemplo:

"git+https://github.com/joshua-bailey/eiu-mcp-server.git@v0.1.0"

Variables de entorno

Las tres son necesarias. El servidor inicia sesión con el correo y la contraseña para obtener un token bearer, y luego envía ese token junto con la clave de API en cada solicitud. El token se guarda en memoria y se renueva antes de que caduque.

Cómo usarlo

Una vez registrado el MCP, pídele a Claude cosas como:

• "Busca en EIU las series de saldo por cuenta corriente"

• "¿Qué códigos de series de EIU cubren los precios al consumo?"

• "Obtén el crecimiento anual del PIB de EIU (DGDP) para EE. UU., Reino Unido y China de 2015 a 2030"

• "Muéstrame las previsiones trimestrales de inflación de EIU para Brasil, México y Chile"

Claude elige la herramienta adecuada y la invoca.

Códigos

• Geografías son códigos ISO de dos letras en mayúsculas: US, GB, CN, BR.

• Series son los códigos cortos propios de EIU en mayúsculas, p. ej., DGDP, DCPI. Usa eiu_search o eiu_browse para encontrarlas en lugar de adivinar.

• Frecuencia es uno de Yearly, Quarterly o Monthly.

eiu_get_data limita su respuesta a 200 puntos de datos para mantenerse eficiente en tokens y lo indica cuando trunca. Reduce el rango de fechas o la lista de países para ver el resto.

Referencia de la API

La API subyacente está documentada en developer.eiu.com/help/overview. El servidor se comunica con https://api.eiu.com/v1.

Licencia

MIT — consulta LICENSE. Se aplica únicamente al código del wrapper de este repositorio. Las dependencias conservan sus propias licencias. Los datos de EIU son una suscripción de pago y sus condiciones de uso se aplican independientemente de este wrapper.