Agentes: MCP y skill

Una decisión tarda unos 10 ms y no cuesta nada, así que un agente puede tomar una antes de cada paso de enrutamiento, triaje, moderación o escalado. Ollaya da a los agentes dos cosas:

Un servidor MCP, ollaya mcp, que expone los modelos locales como herramientas.
Un skill de agente, ollaya-decisions, que enseña a un agente cuándo una decisión tipada supera al razonamiento en texto, cómo escribir buenas preguntas y cómo actuar según las probabilidades.

Servidor MCP

ollaya mcp habla el Model Context Protocol por stdio. Se comunica con el servidor local como cualquier otro comando y lo inicia cuando no está en ejecución.

Claude Code

claude mcp add ollaya -- ollaya mcp

Claude Desktop

Añádelo a claude_desktop_config.json (Settings → Developer → Edit Config):

{
  "mcpServers": {
    "ollaya": { "command": "ollaya", "args": ["mcp"] }
  }
}

Si Claude Desktop no encuentra ollaya, usa su ruta completa, por ejemplo /usr/local/bin/ollaya o ~/.local/bin/ollaya.

Cursor, VS Code y otros clientes

Usa el mismo comando, ollaya mcp, en los ajustes MCP del cliente: .cursor/mcp.json para Cursor, .vscode/mcp.json para VS Code (con "type": "stdio").

Por HTTP

Para clientes que se conectan por la red, sirve HTTP en streaming en su lugar:

ollaya mcp --http                  # http://127.0.0.1:11436/mcp
ollaya mcp --http 127.0.0.1:9000   # another address

Por defecto solo acepta hosts de loopback.

Herramientas

Herramienta	Qué hace
`decide`	Responde preguntas tipadas sobre un estado. Argumentos: `state` (una cadena o cualquier JSON), `questions` o `preset`, y `model` (por defecto `laya`). El resultado es exactamente lo que devuelve `POST /v1/systemone`.
`list_models`	Los modelos de esta máquina, como `ollaya list`.
`show_model`	Los detalles, las capacidades, la licencia y las preguntas integradas de un modelo.
`pull_model`	Descarga un modelo, con notificaciones de progreso. `decide` también descarga en el primer uso.

Recursos

URI	Contenido
`ollaya://models`	Los modelos instalados
`ollaya://presets/<name>`	Las preguntas de un preset integrado: `triage`, `email`, `guard`, `moderation`, `router`, `agent`

Skill de agente

El skill es un SKILL.md que los agentes compatibles con Agent Skills, como Claude Code, cargan cuando una tarea lo requiere. Cubre elegir un modelo, escribir preguntas choice, score y noul, los presets, umbrales de confianza para actuar o escalar, y llamar a Ollaya por MCP, la CLI o HTTP.

Instálalo en un proyecto (o añade -g para todos los proyectos):

npx skills add ollaya-dev/ollaya --skill ollaya-decisions

También se incluye con cada versión, en share/ollaya/skills/ollaya-decisions/ junto al binario (/usr/local/share/ollaya/skills/ para una instalación del sistema), así que puedes copiarlo a .claude/skills/ sin red.

El skill también funciona por sí solo: un agente con solo el skill y ollaya instalados llama a la CLI.