roiq-os-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| ROIQ_BASE_URL | No | The base URL of the ROIQ OS server (default: https://roiq-os.pages.dev) | https://roiq-os.pages.dev |
| ROIQ_OPERATOR_TOKEN | Yes | Your access token for ROIQ OS (created by the Owner in ROIQ OS -> Configuraciones -> Conectar Claude) |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| roiq_overviewA | Resumen del workspace de ROIQ OS: espacios, conteo de items por tipo y secciones con datos. Úsala primero para orientarte. |
| roiq_list_spacesA | Lista los espacios (equipos, clientes, privados) con su id y tipo. |
| roiq_list_itemsA | Lista los items (páginas, tableros, tablas, pizarras, enlaces) del workspace. Filtra por espacio (spaceId o nombre) y/o tipo. |
| roiq_create_spaceA | Crea un espacio nuevo (equipo, cliente o privado). Nace sin teams asignados → sólo Owner/Admin lo ven hasta asignarlo en Configuraciones. |
| roiq_create_pageC | Crea una página dentro de un espacio, con contenido opcional (texto/markdown ligero: #, ##, ###, >, -, 1., - [ ]). |
| roiq_set_page_contentC | Reemplaza el contenido de una página con el texto/markdown dado. |
| roiq_create_dbB | Crea una base de datos (tablero kanban o tabla) en un espacio. Opcional: estados (columnas) y propiedades. |
| roiq_create_whiteboardB | Crea una pizarra (ROIQ Board estilo Miro) en un espacio y la provisiona en el backend del board. |
| roiq_create_embedC | Crea un enlace incrustado (iframe: Drive, Docs, cualquier web) en un espacio. |
| roiq_rename_itemC | Renombra un item (página/tablero/tabla/pizarra/enlace) por su id. |
| roiq_delete_itemA | Elimina un item por su id (y, si es un tablero/tabla, sus tarjetas). Confirma con el usuario antes de borrar cosas importantes. |
| roiq_list_cardsB | Lista las tarjetas/filas de un tablero o tabla (por su id de pipeline). |
| roiq_add_cardB | Añade una tarjeta/fila a un tablero o tabla. status por defecto = primera columna. |
| roiq_update_cardC | Actualiza campos de una tarjeta por su code (name, status, assignee y/o props). |
| roiq_move_cardC | Mueve una tarjeta a otra columna/estado. |
| roiq_add_columnC | Añade una columna/estado a un tablero. |
| roiq_add_propertyC | Añade una propiedad (columna de datos) a una DB. type ∈ select|person|text|link|number|date. |
| roiq_create_guionA | Crea la página de un GUION en un espacio y registra una PROPUESTA PENDIENTE de aprobación en el buzón Operador. Cristhyan la aprueba desde la app; tú lo detectas con roiq_list_pending y entonces disparas el montaje. |
| roiq_list_pendingA | Lista las propuestas del buzón Operador. Por defecto sólo las pendientes; pasa all=true para ver todas (incluye las aprobadas por Cristhyan que ya puedes ejecutar). |
| roiq_get_proposalC | Devuelve una propuesta completa (incluye su payload, p.ej. tomas+receta de montaje). |
| roiq_update_proposalA | Cambia el estado de una propuesta (p.ej. 'done' tras ejecutarla, o 'rejected'). |
| roiq_montaje_list_sourcesB | Lista las tomas disponibles para montar, agrupadas por proyecto y en el orden del guion (skill montaje_listar_fuentes). |
| roiq_montaje_editA | Monta y edita un vídeo COMPLETO de forma autónoma (Director + render + revisión con visión). Tarda minutos; el resultado se publica en el chat de ROIQ OS (skill montaje_editar). |
| roiq_montaje_correctC | Corrige/reedita un montaje en curso por su id (mjob_…) en lenguaje natural (skill montaje_corregir). |
| roiq_montaje_listA | Lista los montajes de la zona de montaje (jobs del editor de vídeo) con su estado y video_key. |
| roiq_montaje_statusA | Consulta el estado de un montaje/edición por su id (mjob_… o ejob_…). |
| roiq_montaje_approveA | APRUEBA un montaje para renderizar (pasa a render_queued; el worker del VPS lo renderiza). Úsalo tras la aprobación de Cristhyan. |
| roiq_list_skillsA | Lista todas las skills del motor de ROIQ OS que puedes ejecutar con roiq_run_skill. |
| roiq_run_skillB | Ejecuta cualquier skill del motor de ROIQ OS por su nombre (sacar_reporte, analitica_web, ver, escuchar, biblioteca_listar, biblioteca_describir_imagenes, montaje_*…). Pásale sus args. |
| roiq_publish_htmlB | Publica un HTML autocontenido (artefacto) y devuelve un enlace de sólo lectura no indexado. Confirma con el usuario antes de publicar contenido de cara al exterior. |
| roiq_state_getA | Devuelve el JSON COMPLETO del workspace (puede ser grande). Úsalo sólo cuando necesites inspeccionar algo que las demás tools no cubren. |
| roiq_state_patchA | Escape hatch universal: modifica el workspace directamente. O bien set por dot-path (path + value; sufijo '[]' en path = push a un array), o bien merge (deep-merge de un objeto en la raíz). Garantiza que puedes hacer CUALQUIER cosa no cubierta por otra tool. Úsalo con cuidado. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 32 tools
Each tool targets a distinct entity and action, with clear boundaries (e.g., roiq_create_db vs roiq_add_column, roiq_montage_edit vs roiq_montage_correct). Even the escape hatch roiq_state_patch is explicitly documented as a last resort, not a source of ambiguity.
All tools follow a consistent roiq_verb_noun pattern (e.g., add_card, create_db, list_items). Verbs are uniform (add, create, delete, list, get, update, rename) and nouns correspond to domain entities, making the pattern predictable.
32 tools is relatively high, but each covers a distinct operation in a comprehensive OS platform (kanban, spaces, pages, video montage, skills). The scope justifies the count, though a few tools (e.g., roiq_state_get, roiq_state_patch) are general-purpose and could have been fewer.
The tool surface covers CRUD for core entities (cards, columns, properties, pages, spaces, items) and video montage workflow. Minor gaps exist (e.g., no explicit tool for updating page title separately, but roiq_rename_item works; no user management tools), but the escape hatch roiq_state_patch ensures no dead ends.