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
Conexión remota
Agregá el servidor MCP por URL en tu cliente. Autorizás una sola vez por el navegador con tu cuenta de Almanac (OAuth); no hace falta instalar nada ni pegar API keys.
https://mcp.almanac.ar/mcp
Claude (web y escritorio)
- Ajustes → Conectores → Agregar conector personalizado.
- Pegá la URL
https://mcp.almanac.ar/mcp. - Autorizá con tu cuenta de Almanac cuando se abra el navegador.
ChatGPT, Cursor, VS Code, Gemini
El mecanismo es el mismo: agregar un servidor MCP remoto por URL y autorizar por OAuth. Sólo cambia dónde se carga en cada app — seguí la documentación de MCP de tu cliente y usá la URL de arriba.
Paquete local
Para clientes sin soporte de MCP remoto o entornos controlados, el paquete almanac-mcp (PyPI) corre local y se autentica con una API key.
uvx almanac-mcp # uso efímero pip install almanac-mcp # instalación persistente
La API key se genera en /account/api-keys (requiere plan Pro+ o Enterprise). Para Cursor, VS Code y otros, ver el README del paquete.
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 de snapshot.
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_get
- Devuelve un Texto Ordenado (TO) del BCRA por id, con su estructura y secciones.
- regulatory_to_diff
- Diferencias entre dos versiones de un Texto Ordenado del BCRA.
- regulatory_to_search
- Búsqueda full-text sobre el corpus de Textos Ordenados del BCRA.
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 MCP server externo está incluido en Pro+ (USD 1.500/mes, single-user) y Enterprise (desde USD 2.500/mes, multi-user + SSO + SLA). El plan Pro (USD 499/mes) incluye chat por dataset en la web pero NO el MCP server externo — esa diferencia es lo que distingue Pro+ de Pro.
La prueba de 7 días incluye Pro completo. Para evaluar el MCP antes de contratar Pro+, coordinar acceso anticipado vía mail.
contacto@almanac.arEmpezar ahora
Creá cuenta, contratá Pro+ y generá tu primera API key en menos de un minuto. El agente ya tiene contexto sobre BCRA, INDEC, CNV y SEC.