Back to Browse

Datos Argentina MCP Server

Developer ToolsLow Risk10.0MCP RegistryLocal
Free

Server data from the Official MCP Registry

Datos públicos de Argentina: BCRA, dólar, inflación, riesgo país, cheques, Georef y calculadoras

About

Datos públicos de Argentina: BCRA, dólar, inflación, riesgo país, cheques, Georef y calculadoras

Security Report

10.0
Low Risk10.0Low Risk

Valid MCP server (3 strong, 1 medium validity signals). No known CVEs in dependencies. Package registry verified. Imported from the Official MCP Registry.

6 files analyzed · 1 issue found

Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.

Permissions Required

This plugin requests these system permissions. Most are normal for its category.

env_vars

Check that this permission is expected for this type of plugin.

How to Install

Add this to your MCP configuration file:

{
  "mcpServers": {
    "mcp-datos-argentina": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-datos-argentina@1.0.0"
      ]
    }
  }
}

Some servers take additional arguments. See the repository for details.

Documentation

View on GitHub

From the project's GitHub README.

mcp-datos-argentina 🇦🇷

CI npm MCP Registry Licencia: MIT

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, cheques denunciados, riesgo país, plazos fijos, inflación, feriados, direcciones y geografía (Georef) y miles de series oficiales del INDEC y ministerios. Suma calculadoras (aguinaldo, cuotas vs. contado, crédito UVA) que usan esos datos.

20 tools · 4 prompts · 5 resources · salida estructurada · stdio y Streamable HTTP · Docker. Ninguna fuente requiere registro ni token.

📖 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?" · "¿Me conviene pagar $900.000 de contado o 12 cuotas de $85.000?" · "¿Cuándo es el próximo feriado?"

Tools

ToolQué haceFuente
cotizaciones_dolarOficial, blue, MEP, CCL, mayorista, cripto, tarjetadolarapi.com
cotizacion_bcraTipo de cambio oficial BCRA de cualquier moneda, por fechaBCRA – Estadísticas cambiarias v1
buscar_variables_bcraBusca entre ~1600 variables (reservas, BADLAR, TAMAR, CER, UVA, ICL…)BCRA – Estadísticas monetarias v4
serie_variable_bcraSerie histórica de una variable por idBCRA – Estadísticas monetarias v4
consultar_deudorSituación crediticia de un CUIT/CUIL + cheques rechazados (valida dígito verificador)BCRA – Central de Deudores v1
consultar_cheque_denunciadoSi un cheque fue denunciado como extraviado o robado; el banco se indica por nombre o códigoBCRA – Cheques v1
feriadosFeriados nacionales del año (o solo los próximos)argentinadatos.com
inflacionIPC mensual y acumulada en un rangoargentinadatos.com
ajustar_por_inflacionLleva un monto de un mes a otro por IPC (hacia adelante o atrás)argentinadatos.com
riesgo_paisÚltimo valor, variación diaria y del período, mínimo/máximo; historia desde 1999argentinadatos.com
plazos_fijosRanking de tasas por banco/billetera para un plazo y monto: TNA, TEA, interés y tasa real vs. inflaciónargentinadatos.com
calcular_aguinaldoAguinaldo (SAC) del semestre, proporcional por ingreso o egreso, con neto estimadoCálculo (Ley 23.041)
cuotas_vs_contadoValor presente de las cuotas contra la inflación esperada e interés implícitoCálculo + IPC
simular_credito_uvaCuota en UVAs y en pesos, ingreso mínimo y proyección con inflaciónCálculo + UVA del BCRA + IPC
normalizar_direccionNormaliza y geolocaliza una dirección; si no hay altura, sugiere la calleGeoref (datos.gob.ar)
normalizar_direcciones_loteHasta 500 direcciones en una llamada, con % de éxitoGeoref (datos.gob.ar)
buscar_lugarProvincias, departamentos, municipios, localidades y calles con id INDECGeoref (datos.gob.ar)
ubicacion_por_coordenadasQué provincia/departamento/municipio contiene un puntoGeoref (datos.gob.ar)
buscar_seriesBusca entre las series oficiales (INDEC y ministerios): salarios, EMAE, empleo, IPC por rubro…Series de Tiempo (datos.gob.ar)
consultar_seriesValores, variación %, variación interanual y cambio de frecuencia de hasta 10 seriesSeries de Tiempo (datos.gob.ar)

Las respuestas se cachean en memoria (2 min a 24 h según la fuente) para no castigar las APIs públicas. Las calculadoras hacen la cuenta localmente y solo consultan la inflación y la UVA.

Prompts

Plantillas listas que combinan varias tools. En Claude Code se invocan como /mcp__datos-argentina__<nombre>; en Claude Desktop, desde el menú +.

PromptQué armaArgumentos
informe_economico_del_diaDólar y brechas, riesgo país, inflación, mejor plazo fijo y próximo feriado—
analisis_crediticioCentral de Deudores de los últimos 24 meses, cheques rechazados y calificación orientativacuit
plazo_fijo_vs_inflacionMejores plazos fijos, tasa real y dólar MEP de equilibriomonto, dias (opcional)
poder_adquisitivoUn monto de un mes pasado actualizado por inflación y comparado con el dólarmonto, desde (YYYY-MM)

Resources

Catálogos que se pueden adjuntar como contexto sin llamar una tool (en Claude Code, con @).

URIContenido
datos-argentina://bcra/variablesLas ~1600 variables monetarias del BCRA con id, unidad y periodicidad
datos-argentina://bcra/situacionesQué significa cada situación (1 a 6) de la Central de Deudores
datos-argentina://bcra/entidades-chequesBancos con su código de entidad del BCRA
datos-argentina://georef/provinciasLas 24 jurisdicciones con id INDEC y centroide
datos-argentina://feriados/{anio}Feriados nacionales de un año (desde 2016, con autocompletado)

