mcp-datos-argentina 🇦🇷

Servidor MCP que le da a Claude (o cualquier cliente MCP) acceso a datos públicos de Argentina en tiempo real: dólar, BCRA, Central de Deudores, inflación, feriados, direcciones y geografía (Georef) y miles de series oficiales del INDEC y ministerios.

📖 Manual completo: qué es MCP, cómo funciona el protocolo, instalación y referencia de cada tool.

"¿A cuánto está el blue?" · "¿Cuánto son hoy $100.000 de enero 2023?" · "¿Cómo está el CUIT 30-54668997-9 en la Central de Deudores?" · "¿Cuándo es el próximo feriado?"

Tools

Ninguna API requiere token. Las respuestas se cachean en memoria (2 min a 24 h según la fuente).

Related MCP server: OpenArg — Argentina public data

Instalación

npm install
npm run build

Claude Code

claude mcp add datos-argentina -- node /ruta/a/mcp-datos-argentina/dist/index.js

Claude Desktop

En claude_desktop_config.json:

{
  "mcpServers": {
    "datos-argentina": {
      "command": "node",
      "args": ["C:/ruta/a/mcp-datos-argentina/dist/index.js"]
    }
  }
}

Desarrollo

npm test           # tests unitarios (CUIT, cálculos de inflación)
npm run smoke      # levanta el servidor y llama cada tool contra las APIs reales
npm run inspector  # MCP Inspector para probar a mano
npm run docs       # regenera la referencia de tools en docs/MANUAL.md

Estructura:

src/
  index.ts      # arranque del servidor (stdio)
  tools.ts      # tools de BCRA, dólar, inflación y feriados
  georef.ts     # tools de normalización geográfica
  series.ts     # tools de series de tiempo oficiales
  mercado.ts    # riesgo país y plazos fijos
  plazofijo.ts  # selección de tasa por plazo/monto y cálculo de TEA y tasa real
  ventana.ts    # workaround del bug de transformaciones de Series de Tiempo
  comun.ts      # helpers compartidos
  http.ts       # fetch con timeout + caché
  cuit.ts       # validación de CUIT/CUIL
  inflacion.ts  # inflación acumulada y ajuste de montos

Notas

• Los montos de la Central de Deudores se devuelven tal como los informa la API del BCRA. Su documentación pública no especifica la unidad (pesos o miles de pesos), así que conviene tomarlos como valores relativos.

• La inflación usa el IPC mensual de INDEC; el ajuste compone los meses posteriores al mes de origen hasta el de destino inclusive.

• La API de estadísticas v3 del BCRA fue deprecada (devuelve 410); este servidor usa la v4.

• Bug conocido de Series de Tiempo: al combinar last/limit con una transformación (variación, interanual), la API corre la ventana hacia atrás y omite los períodos más recientes (con la interanual, un año entero). consultar_series lo esquiva pidiendo con start_date (ver src/ventana.ts).

• Georef no tiene alturas cargadas para muchas calles del interior: en esos casos normalizar_direccion devuelve las calles candidatas en lugar de coordenadas exactas.

• Al agregar a frecuencia anual, la API omite el año en curso (incompleto).

Roadmap

• Padrón de ARCA (constancia de inscripción) — requiere certificado del Web Service

• Riesgo país y plazos fijos por banco (v0.3.0)

• Publicación en npm (npx mcp-datos-argentina)

• Transporte HTTP (Streamable HTTP) para uso remoto

Licencia

MIT