indec-mcp

Servidor MCP (Model Context Protocol) para consultar las estadísticas del INDEC de Argentina desde agentes de IA (Claude, Cursor y cualquier cliente MCP), sobre la API oficial api.indec.gob.ar (hoy en BETA).

Proyecto no oficial. No está afiliado ni respaldado por el INDEC. Los datos pertenecen al INDEC: citá siempre la fuente.

Vos:    ¿Cuánto fue la inflación de cada mes de 2025 y cómo se compara con la canasta básica?
Claude: [indec_ipc → indec_canastas] …

Cubre los 19 datasets de la API: IPC, canastas (CBA/CBT y de crianza), salarios, precios mayoristas, costo de la construcción, EMAE, IPI manufacturero y minero, pobreza, mercado de trabajo (EPH), población (nacional, por jurisdicción y por departamento) y comercio exterior (exportaciones, importaciones y nomenclaturas).

English: an MCP server that lets AI agents query Argentina's national statistics office (INDEC) through its public API: inflation, wage indices, poverty, GDP proxy (EMAE), trade and more. Unofficial. Requires a free INDEC API token (see below). Spanish-language tool descriptions and responses.

Requisitos

• Node.js ≥ 20

• Un token JWT de la API del INDEC (gratis): registrate en https://api.indec.gob.ar, verificá el mail con el código de verificación y generá el token desde Gestionar la cuenta. Copialo y guardalo en un lugar seguro. Vence a los 12 meses, y si lo perdés o deja de andar podés generar uno nuevo (el anterior deja de ser válido enseguida).

Related MCP server: mcp-inegi

Instalación asistida por tu agente (Claude Code)

Si usás Claude Code, la forma más fácil es dejar que tu agente te guíe. Este repositorio incluye una skill que revisa si tenés Node.js y npm, te pide permiso antes de instalar cualquier cosa, te lleva a la página del INDEC para conseguir tu API key, registra el servidor y verifica que funcione:

/plugin marketplace add SantinoSpingola/indec-mcp
/plugin install indec-mcp@indec

Después pedile a Claude: «ayudame a instalar el MCP del INDEC». También funciona si le pegás el link de este repositorio y le pedís que lo instale (leerá skills/instalar-indec-mcp/SKILL.md).

Para agentes de IA: si un usuario te pidió instalar este MCP, seguí skills/instalar-indec-mcp/SKILL.md: comprobá Node.js (≥ 20), pedí permiso antes de instalar o modificar nada, indicá al usuario que genere su API key en https://api.indec.gob.ar (no la crees por él) y verificá con indec_status.

Si preferís hacerlo a mano, seguí con las opciones de abajo.

Instalación

Opción A: desde npm (la más simple)

En Claude Desktop o Cursor (en Claude Desktop: Settings → Developer → Edit Config):

{
  "mcpServers": {
    "indec": {
      "command": "npx",
      "args": ["-y", "indec-mcp"],
      "env": { "INDEC_API_TOKEN": "tu_token_jwt" }
    }
  }
}

En Claude Code:

claude mcp add indec --env INDEC_API_TOKEN=tu_token_jwt -- npx -y indec-mcp

En Windows (PowerShell o CMD, no WSL) Claude Code necesita cmd /c delante de npx:

claude mcp add indec --env INDEC_API_TOKEN=tu_token_jwt -- cmd /c npx -y indec-mcp

Opción B: desde el código fuente

git clone https://github.com/SantinoSpingola/indec-mcp.git
cd indec-mcp
npm install        # compila solo (script `prepare`)

Después apuntá tu cliente MCP a node /ruta/absoluta/a/indec-mcp/dist/index.js (mismo bloque mcpServers de arriba, con "command": "node" y esa ruta en args).

Opción C: directo desde GitHub con npx

"args": ["--allow-git=all", "-y", "github:SantinoSpingola/indec-mcp"] en el bloque de arriba. La primera vez compila y tarda un minuto. --allow-git=all hace falta desde npm 12, que por seguridad ya no descarga paquetes desde git por defecto; con npm 10 u 11 podés omitirlo.

Tu token es personal. Ponelo solo en la variable de entorno de tu cliente MCP; el servidor nunca lo escribe en logs ni en las respuestas.

Variables de entorno

Herramientas (19)