Salida estructurada

Las 20 tools declaran outputSchema y devuelven los datos también en structuredContent, validados contra ese esquema. Un programa puede consumirlos tipados sin parsear el texto. Los campos de cada tool están en el manual.

Instalación

Requiere Node.js 20 o superior. Publicado en npm como mcp-datos-argentina y listado en el registro oficial de MCP como io.github.Gonza28fq/mcp-datos-argentina.

Claude Code

claude mcp add --scope user datos-argentina -- npx -y mcp-datos-argentina

Claude Desktop

En claude_desktop_config.json:

{
  "mcpServers": {
    "datos-argentina": {
      "command": "npx",
      "args": ["-y", "mcp-datos-argentina"]
    }
  }
}

Desde el código fuente

git clone https://github.com/Gonza28fq/mcp-datos-argentina.git
cd mcp-datos-argentina
npm install
npm run build
claude mcp add datos-argentina -- node /ruta/a/mcp-datos-argentina/dist/index.js

Por HTTP (servidor remoto)

Además de stdio, el servidor habla Streamable HTTP en /mcp, sin estado: sirve como conector remoto y escala detrás de un balanceador.

npx -y mcp-datos-argentina --http --port 3000     # http://127.0.0.1:3000/mcp
claude mcp add --transport http datos-argentina http://127.0.0.1:3000/mcp

Con Docker:

docker build -t mcp-datos-argentina .
docker run --rm -p 3000:3000 -e MCP_AUTH_TOKEN=un-token-largo mcp-datos-argentina
claude mcp add --transport http datos-argentina http://localhost:3000/mcp --header "Authorization: Bearer un-token-largo"
Variable / argumentoPor defectoPara qué
--http o MCP_TRANSPORT=httpstdioUsa el transporte HTTP
--port o PORT3000Puerto
--host o HOST127.0.0.1 (0.0.0.0 en Docker)Interfaz donde escucha
MCP_AUTH_TOKEN—Si está, exige Authorization: Bearer <token>
MCP_ALLOWED_HOSTSlocalhost si escucha en localhostHostnames aceptados en el header Host (protección contra DNS rebinding). En un servidor público, poné tu dominio
MCP_ALLOWED_ORIGINS—Orígenes de navegador permitidos (CORS). Los clientes que no son navegador no mandan Origin
MCP_RATE_LIMIT0 (sin límite)Pedidos por minuto por IP en /mcp. Al pasarlo responde 429 con Retry-After
MCP_TRUST_PROXY—1 detrás de un proxy (Render, Fly, nginx): toma la IP del cliente de X-Forwarded-For

GET /health responde {"status":"ok"} sin token, para balanceadores y Docker. Si lo exponés en internet, configurá MCP_ALLOWED_HOSTS y además MCP_AUTH_TOKEN o, para una instancia pública, MCP_RATE_LIMIT.

Desplegar en Render

El repo incluye render.yaml: una instancia pública sin token, con 60 pedidos por minuto por IP. En Render, New → Blueprint y elegí el repositorio; el dominio *.onrender.com asignado se acepta solo en el header Host. En el plan gratuito el servicio se duerme tras 15 minutos sin uso y el primer pedido tarda unos 50 segundos en despertarlo.

Desarrollo

npm test           # tests unitarios y de integración (sin red)
npm run smoke      # levanta el servidor y llama cada tool contra las APIs reales
npm run smoke:http # lo mismo, por Streamable HTTP
npm run start:http # servidor HTTP en http://127.0.0.1:3000/mcp
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: stdio o --http
  servidor.ts            # arma el servidor con todas las tools, prompts y resources
  transporte-http.ts     # Streamable HTTP sin estado: Host, Origin, token, /health

  tools.ts               # BCRA, dólar, Central de Deudores, inflación y feriados
  mercado.ts             # riesgo país y plazos fijos
  cheques.ts             # cheques denunciados
  georef.ts              # normalización geográfica
  series.ts              # series de tiempo oficiales
  calculadoras-tools.ts  # tools de aguinaldo, cuotas vs. contado y crédito UVA
  prompts.ts             # prompts MCP
  recursos.ts            # resources MCP
  esquemas.ts            # outputSchema de cada tool

  calculadoras.ts        # matemática financiera (lógica pura, testeada sin red)
  plazofijo.ts           # tasa por plazo/monto, TEA y tasa real
  inflacion.ts           # inflación acumulada y ajuste de montos
  ventana.ts             # workaround del bug de transformaciones de Series de Tiempo
  cuit.ts                # validación de CUIT/CUIL
  http.ts                # fetch con timeout + caché
  comun.ts               # helpers compartidos

Cada módulo con lógica tiene su *.test.ts al lado. La CI corre los tests en Node 20, 22 y 24, el smoke contra las APIs reales por los dos transportes y construye la imagen Docker. Al subir un tag v*, publica en npm (Trusted Publishing, con provenance) y en el Registro MCP.

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).
  • Las calculadoras y los prompts son orientativos: no son asesoramiento financiero, legal ni contable.

Roadmap

Próximo:

  • Padrón de ARCA (constancia de inscripción), opcional con certificado propio del usuario
  • Tests de contrato con respuestas grabadas, para detectar cambios en las APIs sin depender de la red

Hecho en la 1.0: 20 tools, prompts, resources, salida estructurada, transporte HTTP con Docker, publicación en npm y en el Registro MCP con release automático.

Historial de cambios en CHANGELOG.md.

Licencia

MIT

Reviews

No reviews yet

Be the first to review this server!