CLI + MCP

Tus datos, dentro de cualquier agente

Calliope Data habla CLI y MCP. Conecta los datos de tu negocio a Claude, ChatGPT, Gemini, Cursor o a tu propio harness — respuestas en lenguaje natural con fuentes citadas, y reglas de negocio que tu agente no puede saltarse.

Ver en GitHub Pedir Demo

brew install Calliope-AI/tap/calliope
calliope auth login --api-key <clave>
calliope orgs use acme
calliope ask "¿cómo van las ventas este trimestre?"

¿Prefieres no instalar nada? Añade este servidor MCP a tu agente: https://mcp.calliope.so/mcp

Funciona con los agentes que ya usas

Cualquiera que hable MCP sobre HTTP, o que pueda ejecutar un binario de tu PATH.

Claude Code
Claude Desktop
ChatGPT
Gemini
Cursor
ElevenLabs
Tu propio harness

Línea de comandos

Calliope en tu terminal

Veintidós comandos: dieciséis en seis grupos — auth, orgs, config, docs, concepts, rules — más ask, query, schema, doctor, skill y version. Todos devuelven el mismo envelope, y los breadcrumbs te dicen cuál es el siguiente comando.

Legible en el terminal, JSON en una tubería — automáticamente
--json, --quiet, --md, --jq '<expr>' — el filtro va dentro del binario, así que no hace falta jq — y --csv en calliope query
Códigos de salida estables: 0 correcto · 1 error · 2 uso incorrecto · 3 no autorizado · 4 no encontrado · 5 límite superado
Configuración por capas — flags, variables CALLIOPE_*, fichero de proyecto y global. calliope config list muestra de qué capa viene cada valor

{"ok": true, "data": [...], "summary": "12 documentos",
 "breadcrumbs": [{"action": "show",
                  "cmd": "calliope docs show <id>"}]}

Agentes de código

El skill viaja dentro del binario

calliope skill imprime el SKILL.md completo — invariantes, catálogo de comandos y recetas — tal como lo empaquetó la versión instalada. Un test compara su catálogo de comandos con el árbol de comandos real y rompe la build si divergen, así que no puede desincronizarse del binario al que tu agente está llamando.

Un plugin de Claude Code que instala el skill y un comando /calliope
Avisa al empezar la sesión si falta el binario o la credencial
Los skills de dominio son Markdown plano que componen comandos — sin tocar Go
calliope doctor diagnostica instalación, credencial y conectividad

calliope skill

Model Context Protocol

Calliope como servidor MCP remoto

Apunta tu agente al servidor alojado. Dos formas de entrar, las dos disponibles hoy.

URL del servidor: https://mcp.calliope.so/mcp

OAuth 2.1

Clientes como Claude, ChatGPT o Gemini: pega la URL, inicia sesión y elige tu organización. Registro dinámico de clientes y PKCE S256. La organización sale del token, nunca de una cabecera.

Clave de API

Servidores y agentes de voz como ElevenLabs envían su propia clave. Calliope no almacena credenciales: solo las relaya. La clave se crea en el UI de Calliope Data, en Claves de API.

X-Calliope-Api-Key: <tu clave>
X-Calliope-Org:     <organización>

Herramienta	Qué hace
ask_calliope	Preguntas en lenguaje natural sobre datos y documentación. Devuelve respuesta, fuentes citadas y datos agregados. Sin SQL.
search_documentation	Búsqueda semántica en la documentación, con documento, página y sección para cada fragmento.
list_documents	Lista los documentos disponibles, con filtros por texto o etiqueta.
get_document	Metadatos de un documento por id.
list_concepts	Conceptos de negocio de la ontología — qué datos existen.
describe_concept	Descripción y atributos de un concepto.
list_business_rules	Las reglas de negocio compartidas de la organización.

Streamable HTTP para clientes remotos, stdio para desarrollo local
Tres scopes explícitos: calliope:catalog:read, calliope:data:read, calliope:query:execute
orgName nunca es un argumento de las herramientas — se resuelve en el servidor a partir de las credenciales de la petición

Gobernanza

Tus agentes por MCP nunca escriben SQL

Acceso sin cheque en blanco. Por MCP, las siete herramientas aceptan preguntas, no consultas: un agente no puede saltárselas. El CLI mantiene query y schema para quien quiera SQL crudo, y su propio skill le dice al agente que recurra antes a ask.

Nada de SQL por MCP

Las herramientas MCP aceptan lenguaje natural y devuelven respuestas con fuentes citadas. Ninguna herramienta acepta una consulta, así que un agente conectado así no puede escribirla.

Reglas aplicadas en tiempo de consulta

Las reglas de negocio son objetos de primera clase que se aplican en tiempo de consulta, no sugerencias en un prompt. Resistentes a inyección de prompt y a la deriva conversacional.

Aislado por organización

El tenant se resuelve en el servidor, a partir de la credencial, nunca de un argumento que controle el agente.

Cada respuesta cita sus fuentes

Documento, página y sección, junto a la respuesta.