Servidor MCP

Almanac dentro de tu agente de IA.

El Model Context Protocol (MCP) es un estándar abierto para conectar asistentes de IA a fuentes de datos. El servidor MCP de Almanac expone el catálogo completo a Claude Desktop, Cursor, GitHub Copilot, Gemini CLI y cualquier cliente compatible. Tu agente consulta datasets argentinos validados, corre SQL sub-segundo y devuelve resultados directos — sin pegarte ningún archivo para que lo abras a mano.

Conexión

Es el mismo servidor remoto para todos los clientes — https://mcp.almanac.ar/mcp — y sólo cambia cómo te autenticás.

Recomendadocon tu cuenta · sin API key

Con tu cuenta (OAuth) — Claude y ChatGPT

Para asistentes interactivos. Agregás el servidor por URL y autorizás una sola vez por el navegador con tu cuenta de Almanac; no hace falta instalar nada ni pegar API keys.

https://mcp.almanac.ar/mcp

Ajustes → Conectores → Agregar conector personalizado.
Pegá la URL https://mcp.almanac.ar/mcp.
Autorizá con tu cuenta de Almanac cuando se abra el navegador.

para editores y agentes

Con API key — Cursor, Codex, Copilot, Gemini

Misma URL, pero la identidad va en un header Authorization: Bearer alm_... con tu API key (sin el flujo OAuth de navegador). La key se genera en /account/api-keys. Las plantillas de configuración por cliente están en Desarrolladores · MCP.

Dado de baja

MCP local

El paquete local almanac-mcp (PyPI / extensión para Claude Desktop) está dado de baja. Migrá a una de las dos conexiones de arriba: con tu cuenta (Claude/ChatGPT) o con API key (Cursor/Codex/Copilot/Gemini).

Ejemplos

Una vez conectado, le pedís a tu agente cosas como:

“¿Cómo evolucionó el tipo de cambio mayorista del BCRA en los últimos 90 días?”
“Traé la inflación mensual del IPC Nacional (INDEC) de 2024 y 2025 y compará por región.”
“¿Qué dice el Texto Ordenado del BCRA sobre un tema y qué comunicación lo modificó por última vez?”

El agente descubre el dataset con catalog_list, lee su ficha y corre el SQL — el dato vuelve con su fuente oficial y fecha.

Tools disponibles

catalog_list: Lista los datasets publicados (o la ficha completa de uno) con schema inline, business questions, gotchas y ejemplos. Es el punto de descubrimiento.
catalog_get: Ficha completa de un dataset por id, incluido el nombre exacto de la tabla en Postgres y el schema de columnas. Devuelve lo mismo que catalog_list aplicado a un dataset puntual.
data_summary: Caracterización rápida: row count total y min/max/distinct de columnas clave, para entender la cobertura antes de samplear.
data_distinct_values: Top-N valores distintos de una columna categórica, con búsqueda por substring (resuelve 'qué id_variable es Reservas').
data_snapshot_url: URL firmada al Parquet (o CSV) del snapshot vigente completo, para bajar el dataset entero y trabajarlo local.Límite: URL válida 60 min
data_query: Ejecuta SQL SELECT/WITH/EXPLAIN contra las tablas de Almanac en Postgres; soporta JOINs cross-dataset con latencia sub-segundo.Límite: hasta 50.000 filas / 60 s
data_query_parquet: SQL (DuckDB) sobre el Parquet en R2 de un dataset parquet-only. Por defecto consulta el último snapshot (foto vigente); con all_snapshots=true recorre toda la historia para comparaciones point-in-time.Límite: hasta 100.000 filas / 120 s
regulatory_to_search: Búsqueda híbrida (FTS léxico + semántica Voyage) sobre el corpus regulatorio argentino unificado (CNV, UIF, BCRA-comunicaciones, BORA), devuelve texto verbatim con provenance.
boletines_search: Búsqueda por texto libre sobre el CUERPO COMPLETO de los boletines oficiales (Nación + 20 provincias) — a diferencia de data_query sobre las vistas boletin.*, que solo ve un excerpt de 600 caracteres por aviso. Devuelve snippet + metadata + texto_url al documento íntegro.

Todas las invocaciones se loguean en mcp_invocations por user_id, tool, latencia y status. El usuario ve su propia telemetry; nosotros usamos los agregados para detectar patrones, optimizar costos y planificar rate limits.

Plan requerido

El acceso al servidor MCP externo (API keys autenticadas, consumo desde Claude Desktop, Cursor u otro cliente) varía según el plan — mirá el detalle y las cuotas de cada uno en Planes y precios.

La prueba de 7 días incluye acceso completo. Para evaluar el MCP antes de contratar, coordiná acceso anticipado vía mail.

contacto@almanac.ar

Problemas frecuentes

No completa la conexión o falla la autorización: Quitá el conector y volvé a agregarlo con la URL https://mcp.almanac.ar/mcp, y reautorizá por el navegador. La autorización es OAuth con tu cuenta de Almanac (sin API key ni 2FA).
Las tools no aparecen o responden distinto a lo esperado: Reconectá el conector o abrí una conversación nueva: la lista de tools y las instrucciones del servidor se cargan al momento de conectar.
Una consulta devuelve un error: El servidor responde con un mensaje claro. Revisá la ficha del dataset con catalog_list(dataset_id) para confirmar columnas y valores antes de reintentar el SQL.
No tenés acceso al MCP: El acceso al servidor MCP externo depende del plan (ver Planes y precios).

¿Otro problema o querés reportar algo? Escribinos a contacto@almanac.ar.

Empezar ahora

Creá cuenta, elegí tu plan y generá tu primera API key en menos de un minuto. El agente ya tiene contexto sobre BCRA, INDEC, CNV y SEC.

Ver planes