Las tools de series devuelven solo el último período si no se indica desde/hasta (formatos AAAA, AAAA-MM, AAAA-N para semestres y trimestres).

También expone resources (indec://catalogo, indec://dataset/{id}, indec://signos-convencionales, indec://guia-paginacion) y prompts (informe-inflacion, panorama-economico, evolucion-pobreza, comercio-exterior-por-pais).

Cómo está hecho

• docs/openapi.snapshot.json es el spec oficial (público en GET /v1/). npm run gen genera de él src/datasets/registry.generated.ts (columnas, tipos, claves de orden y frecuencia). npm run gen -- --fetch actualiza el snapshot desde el INDEC; indec_status avisa si el spec remoto cambió.

• Los filtros se validan contra el registry; se manda siempre la clave primaria completa en order para que la paginación sea estable; los valores se codifican con URLSearchParams.

• Reintentos con backoff ante 429/502/503/504, caché con TTL y deduplicación de requests concurrentes. Se identifica con un User-Agent propio.

• Los signos convencionales del INDEC (*, **, s, …) se detectan y se informan junto a los datos.

Particularidades de la API (verificadas contra datos reales, nov-2026)

• Columnas <col>_null: cada columna anulable tiene una hermana con el signo convencional cuando el valor es nulo (valor_FOB=null, valor_FOB_null="s"). No figuran en el spec, pero se pueden usar en select y filtros. Este servidor las limpia de la salida y las resume en razon_nulo / signos_convencionales.

• Períodos de la EPH: 20261S (semestre) y 20262T (trimestre), no AAAAN. Los mensuales son AAAAMM.

• Tipos de indicador en precios y salarios: Indice, v_m (mensual), v_ia (interanual), v_acum, incidencia; el IPI usa nombres en español. Las tools exponen un parámetro tipo amigable que los traduce.

• Datos confidenciales: en comercio exterior cerca de la mitad de las filas tienen s (secreto estadístico). No suman y se informan como filas_sin_valor.

• Provisorios: el texto de observaciones (ej. «Dato provisorio») se devuelve en notas.

Límites conocidos

• Solo transporte stdio (cliente local). No hay servidor HTTP.

• La API del INDEC está en BETA: puede cambiar sin aviso. El script de verificación y indec_status ayudan a detectarlo.

• Los totales calculados por indec_aggregate y indec_comercio_exterior son sumas de las filas publicadas y pueden diferir levemente de los informes técnicos del INDEC (redondeo, datos confidenciales).

• El servidor no interpreta ni valida económicamente los datos: son lo que publica el INDEC.

• Límites de uso del INDEC: la API tiene límites según el tipo de cuenta, que el INDEC no detalla en sus términos. Para ser un buen usuario, el servidor guarda las respuestas en caché (1 hora por defecto), reintenta con espera creciente y limita cuántas filas recorre: indec_aggregate hasta 50.000 por consulta (max_rows) y indec_comercio_exterior hasta 200.000, avisando cuando el resultado es parcial. Si una consulta es muy grande, acotala con filtros.

Desarrollo

npm install
npm test                   # tests unitarios, de contrato con el spec y del servidor con API simulada
npm run typecheck
npm run smoke              # handshake real por stdio, sin token
npm run smoke -- --live    # 1 request real por dataset (requiere INDEC_API_TOKEN)
npm run e2e                # escenarios de agente contra la API real (requiere INDEC_API_TOKEN)
node scripts/verify-live.mjs [distinct|samples|tipos|comercio|signos]   # muestras reales
node scripts/probe.mjs "<ruta?query>"                                   # request crudo a la API

Los tests de CI no usan el token: la API se simula (el smoke solo consulta el spec público). Las pruebas contra la API real (smoke --live, e2e) se corren a mano.

Datos y atribución

Los datos son del INDEC (https://www.indec.gob.ar), obtenidos de su API pública. Revisá los términos de la API antes de redistribuir datos.

Cómo citar: el INDEC pide citar la fuente de forma clara y visible, con el formato «Fuente: INDEC» más el servicio de datos consultado, por ejemplo «Fuente: INDEC, IPC nacional». Cada respuesta de este servidor trae el campo dataset con el servicio consultado para armar esa cita. Este proyecto no está afiliado al INDEC ni cuenta con su respaldo.

Seguridad

Ver SECURITY.md.

Licencia

MIT © 2026 Santino Spingola