mcp-argentina
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@mcp-argentina¿Cuánto está el dólar blue?"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
MCP Argentina 🇦🇷
Servidor Model Context Protocol (MCP) para consultar datos económicos de Argentina en tiempo real.
Características
💵 Cotizaciones dólar: Oficial, Blue, MEP, CCL, Tarjeta, Cripto, Mayorista
📈 Históricos: 30+ días de evolución de cotizaciones
📊 Inflación: Mensual, interanual y acumulada (INDEC)
🌡️ Riesgo país: Índice EMBI en tiempo real
💱 Monedas: EUR, BRL, UYU, CLP y 10+ monedas extranjeras
🔔 Alertas: Monitoreo de umbrales de precio
📉 Gráficos: Visualización ASCII de tendencias
🔄 Conversiones: ARS ↔ USD con cualquier tipo de cambio
Related MCP server: dolar-mcp
Instalación
pip install mcp-argentinaO desde source:
git clone https://github.com/greydina/mcp-argentina
cd mcp-argentina
pip install -e .Integración con Clientes MCP
Después de instalar, necesitás configurar tu cliente MCP para que ejecute el servidor.
Claude Desktop
Editá ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) o %APPDATA%\Claude\claude_desktop_config.json (Windows):
{
"mcpServers": {
"mcp-argentina": {
"command": "python",
"args": ["-m", "mcp_argentina"]
}
}
}Si usás un virtualenv:
{
"mcpServers": {
"mcp-argentina": {
"command": "/ruta/a/tu/venv/bin/python",
"args": ["-m", "mcp_argentina"]
}
}
}Cursor
Editá .cursor/mcp.json en tu proyecto o ~/.cursor/mcp.json global:
{
"mcpServers": {
"mcp-argentina": {
"command": "python",
"args": ["-m", "mcp_argentina"]
}
}
}Cline (VS Code)
Agregá en la configuración de Cline:
{
"mcp-argentina": {
"command": "python",
"args": ["-m", "mcp_argentina"]
}
}OpenClaw
Agregá en openclaw.json:
{
"mcp": {
"servers": {
"mcp-argentina": {
"command": "python",
"args": ["-m", "mcp_argentina"]
}
}
}
}Verificar instalación
Después de configurar, reiniciá tu cliente. Deberías ver las herramientas disponibles:
get_dolarget_cotizacionesget_inflacionget_riesgo_paisetc.
Probá con: "¿Cuánto está el dólar blue?"
Inicio Rápido
Ejecutar servidor manualmente (debug)
# Ejecutar servidor stdio
python -m mcp_argentinaUso directo (sin MCP)
import asyncio
from mcp_argentina.infrastructure.container import Container
async def main():
c = Container()
# Dólar blue
blue = await c.repository.obtener_dolar("blue")
print(f"💵 Blue: ${blue.venta.valor:,.0f}")
# Inflación
inf = await c.inflacion.obtener_actual()
print(f"📊 Inflación interanual: {inf.interanual:.1f}%")
# Riesgo país
riesgo = await c.repository.obtener_riesgo_pais()
print(f"🌡️ Riesgo país: {riesgo}")
# Euro
euro = await c.monedas.obtener_moneda("EUR")
print(f"💶 Euro: ${euro.venta:,.0f}")
asyncio.run(main())Salida:
💵 Blue: $1,415
📊 Inflación interanual: 33.0%
🌡️ Riesgo país: 615
💶 Euro: $1,593Ejemplos
Obtener todas las cotizaciones
cotizaciones = await c.repository.obtener_todas()
for cot in cotizaciones:
print(f"{cot.nombre}: ${cot.venta.valor:,.0f}")Salida:
Oficial: $1,000
Blue: $1,415
Bolsa: $1,380
Contado con liquidación: $1,390
Mayorista: $1,005
Cripto: $1,410
Tarjeta: $1,600Histórico del dólar blue
historicos = await c.historicos.obtener_historico_dolar("blue", dias=7)
for h in historicos:
print(f"{h.fecha}: ${h.venta:,.0f}")Salida:
2026-03-22: $1,425
2026-03-23: $1,420
2026-03-24: $1,418
2026-03-25: $1,415
2026-03-26: $1,410
2026-03-27: $1,415
2026-03-28: $1,415Variación porcentual
var = await c.historicos.obtener_variacion_dolar("blue", dias=7)
print(f"Variación 7 días: {var['variacion_porcentual']:+.1f}%")Salida:
Variación 7 días: -0.7%Conversión USD → ARS
blue = await c.repository.obtener_dolar("blue")
usd = 100
ars = usd * float(blue.venta.valor)
print(f"USD {usd} = ARS {ars:,.0f} (al blue)")Salida:
USD 100 = ARS 141,500 (al blue)Gráfico ASCII de tendencia
from mcp_argentina.application.services.graficos_service import PuntoGrafico
historicos = await c.historicos.obtener_historico_dolar("blue", dias=30)
puntos = [PuntoGrafico(fecha=h.fecha, valor=float(h.venta)) for h in historicos]
grafico = c.graficos.generar_linea(puntos, titulo="Dólar Blue (30 días)")
print(grafico)Salida:
📊 Dólar Blue (30 días)
Max: $1,450
▅▆▇█▇▆▅▄▃▂▁▁▂▃▄▅▆▅▄▃▂▂▃▄▄▃▂▁▁▁
Min: $1,400
27/02 28/03
📉 -2.4%Herramientas MCP
Herramienta | Descripción |
| Cotización de un tipo de dólar específico |
| Todas las cotizaciones de dólar |
| Histórico de cotizaciones (30+ días) |
| Inflación mensual, interanual, acumulada |
| Índice EMBI Argentina |
| Cotización de moneda extranjera |
| Todas las monedas disponibles |
| Variación porcentual en período |
| Gráfico ASCII de tendencia |
| Conversión ARS ↔ USD |
Resources MCP
URI | Descripción |
| Snapshot JSON de todas las cotizaciones |
| Indicadores económicos clave |
| Datos de inflación actual |
Prompts MCP
Prompt | Descripción |
| Análisis de situación económica |
| Comparación entre tipos de dólar |
Fuentes de Datos
100% APIs públicas, cero scraping.
Fuente | Endpoint | Datos |
| Cotizaciones tiempo real | |
| Monedas extranjeras | |
| Histórico de cotizaciones | |
| Inflación mensual INDEC | |
| Riesgo país (EMBI) |
Arquitectura
mcp_argentina/
├── domain/ # Entidades y value objects
│ ├── entities/ # Cotizacion, etc.
│ └── value_objects/ # Precio, Fecha, TipoDolar
│
├── application/ # Lógica de negocio
│ ├── ports/ # Interfaces (Repository)
│ └── services/ # AlertasService, GraficosService
│
└── infrastructure/ # Implementaciones
├── adapters/ # DolarAPI, Historicos, Inflacion, Monedas
├── errors.py # Excepciones personalizadas
├── logging.py # Logging estructurado
├── retry.py # Retry con backoff exponencial
└── mcp/ # Server, Tools, Resources, PromptsClean Architecture: Dependencias apuntan hacia el dominio.
Desarrollo
# Tests (sin slow/integration)
pytest -m "not slow"
# Tests con coverage
pytest --cov=mcp_argentina --cov-report=html
# Lint
ruff check .
# Type check
mypy mcp_argentina
# Format
ruff format .Stats
✅ 180 tests
✅ 78% coverage
✅ Python 3.10, 3.11, 3.12
✅ Type-safe (mypy)
✅ CI/CD GitHub Actions
Roadmap
Cotizaciones dólar en tiempo real
Históricos de cotizaciones
Inflación (INDEC)
Riesgo país
Monedas extranjeras
Alertas de precio
Gráficos ASCII
Conversiones
Logging estructurado
Retry con backoff
WebSocket para updates real-time
Publicar en PyPI
Publicar en ClawHub
Licencia
MIT
Creado por: greydina
Versión: 0.1.0
This server cannot be deployed
Maintenance
Related MCP Connectors
Real-time Argentine open data: dollar rates, BCRA, INDEC, AFIP, INFOLEG, SEPA prices. 24+ tools.
Live Argentina data: dolar rates, quiniela and lotteries, holidays, river levels, inflation, news.
Datos econ�micos y financieros oficiales de Argentina (BCRA, INDEC, CNV, MECON), AI-ready.
Unlock the power of real-time cryptocurrency data with our Crypto Price Insights MCP server.
Related MCP Servers
- FlicenseBqualityDmaintenanceA Model Context Protocol server that provides tools to access information about Argentina through the Argentina Datos API, including holidays, presidential events, dollar exchange rates, and legislative data.134-
- AlicenseAqualityCmaintenanceReal-time Argentine exchange rates for AI agents. Dollar blue, oficial, MEP, CCL, crypto rates plus currency conversion and spread calculator.69 npm5MIT
- FlicenseNot gradedqualityDmaintenanceMCP server for Chilean financial regulation, providing economic indicators (UF, dollar, euro, UTM) and fraud alerts from CMF and mindicador.cl.2-
- AlicenseAqualityBmaintenanceMCP server providing official US economic data including CPI inflation, famous prices, national debt, and Treasury interest rates. Enables AI agents to query historical and latest economic statistics via natural language.824 npmMIT