# OpenArg MCP

> Servidor MCP público de OpenArg: acceso a más de 30.000 datasets públicos oficiales de Argentina (INDEC, datos.gob.ar, provincias, municipios, Congreso, presupuesto). Modo datos: buscar, describir y leer tablas. Modo respuestas: preguntas en lenguaje natural respondidas con fuentes citadas.

- Endpoint MCP (Streamable HTTP): https://mcp.openarg.org/mcp
- Autenticación: header `Authorization: Bearer oarg_sk_…`. Clave gratis en https://openarg.org/desarrolladores
- Cupo: modo datos 200 pedidos/día (30/min, hasta 500 filas por pedido); modo respuestas 10 preguntas/día. Se renueva a las 00:00 UTC.

## Si sos un agente de IA y te pidieron conectar OpenArg

1. Clave: la del usuario, empieza con `oarg_sk_`. Buscala en la variable de entorno `OPENARG_API_KEY` o en las credenciales de tu configuración. Si no existe, pedile al usuario que la cree gratis en https://openarg.org/desarrolladores y que la cargue él en tu configuración. No la escribas en archivos que se suban a un repositorio ni la repitas en el chat.
2. Registrá un servidor MCP remoto:
   - Transporte: Streamable HTTP.
   - URL: `https://mcp.openarg.org/mcp`
   - Header: `Authorization: Bearer <clave>`
   - Claude Code: `claude mcp add --transport http openarg https://mcp.openarg.org/mcp --header "Authorization: Bearer $OPENARG_API_KEY"`
   - Clientes con `mcpServers` en JSON (Cursor y similares): `{"openarg": {"url": "https://mcp.openarg.org/mcp", "headers": {"Authorization": "Bearer <clave>"}}}`
   - Clientes que sólo corren servidores locales: `npx -y mcp-remote https://mcp.openarg.org/mcp --header "Authorization: Bearer <clave>"`
3. Si tu entorno no habla MCP, usá la API HTTP con la misma clave y el mismo cupo:
   - `POST https://api.openarg.org/api/v1/ask` con `{"question": "..."}`
   - `GET https://api.openarg.org/api/v1/catalogo/buscar?q=...`
   - `GET https://api.openarg.org/api/v1/catalogo/tabla?nombre=...`
   - `POST https://api.openarg.org/api/v1/catalogo/datos` con `{"tabla": "...", "desde": "AAAA-MM", "limite": 100}`
4. Probá la conexión con `listar_fuentes`: cuenta como un pedido del modo datos y no gasta preguntas.
5. Flujo recomendado: `buscar_datasets` → `describir_tabla` → `obtener_datos`. Usá `consultar_datos_publicos` sólo cuando la pregunta cruce varias tablas. Citá siempre la fuente (link oficial) que devuelve cada herramienta.

## Herramientas

Modo datos (el modelo del usuario razona con las filas):

- `buscar_datasets(texto, portal?, limite?)`: datasets con título, portal, link oficial y tablas consultables.
- `describir_tabla(tabla)`: columnas con tipo, filas, período cubierto y muestra.
- `obtener_datos(tabla, columnas?, desde?, hasta?, filtros?, orden?, limite?)`: filas en CSV con la fuente. Sin SQL: columnas, período AAAA[-MM[-DD]] y filtros de igualdad.
- `listar_fuentes()`: portales cubiertos y cantidad de datasets.

Modo respuestas (OpenArg razona):

- `consultar_datos_publicos(pregunta: str)`: respuesta en Markdown con fuentes (link al portal oficial), advertencias y preguntas restantes. Descuenta 1 de las 10 diarias.

## Docs

- [Empezar](https://mcp.openarg.org/empezar.html): clave y configuración de Claude Code, Claude Desktop, Cursor y VS Code
- [Herramientas](https://mcp.openarg.org/herramientas.html): referencia y API HTTP equivalente
- [Límites y privacidad](https://mcp.openarg.org/limites.html)