# OpenArg — Argentina public data [Health: Active]

**Category:** 💻 Developer Tools  
**Repository:** https://github.com/colossus-lab/openarg-mcp  
**GitHub Stars:** 0  
**Views:** 0  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/openarg-argentina-public-data

## Description
Argentina's official public data (INDEC, BCRA, 38 portals): search, read tables, cited answers.

## Tools
Capabilities this server exposes over MCP:

- **consultar_datos_publicos** — Responde una pregunta sobre datos públicos oficiales de Argentina, con fuentes.

Ejemplos: "¿Cuál fue la tasa de desempleo del último trimestre?",
"Evolución del IPC en 2025", "¿Cuántos diputados tiene cada bloque?",
"Presupuesto ejecutado por el Ministerio de Salud en 2024".
La respuesta incluye los datasets usados (con link al portal oficial),
advertencias sobre la calidad o cobertura del dato, y cuántas preguntas
le quedan este mes al usuario. Cada respuesta descuenta 1 de sus preguntas
del mes (10 gratis); un error, un corte por tiempo o la misma pregunta
repetida dentro de los 5 minutos no descuentan. Si podés responder con
`buscar_datasets` + `obtener_datos` o `agregar_datos`, preferí esas.
- **listar_fuentes** — Lista los portales de datos abiertos que cubre OpenArg y cuántos datasets tiene cada uno.

No descuenta preguntas: cuenta como un pedido del modo datos.
- **buscar_datasets** — Busca en el catálogo de OpenArg (más de 30.000 datasets de portales oficiales).

