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
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.
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 GitHubFrom the project's GitHub README.
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, 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
| Tool | Qué hace | Fuente |
|---|---|---|
cotizaciones_dolar | Oficial, blue, MEP, CCL, mayorista, cripto, tarjeta | dolarapi.com |
cotizacion_bcra | Tipo de cambio oficial BCRA de cualquier moneda, por fecha | BCRA – Estadísticas cambiarias v1 |
buscar_variables_bcra | Busca entre ~1600 variables (reservas, BADLAR, TAMAR, CER, UVA, ICL…) | BCRA – Estadísticas monetarias v4 |
serie_variable_bcra | Serie histórica de una variable por id | BCRA – Estadísticas monetarias v4 |
consultar_deudor | Situación crediticia de un CUIT/CUIL + cheques rechazados (valida dígito verificador) | BCRA – Central de Deudores v1 |
consultar_cheque_denunciado | Si un cheque fue denunciado como extraviado o robado; el banco se indica por nombre o código | BCRA – Cheques v1 |
feriados | Feriados nacionales del año (o solo los próximos) | argentinadatos.com |
inflacion | IPC mensual y acumulada en un rango | argentinadatos.com |
ajustar_por_inflacion | Lleva 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 1999 | argentinadatos.com |
plazos_fijos | Ranking de tasas por banco/billetera para un plazo y monto: TNA, TEA, interés y tasa real vs. inflación | argentinadatos.com |
calcular_aguinaldo | Aguinaldo (SAC) del semestre, proporcional por ingreso o egreso, con neto estimado | Cálculo (Ley 23.041) |
cuotas_vs_contado | Valor presente de las cuotas contra la inflación esperada e interés implícito | Cálculo + IPC |
simular_credito_uva | Cuota en UVAs y en pesos, ingreso mínimo y proyección con inflación | Cálculo + UVA del BCRA + IPC |
normalizar_direccion | Normaliza y geolocaliza una dirección; si no hay altura, sugiere la calle | Georef (datos.gob.ar) |
normalizar_direcciones_lote | Hasta 500 direcciones en una llamada, con % de éxito | Georef (datos.gob.ar) |
buscar_lugar | Provincias, departamentos, municipios, localidades y calles con id INDEC | Georef (datos.gob.ar) |
ubicacion_por_coordenadas | Qué provincia/departamento/municipio contiene un punto | Georef (datos.gob.ar) |
buscar_series | Busca entre las series oficiales (INDEC y ministerios): salarios, EMAE, empleo, IPC por rubro… | Series de Tiempo (datos.gob.ar) |
consultar_series | Valores, variación %, variación interanual y cambio de frecuencia de hasta 10 series | Series 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ú +.
| Prompt | Qué arma | Argumentos |
|---|---|---|
informe_economico_del_dia | Dólar y brechas, riesgo país, inflación, mejor plazo fijo y próximo feriado | — |
analisis_crediticio | Central de Deudores de los últimos 24 meses, cheques rechazados y calificación orientativa | cuit |
plazo_fijo_vs_inflacion | Mejores plazos fijos, tasa real y dólar MEP de equilibrio | monto, dias (opcional) |
poder_adquisitivo | Un monto de un mes pasado actualizado por inflación y comparado con el dólar | monto, desde (YYYY-MM) |
Resources
Catálogos que se pueden adjuntar como contexto sin llamar una tool (en Claude Code, con @).
| URI | Contenido |
|---|---|
datos-argentina://bcra/variables | Las ~1600 variables monetarias del BCRA con id, unidad y periodicidad |
datos-argentina://bcra/situaciones | Qué significa cada situación (1 a 6) de la Central de Deudores |
datos-argentina://bcra/entidades-cheques | Bancos con su código de entidad del BCRA |
datos-argentina://georef/provincias | Las 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 / argumento | Por defecto | Para qué |
|---|---|---|
--http o MCP_TRANSPORT=http | stdio | Usa el transporte HTTP |
--port o PORT | 3000 | Puerto |
--host o HOST | 127.0.0.1 (0.0.0.0 en Docker) | Interfaz donde escucha |
MCP_AUTH_TOKEN | — | Si está, exige Authorization: Bearer <token> |
MCP_ALLOWED_HOSTS | localhost si escucha en localhost | Hostnames 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_LIMIT | 0 (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/limitcon 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_serieslo esquiva pidiendo constart_date(versrc/ventana.ts). - Georef no tiene alturas cargadas para muchas calles del interior: en esos casos
normalizar_direcciondevuelve 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!
More Developer Tools MCP Servers
Rea
Freeby Morluto · Developer Tools
Reverse engineer anything from your terminal or agent with one CLI and MCP server.
Paperclip
Freeby Paperclipai · Developer Tools
Trending hip-hop artist momentum scores across four cultural dimensions.
Scrapling
Freeby D4Vinci · Developer Tools
Web scraping with stealth HTTP, real browsers, and Cloudflare bypass. CSS selectors supported.
Git
Freeby Modelcontextprotocol · Developer Tools
Read, search, and manipulate Git repositories programmatically
Toleno
Freeby Toleno · Developer Tools
Toleno Network MCP Server — Manage your Toleno mining account with Claude AI using natural language.
MCP Marketplace
Freeby mcp-marketplace · Developer Tools
Search and install MCP servers from inside your AI client.
