OpenArg MCPpor Colossus Lab Conseguí tu clave

02 / 03 Referencia

Cinco herramientas, dos modos.

El servidor https://mcp.openarg.org/mcp usa el transporte Streamable HTTP. Todas las herramientas son de solo lectura.

01

Modo datos

Tu asistente busca, mira y trae las filas, y razona él. No descuenta preguntas.

200pedidos por día
  • buscar_datasets
  • describir_tabla
  • obtener_datos
  • listar_fuentes
02

Modo respuestas

OpenArg arma la respuesta, cruza tablas y verifica los números.

10preguntas por día
  • consultar_datos_publicos

Datosbuscar_datasets

Busca en el catálogo (más de 30.000 datasets de portales oficiales), por significado y por palabras.

ParámetroTipoDescripción
textotextoLo que buscás: "tasas de interés BCRA", "matrícula escolar CABA".
portaltexto, opcionalLimita a un portal (ver listar_fuentes).
limitenúmero, opcionalDe 1 a 25. Por defecto 10.

Devuelve título, portal, descripción, link a la fuente oficial y las tablas consultables de cada dataset, con su cantidad de filas.

Datosdescribir_tabla

Todo lo necesario para pedir bien los datos de una tabla.

ParámetroTipoDescripción
tablatextoEl nombre que devolvió buscar_datasets.

Devuelve las columnas con su tipo, la cantidad de filas, el período cubierto (si tiene fechas), una muestra de 5 filas y la fuente oficial.

Datosobtener_datos

Trae filas de una tabla, en CSV. No se escribe SQL: se eligen columnas, período y filtros.

ParámetroTipoDescripción
tablatextoLa tabla, como la devuelve buscar_datasets.
columnaslista, opcionalNombres exactos de describir_tabla. Por defecto, todas (hasta 30).
desde / hastatexto, opcionalPeríodo: AAAA, AAAA-MM o AAAA-MM-DD.
filtrosobjeto, opcionalIgualdad exacta por columna, hasta 5: {"provincia": "Córdoba"}.
ordentexto, opcionalasc o desc, por fecha.
limitenúmero, opcionalDe 1 a 500 filas. Por defecto 100.

Devuelve las filas en CSV, la fuente oficial con su link y un aviso si hay más filas que las pedidas.

Respuestasconsultar_datos_publicos

Responde una pregunta sobre datos públicos oficiales de Argentina, con fuentes.

ParámetroTipoDescripción
preguntatextoLa pregunta en lenguaje natural, hasta 2.000 caracteres. Mejor en castellano y concreta.

Devuelve un texto en Markdown con:

Cupo: descuenta 1 de las 10 preguntas diarias, aunque la pregunta termine sin datos.

Tarda entre unos segundos y un minuto, según cuántas tablas tenga que cruzar.

Datoslistar_fuentes

Lista los portales de datos abiertos que cubre OpenArg y cuántos datasets tiene indexados cada uno. No lleva parámetros.

Cupo: cuenta como un pedido del modo datos.

Errores

Los errores vuelven como error de herramienta (isError: true) con un mensaje en castellano que el asistente le puede mostrar al usuario. La tabla está en Empezar.

Sin MCP

La misma clave sirve para la API HTTP, con el mismo cupo:

modo respuestas
curl https://api.openarg.org/api/v1/ask \
  -H "Authorization: Bearer oarg_sk_TU_CLAVE" \
  -H "Content-Type: application/json" \
  -d '{"question": "tasa de desempleo del último trimestre"}'

Devuelve JSON con answer, sources, citations, warnings, chart_data, map_data y usage.

Y el modo datos, en JSON:

modo datos
curl -G https://api.openarg.org/api/v1/catalogo/buscar \
  -H "Authorization: Bearer oarg_sk_TU_CLAVE" --data-urlencode "q=tasas de interés"

curl -G https://api.openarg.org/api/v1/catalogo/tabla \
  -H "Authorization: Bearer oarg_sk_TU_CLAVE" --data-urlencode "nombre=TABLA"

curl https://api.openarg.org/api/v1/catalogo/datos \
  -H "Authorization: Bearer oarg_sk_TU_CLAVE" -H "Content-Type: application/json" \
  -d '{"tabla": "TABLA", "desde": "2026-01", "limite": 100}'