阿根廷数据MCP服务器

为AI代理提供阿根廷实时数据的MCP服务器,涵盖美元汇率、BCRA货币变量、INDEC经济指标、税务立法、AFIP纳税人查询及节假日等,适用于开发者和数据分析师快速接入阿根廷官方数据。

  • by abenassi
  • TypeScript
  • 混合部署
  • 7 星标
  • 更新于
在 GitHub 查看 abenassi/argentina-data-mcp

使用说明

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.

🌐 Sitio del proyecto → argentinadata.mymcps.dev

Conectá Claude o ChatGPT en 2 clicks, conocé las tools disponibles y los planes. · 📊 Status · ✉️ hola@argentinadata.mymcps.dev

English: argentinadata.mymcps.dev/en · Plan Free: 20 consultas por día sin tarjeta · Plan Pro: ARS 1.100 por mes.

Qué podés preguntar, tema por tema

Cada tema tiene su página con los prompts reales, las fuentes y la frecuencia de actualización (también en inglés):

Dólar · Inflación · Indicadores económicos · Monotributo · CUIT y padrón de ARCA · Vencimientos y feriados · Legislación y Boletín Oficial · Precios de supermercados · Combustibles · Comercio exterior · Censo 2022 · Elecciones

Y según quién sos: contadores, monotributistas, analistas económicos, inversores, periodistas y desarrolladores. Para agentes: llms.txt.

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.

Hecho con Argentina Data

Aplicaciones construidas sobre este MCP. Código abierto, para que copies el patrón. Muestran las dos formas de pagar las consultas: en la calculadora el autor las paga todas con su key; en Coyuntura agrícola cada visitante entra con su cuenta y usa su propia cuota.

  • Calculadora de inflación de Argentina: Ajustá cualquier monto por inflación y mirá el cálculo mes por mes. Nunca mezcla un dato publicado del INDEC con una estimación: te dice cuál es cuál. Un GitHub Action baja un snapshot diario del MCP con la key del autor, que paga todas las consultas; el sitio es estático y el visitante no necesita cuenta. (código, por Agustín Benassi)
  • Coyuntura agrícola: Soja, maíz, trigo y girasol: cómo terminó la campaña contra la anterior, qué provincias lideran, la evolución del rinde y un mapa por departamento. Consulta el MCP en vivo desde el navegador, sin backend: cada visitante entra con su cuenta de Argentina Data (OAuth) y usa su propia cuota. (código, por Agustín Benassi)

¿Hiciste algo con Argentina Data? Contanos qué hiciste. Pedimos tres cosas: que use datos del MCP, que esté online y que cite la fuente. Curamos a mano, no hay obligación de publicar.

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.