Devuelve título, portal, descripción, link a la fuente oficial y las tablas
consultables de cada dataset (usalas con `describir_tabla` y `obtener_datos`).
`texto` es lo que buscás, en castellano ("tasas de interés BCRA", "matrícula
escolar CABA"). `portal` filtra por portal (ver `listar_fuentes`).
`limite` entre 1 y 25. No descuenta preguntas.
- **describir_tabla** — Muestra las columnas (con su tipo), cantidad de filas, período cubierto, frescura y una muestra de una tabla.

`tabla` es el nombre que devuelve `buscar_datasets`. Usalo antes de
`obtener_datos` o `agregar_datos` para saber qué columnas pedir y qué
fechas existen. La frescura dice cuándo leyó OpenArg la tabla de su fuente,
cuál es el último dato y, sólo si la tabla es una foto del período en curso,
su fecha de corte. La fecha de lectura no es la de los datos: una tabla de
un período pasado o sin columna de fecha no es vigente por haberse leído
hoy. No presentes como actual un dato viejo. No descuenta preguntas.
- **obtener_datos** — Trae filas de una tabla, en CSV, con la fuente oficial.

Para un total, promedio, conteo, mínimo, máximo o ranking NO traigas filas para
sumarlas: usá `agregar_datos`.
- `columnas`: las que quieras (por defecto, todas); nombres exactos de `describir_tabla`.
- `desde` / `hasta`: período, como AAAA, AAAA-MM o AAAA-MM-DD, sobre la columna de
  fecha (o de año).
- `filtros`: hasta 5. Igualdad: {"provincia": "Córdoba"}. Con operador, una lista:
  [{"columna": "monto", "operador": "mayor_que", "valor": "1000000"},
  {"columna": "provincia", "operador": "en", "valores": ["Salta", "Jujuy"]}].
  Operadores: =, !=, mayor_que, menor_que, >=, <=, contiene y en. La igualdad y
  `contiene` no distinguen mayúsculas ni acentos (en tablas de más de un millón de
  filas, sí: ahí la respuesta dice en `filtros_aplicados` qué se buscó tal cual).
- `orden`: "asc" (por defecto: primero lo más viejo) o "desc" (primero lo más
  reciente), por fecha. Para el último dato de una serie, pedí "desc".
- `limite`: 1 a 500 filas. Si hay más, la respuesta lo dice y da el `offset` de la
  página siguiente (hasta 10.000).
- `columna_fecha`: opcional, otra columna de fecha para `desde`/`hasta` y el orden.
Si ninguna fila cumple los filtros, la respuesta dice qué valores existen.
No descuenta preguntas.
- **agregar_datos** — Calcula en la base una suma, promedio, conteo, mínimo o máximo, opcionalmente agrupado.

Usala SIEMPRE que necesites un total, un promedio, un conteo, un mínimo/máximo o un
ranking, en vez de traer filas con `obtener_datos` y hacer la cuenta vos: es exacta,
no tiene el tope de 500 filas y gasta muchos menos tokens.
- `operacion`: "suma", "promedio", "conteo", "minimo" o "maximo".
- `columna`: la que se suma/promedia/etc. (nombres exactos de `describir_tabla`); no
  va con "conteo", que cuenta filas (si la mandás, da error). Las columnas de texto
  con números se leen según su formato (1.234,5 o 1,234.5); si el formato es
  ambiguo, no calcula y lo dice.
- `agrupar_por`: hasta 3 columnas, p. ej. ["jurisdiccion_desc"] para un ranking.
- `filtros`, `desde`, `hasta`, `columna_fecha`: como en `obtener_datos` (hasta 6 filtros).
- `ordenar_por`: "valor" (por defecto, para rankings) o una columna de `agrupar_por`
  (p. ej. el año, para una serie). `orden`: "desc" (por defecto) o "asc".
- `limite`: grupos a devolver, 1 a 200.
- `ponderar_por`: la columna de ponderación de una encuesta (con "conteo" da la
  población estimada, no la cantidad de filas de la muestra).
La respuesta dice sobre cuántas filas se calculó (`filas_usadas`, de todos los
grupos) y si hay más grupos que `limite`. Si ninguna fila cumple los filtros no hay
valor: dice qué valores existen. No descuenta preguntas.

## Claude Desktop Quick Installation
No confirmed install details yet, so no config is published. Follow the setup steps in the repository above.

## Documentation

## What OpenArg — Argentina public data MCP server does

OpenArg — Argentina public data MCP server gives an MCP-compatible assistant access to more than 33,000 datasets published through 38 Argentine government portals. Coverage includes INDEC, the Central Bank of Argentina, national ministries, provincial and municipal sources, and Congress. The service returns dataset titles, portal information, official source links, and table data or metadata where available.

The server supports two usage patterns. In data mode, the assistant searches the catalog, examines table structure, retrieves selected rows, and performs calculations. In answers mode, `consultar_datos_publicos` answers a question in natural language, selects and cross-references relevant tables, and includes sources, links, data-quality or coverage warnings, and remaining answer quota.

## How it works

The hosted MCP endpoint is `https://mcp.openarg.org/mcp` and uses Streamable HTTP. Clients send an `Authorization: Bearer oarg_sk_...` header with a key obtained from the OpenArg developer page. The service is read-only: its tools search and analyze published information but do not modify government datasets.

For reproducible table work, begin with `buscar_datasets`, then use `describir_tabla` to confirm column names, types, row count, date coverage, freshness, and a sample. Retrieve matching rows with `obtener_datos`, or use `agregar_datos` for sums, averages, counts, minimums, maximums, and grouped rankings. Aggregation runs in the database and avoids the 500-row retrieval limit.

## Setup and configuration

Add the hosted endpoint to an MCP client with the API key in the authorization header. The README provides configurations for Claude Code, Cursor, Claude Desktop through `mcp-remote`, and VS Code. A custom agent can use the same endpoint and place its key in `OPENARG_API_KEY`; the setup can then be tested with `listar_fuentes`.

Self-hosting the repository is not a standalone replacement for the hosted service. The code forwards requests to an OpenArg backend, so a local deployment needs a backend configured through `BACKEND_URL`. Authentication and quota enforcement are handled by that backend rather than by the MCP server process.

## Tools and capabilities

- `listar_fuentes` reports covered open-data portals and the number of datasets in each. It does not consume question quota.
- `buscar_datasets` searches more than 30,000 catalog entries by Spanish text and can filter by portal. Results include queryable table names and official links.
- `describir_tabla` exposes schema details, row count, covered period, freshness information, and a sample before data retrieval.
- `obtener_datos` returns CSV rows with selected columns, date ranges, filters, ordering, pagination, and up to 500 rows per request. It supports equality, comparison, substring, and membership filters.
- `agregar_datos` calculates database-side sums, averages, counts, minimums, or maximums, optionally grouped by up to three columns. It supports date and filter constraints, ranking order, result limits, and survey weighting.
- `consultar_datos_publicos` handles natural-language questions and attaches the datasets used, official links, warnings, and remaining monthly questions.

## Limitations and notes

The standard allowance is 200 data-mode requests per month and 10 answer-mode questions per month. Data mode is limited to 30 requests per minute and 500 returned rows per request; answer mode is limited to two questions per minute. Quotas reset on the first day of each month at 00:00 UTC. When a quota is exhausted, available credits may be used; otherwise the API returns HTTP 402 with the reset date.

An answer-mode question consumes one question except when it errors, times out, or repeats the same question within five minutes. Data-mode tools do not consume answer questions. The answers mode uses a language model, so users should check the linked official source before publishing a figure. Freshness metadata distinguishes when a table was read from the date of the underlying data; a recently read table is not necessarily current.

OpenArg — Argentina public data server tools and outputs are in Spanish, although the assistant may be prompted in another language. The repository is licensed under MIT.

_Full upstream README: https://allmcps.com/mcp/openarg-argentina-public-data/readme_