Argentina Data MCP

MCP server que expone datos argentinos en tiempo real para agentes de IA: cotizaciones del dólar, variables del BCRA, estadísticas del INDEC, legislación de InfoLeg, datos de AFIP, legislación tributaria, feriados nacionales, y más.

Conectar desde Claude.ai

Agregá este MCP server como conector HTTP en tu cuenta de Claude:

URL: https://argentinadata.mymcps.dev/mcp

Status page: https://stats.uptimerobot.com/lTLP3Efkud

Tools disponibles

Datos financieros

| Tool | Descripción | Estado | |------|-------------|--------| | dolar_cotizaciones | Cotizaciones actuales del dólar (oficial, blue, MEP, CCL, cripto, tarjeta, mayorista) | ✅ Stable | | dolar_historico | Evolución histórica del dólar (7 tipos, desde 2024). Fuente: Ámbito Financiero | ✅ Stable | | bcra_tipo_cambio | Variables monetarias del BCRA: dólar oficial/mayorista, reservas, BADLAR, TM20, inflación mensual/interanual, base monetaria, circulación monetaria, ICL | ✅ Stable | | indec_stats | Indicadores INDEC: IPC, IPC núcleo, EMAE, salarios, construcción (ISAC), industria (IPI) | ✅ Stable |

Legislación y datos fiscales

| Tool | Descripción | Estado | |------|-------------|--------| | infoleg_search | Búsqueda full-text en 420K+ normas de InfoLeg (leyes, decretos, resoluciones) | ✅ Stable | | boletin_oficial_search | Búsqueda en el Boletín Oficial (decretos, resoluciones, disposiciones por sección y fecha) | ✅ Stable | | legislacion_tributaria | Datos estructurados de legislación tributaria: monotributo (categorías A-K), ganancias (deducciones, escalas), IVA (alícuotas) | ✅ Stable | | afip_search_by_name | Búsqueda en el padrón de AFIP (~6M contribuyentes) por nombre o razón social. Devuelve CUIT, estado, categorías impositivas | ✅ Stable |

Utilidades

| Tool | Descripción | Estado | |------|-------------|--------| | feriados_nacionales | Feriados nacionales por año/mes, incluyendo inamovibles, trasladables y puentes. Calcula días hábiles | ✅ Stable | | data_health | Estado de salud de todas las fuentes de datos con última actualización y smoke tests | ✅ Stable |

Discovery

| Tool | Descripción | Estado | |------|-------------|--------| | list_dolar_tipos | Lista los tipos de dólar disponibles y qué tools los soportan | ✅ Stable | | list_bcra_variables | Lista todas las variables BCRA con unidades y descripciones | ✅ Stable | | list_indec_indicadores | Lista los indicadores INDEC disponibles con IDs de serie | ✅ Stable |

Ejemplos de uso

Cotizaciones del dólar

"¿A cuánto está el dólar blue hoy?"

Usa dolar_cotizaciones — devuelve las 7 cotizaciones actuales con compra, venta y variación.

Evolución del dólar blue

"Mostrame cómo evolucionó el dólar blue en los últimos 6 meses"

Usa dolar_historico con tipo: "blue" y fecha_desde.

Variables del BCRA

"¿Cuánto crecieron las reservas del BCRA en el último año?"

Usa bcra_tipo_cambio con variable: "reservas" y fecha_desde.

Inflación

"¿Cuál fue la inflación de febrero 2026?"

Usa indec_stats con indicador: "ipc".

Legislación

"Buscá leyes sobre monotributo"

Usa infoleg_search con query: "monotributo". Los resultados priorizan normativa reciente.

Datos tributarios

"¿Cuáles son las categorías del monotributo?"

Usa legislacion_tributaria con tipo: "monotributo" — devuelve categorías A-K con límites y cuotas.

Búsqueda de contribuyentes

"Buscá empresas con el nombre Mercado Libre en AFIP"

Usa afip_search_by_name con nombre: "Mercado Libre" — busca por similitud en el padrón.

Feriados

"¿Cuántos días hábiles tiene abril 2026?"

Usa feriados_nacionales con year: 2026 y month: 4.

Diagnóstico

"¿Están funcionando todas las fuentes de datos?"

Usa data_health — reporta estado, última actualización y registros de cada fuente.

Instalación local

Requisitos

Node.js 20+
PostgreSQL 16 (puede correr en Docker)

Setup

git clone https://github.com/abenassi/argentina-data-mcp.git
cd argentina-data-mcp
npm install
npm run build

# Levantar PostgreSQL
docker run -d --name argentina-data-pg --restart unless-stopped \
  -e POSTGRES_USER=argdata -e POSTGRES_PASSWORD=argdata_dev_2026 \
  -e POSTGRES_DB=argentina_data -p 5432:5432 \
  -v argentina-data-pgdata:/var/lib/postgresql/data postgres:16-bookworm

# Crear tablas
psql -h localhost -U argdata -d argentina_data -f sql/001_create_tables.sql

# Configurar .env
cp .env.example .env

# Cargar datos iniciales
npm run collector        # Corre collectors una vez y queda escuchando
npm run import:infoleg   # Importa 420K+ normas (una sola vez)
npm run backfill:bcra    # Carga 2+ años de historia BCRA
npm run backfill:dolar-historico  # Carga 2+ años de cotizaciones históricas

Ejecutar

# MCP server (stdio, para Claude Desktop / Claude Code)
npm start

# MCP server (HTTP, para Claude.ai web/mobile)
npm run start:http

Claude Desktop / Claude Code

{
  "mcpServers": {
    "argentina-data": {
      "command": "node",
      "args": ["/path/to/argentina-data-mcp/dist/index.js"],
      "env": {
        "PGHOST": "localhost",
        "PGPORT": "5432",
        "PGUSER": "argdata",
        "PGPASSWORD": "your_password",
        "PGDATABASE": "argentina_data"
      }
    }
  }
}

Fuentes de datos

| Fuente | Datos | Frecuencia | |--------|-------|------------| | DolarAPI.com | Cotizaciones actuales (7 tipos) | Cada 15 min | | Ámbito Financiero | Cotizaciones históricas (7 tipos, 2+ años) | Diario | | BCRA API v4 | Variables monetarias (10 variables, 2+ años) | Cada hora | | datos.gob.ar | Series INDEC (IPC, EMAE, salarios, etc.) | Diario | | InfoLeg | Normativa nacional (420K+ normas) | Dump CSV | | Boletín Oficial | Publicaciones oficiales (decretos, resoluciones) | Diario (L-V) | | AFIP Padrón | Padrón de contribuyentes (~6M registros) | Periódico |

Tests

npm test                 # Unit + integration tests
npm run test:integration # Solo integration tests (requiere PostgreSQL)

License

PolyForm Noncommercial 1.0.0 — ver LICENSE.

Uso personal, educativo y de investigación permitido. Uso comercial requiere autorización previa del autor.

Argentina Data