MCP
Referencia · Tools

Tools de ops

El worklist compartido (board/backlog/sprints). Estas tools operan sobre tu propia identidad — el gateway te autentica una sola vez y cada llamada respeta tu scope y los proyectos a los que tenés acceso. No hace falta llamarlas por nombre: pedile a Claude lo que querés en castellano ("mostrame lo que está bloqueado en el proyecto X") y elige la tool sola.

read write admin 65 tools de ops 4 tools del gateway

Índice completo de las 83 tools de los cuatro dominios: Todas las tools. Otros dominios: analytics. Cómo conectarte primero: Conectar.

Qué significa "permiso" acá

Dos capas, siempre las dos aplican:

Tools de ops (65)

Tool Qué hace Inputs Permiso Ejemplo de prompt
ops_list Lista ítems del worklist, filtrados y devueltos como texto + array estructurado. Acotado por default: sin limit devuelve a lo sumo 200 ítems (nunca el board entero) y, si trunca, lo avisa en el texto con el after_id de la próxima página. epica?, status? (backlog/todo/wip/blocked/to_be_human_reviewed/done), owner?, sprint_id? (-1=todos, 0=backlog, N=sprint puntual), limit? (default 200, máx 1000), after_id? (id del último ítem visto, para paginar) read alcanza. Filtrado por ops.mcp_authz: solo ves los proyectos a los que tenés acceso. "Mostrame los ítems en wip del proyecto AI Factory."
ops_add Crea un ítem nuevo (crea la épica si no existe). epica/lane, title, status?, owner?, repo?, links?, priority? (P0/P1/P2), parent_id?, plan_ref?, agent_role?, seniority?, sprint_id?, seq_order?, pipeline_type?, custom_fields? (dispatch_mode/ticket_type/qa_verified), project_id? write o admin. En un ítem raíz no podés crearlo ya en done con write. El project_id resuelto se valida contra tu authz. "Creá un ítem en la épica dynamo llamado 'Revisar el deploy de QA', prioridad P1."
ops_update Actualiza los campos de un ítem existente (solo los que mandás). id, status?, owner?, title?, repo?, blocker_note?, links?, append_note?, priority?, parent_id?, plan_ref?, agent_role?, seniority?, epica?/lane?, sprint_id?, seq_order?, pipeline_type?, custom_fields? (dispatch_mode/ticket_type/qa_verified) write o admin. Mismo techo done en raíz que ops_add. Reparentar un ítem para esquivar ese techo (sacarlo de raíz o promover una subtask a raíz) también requiere admin. "Marcá el ítem 761 como blocked con la nota 'esperando decisión de Daniel'."
ops_assign Asigna un ítem a un owner (atajo de ops_update). id, owner write o admin. Filtrado por proyecto igual que ops_update. "Asigná el ítem 42 a mid."
ops_delete Borra un ítem y todas sus notas, de forma permanente. id write o admin. Es irreversible — la validación de proyecto corre antes de borrar. "Borrá el ítem de prueba 999."
ops_sprints Lista todos los sprints con sus fechas, si están activos y cuántos ítems tiene cada uno. ninguno read alcanza. Mismo filtro por proyecto que ops_list. "¿Qué sprint está activo ahora mismo?"
ops_sprint_activate Deprecada — hoy es un no-op. El sprint activo se deriva de start_date/end_date, ya no de un flag que alguien prende. Para mover cuál está activo, editá las fechas con ops_sprint_update. Sigue en la superficie para no romper a quien la llame, y contesta explicando eso. sprint_id? (ignorado) No escribe nada, así que read le alcanza. "Activá el sprint 5." → te va a redirigir a ops_sprint_update.
ops_sprint_add Crea un sprint nuevo, con fechas opcionales. Sin project_id, cae al proyecto default (mismo criterio que ops_add); con project_id: null explícito, crea un sprint GLOBAL (visible a todos los proyectos). name, start_date? (YYYY-MM-DD), end_date? (YYYY-MM-DD), project_id? (nombre, uuid, o null para global) write o admin. Un sprint GLOBAL (project_id: null) solo lo puede pedir un caller admin. "Creá el Sprint 11 del proyecto AI Factory, del 10 al 24 de agosto."
ops_render Renderiza el board completo a markdown. En el gateway el path se ignora — siempre te devuelve el markdown como contenido, nunca escribe a disco. path? (ignorado acá — solo tiene efecto en el MCP local, ver Para desarrolladores) read alcanza. Filtrado por proyecto igual que ops_list. "Renderizame el board completo."
ops_projects Lista los PROYECTOS que ves — id, nombre y si están dentro de tu entitlement. Es la forma de descubrir valores válidos para project/project_id en vez de adivinar un nombre. ninguno read alcanza. Devuelve solo lo tuyo: es el catálogo de tu propio acceso. "¿A qué proyectos tengo acceso?"
ops_notes Lee el historial de notas de un ítem, de la más vieja a la más nueva. Ahí viven los bloques ## FIX REQUERIDO del loop de autorreparación, los HANDOFF, la explicación de un blocker y las notas de cierre. id, limit? read alcanza. Filtrado por proyecto igual que ops_list. "¿Por qué está bloqueado el ítem 761? Leeme sus notas."
ops_attachments Lista los adjuntos de un ítem — solo metadata: id, nombre, tipo, tamaño y quién lo subió. Nunca los bytes: el binario no viaja por MCP, así que sirve para saber que un ticket trae archivos que no podés leer. item_id read alcanza. "¿El ítem 812 tiene archivos adjuntos?"
ops_generate_chain Genera la cadena de subtasks de un ítem raíz que todavía no tiene hijos, según su pipeline_type/ticket_type. Es idempotente: si la raíz ya tiene subtasks, no hace nada. id write o admin — crea ítems, mismo gate que ops_add. "Generá la cadena de subtasks del ítem 766."
ops_epic_upsert Crea o renombra una ÉPICA, o la mueve a otro proyecto. Jerarquía: proyecto > épica > ítem. Sin id crea; con id edita. Es la única forma de renombrar o mover una épica — ops_add solo puede crearla implícitamente por nombre. id?, name, project_id? write o admin. "Renombrá la épica 'dynamo' a 'Dynamo Core'."
ops_epic_archive Archiva (o desarchiva) una ÉPICA. Archivarla la saca del board y de la cola del dispatcher, pero no borra nada: sus ítems siguen existiendo y se abren por id. archived=false la trae de vuelta. id, archived? write o admin. Reversible. "Archivá la épica 'migracion-vieja'."
ops_epic_list Lista las ÉPICAS de un proyecto con su id — el que piden ops_epic_upsert y ops_epic_archive. Por default solo las activas; con include_archived=true también las archivadas, que es como encontrás una para desarchivarla. Incluye las épicas globales. project_id?, include_archived? read alcanza. "¿Qué épicas archivadas tiene el proyecto AI Factory?"
ops_taxonomy_list Lista los catálogos de un proyecto: los valores de taxonomía (dri, status, role, seniority) y los de campos custom (cf:hito y compañía). project_id? read alcanza. "¿Qué hitos hay definidos en el proyecto AI Factory?"
ops_taxonomy_upsert Crea o actualiza UN valor de un catálogo — de taxonomía (dri/status/role/seniority) o de un campo custom (cf:<field_key>). kind, value, label?, color?, sort?, project_id?, epica_id? write o admin. "Agregá el hito 'Cierre Q3' al proyecto AI Factory."
ops_taxonomy_archive Archiva (o desarchiva) UN valor de un catálogo. Lo saca del catálogo activo sin borrarlo ni tocar los ítems que ya lo tienen puesto. kind, value, archived?, project_id? write o admin. Reversible. "Archivá el hito 'Cierre Q1', ya no se usa."
ops_custom_field_upsert Crea o renombra la DEFINICIÓN de un campo custom del proyecto — el campo en sí (p.ej. hito), no sus valores. Una vez que existe, sus valores se cargan con ops_taxonomy_upsert usando kind: cf:<field_key>. field_key, label?, sort?, project_id? write o admin. "Creá un campo custom 'hito' en el proyecto AI Factory."
ops_custom_field_archive Archiva (o desarchiva) la DEFINICIÓN de un campo custom. Lo saca del catálogo activo; no borra la definición ni los valores ya guardados en los ítems. field_key, archived?, project_id? write o admin. Reversible. "Archivá el campo custom 'hito'."
ops_sprint_update Edita el nombre y las fechas de un sprint. Acá se define cuál es el sprint activo: se deriva de start_date/end_date, no de un flag. Si las fechas se solapan con otro sprint del mismo proyecto, la DB lo rechaza. id, name?, start_date?, end_date? write o admin. "Corré el Sprint 11 una semana: del 17 al 31 de agosto."
ops_sprint_delete Borra un sprint. Solo funciona si tiene cero ítems asignados: con ítems responde 409 diciendo cuántos son, nunca cascadea. id write o admin. Nunca borra ítems. "Borrá el sprint 12, quedó vacío."
ops_factory_status Estado agregado del factory: si el modo ejecutar está ON, con qué cuenta corre, y qué agentes están en vuelo. El campo intent ya no existe (ADR-0127: murió ops.factory_intent). — read. Solo lectura por diseño: encender la fábrica es exclusivamente humano (ADR-0113). "¿Está corriendo la fábrica? ¿Con qué cuenta?"
ops_factory_diagnose El selector se explica (ADR-0128): cola elegible AHORA, exclusiones con motivo (predecesor_abierto, sprint_mismatch, dispatch_mode_manual, …), último tick de la VM y agentes en vuelo. Filtrado por los proyectos del token. — read. "¿Por qué no está corriendo nada en el factory?"
ops_sync_rule_add Crea una regla de sync cross-proyecto: los ítems del proyecto ORIGEN que matchean el filtro se clonan en el DESTINO, y el par queda vinculado (bidireccional por default). Requiere acceso a los DOS proyectos. name, source_project_id, target_project_id, direction?, filter_owner?, filter_sprint_scope?, target_epica?, synced_fields?, status_map?, active? write o admin, y acceso a los dos proyectos. "Cloná al proyecto Cliente X los ítems de AI Factory que sean de mid."
ops_sync_rule_list Lista las reglas de sync. Muestra las reglas donde cualquiera de los dos lados sea un proyecto tuyo — que es como averiguás por qué apareció un ítem clonado en tu proyecto. id?, source_project_id?, target_project_id?, active? read alcanza. "¿Por qué se me clonan ítems en el proyecto Cliente X?"
ops_sync_rule_update Edita una regla existente — pausarla/reanudarla, o cambiar su filtro, synced_fields o status_map. Origen y destino no son editables: para eso se pausa y se crea otra. id, name?, direction?, filter_owner?, filter_sprint_scope?, target_epica?, synced_fields?, status_map?, active? write o admin, y acceso a los dos proyectos de la regla. "Pausá la regla de sync 3."
ops_sync_link_add Vincula dos ítems que YA existen bajo una regla de sync — la reconciliación de pares que alguien clonó a mano antes de que la regla existiera. No crea ningún ítem: solo el vínculo, para que de ahora en más se propaguen. rule_id, source_item_id, target_item_id write o admin. Cada ítem tiene que estar del lado que le corresponde en la regla. "Vinculá el ítem 812 con su copia 940 bajo la regla 3."
ops_sync_link_list Lista los vínculos de sync (los pares ítem↔clon), por regla o por ítem. item_id matchea de cualquiera de los dos lados: la pregunta es "¿este ítem está sincronizado?", no "¿de qué lado está?". rule_id?, item_id? read alcanza. "¿El ítem 812 está sincronizado con algo?"
ops_sync_link_remove Desvincula un par ítem↔clon por id de vínculo. No borra ningún ítem: solo deja de propagar entre los dos. Reversible con ops_sync_link_add. id write o admin. Nunca borra ítems. "Desvinculá el par de sync 17."
ops_intake_mapping_health Valores de formulario que llegaron por /api/intake/support SIN fila activa en ops.intake_field_mappings — pendientes y ya resueltos, agrupados por form/target_field/valor. Complementa el punto ciego de ops_factory_diagnose (un ticket sin ticket_type nunca genera cadena, así que esa tool no lo ve). form_id?, since_days? read. Filtrado por los proyectos del token. "¿Hay valores del form de soporte sin mapeo activo?"
ops_planner_config_get Lee la configuración del planner del proyecto: habilitado, vistas, paneles, mapeo de campos (fase, entregable, cantidad, código, título, visibilidad al cliente), palabras excluidas y flags de publicación (todo apagado/vacío por defecto). project_id read alcanza. "¿Cómo está configurado el planner del proyecto Acme?"
ops_planner_config_set Cambia solo los campos que se pasan (null limpia uno anulable): General, Campos, visibilidad al cliente y flags de publicación. project_id, campos de configuración write o admin. project-admin del proyecto (o global-admin). "Activá el planner en Acme y mapeá la fase al campo Fase."
ops_status_semantics_set Fija por estado el % de avance, el rol (abierto, activo, revisión, hecho, en pausa, bloqueado…), la etiqueta para el cliente, el orden y el color. project_id, statuses, remove? write o admin. project-admin del proyecto (o global-admin). "Marcá 'En revisión' como 50% de avance."
ops_stage_list Lista las etapas del plan como árbol (Etapa › Fase, máx. 2 niveles), con fechas propias o derivadas de sus fases/ítems, conteo de ítems y can_admin. project_id, epica_id?, include_archived? read alcanza. "¿Qué etapas y fases tiene HyPro?"
ops_stage_upsert Sin id crea; con id actualiza solo lo enviado (null limpia). Las fechas de una fase caen dentro de las de su etapa. Los ítems se asignan con stage_id en ops_add/ops_update. project_id, id?, parent_id?, epica_id?, name, client_label?, sort?, start_date?, target_date? write o admin. project-admin del proyecto (o global-admin). "Etapa 'Piloto' con cierre el 30 de noviembre."
ops_stage_archive El proyecto se resuelve desde la propia etapa, nunca desde el llamante. id, archived? write o admin. project-admin del proyecto de la etapa (o global-admin). "Archivá la etapa E1.F3."
ops_status_history Una fila por cambio (item_id, estado anterior y nuevo, quién, cuándo), registrada por trigger en toda vía de escritura. Paginada. project_id, item_id?, since?, until?, limit?, after_id? read alcanza. "¿Cuándo pasó el ítem 812 a Hecho?"
ops_sync_rule_preview Muestra qué crearía, actualizaría y retiraría el motor en el proyecto cliente y qué campos viajan con su valor mapeado. No escribe nada. rule_id, item_id?, root_item_id?, limit? read. global-admin. "Simulá la regla 3 antes de activarla."
ops_sync_rule_resync Cada raíz de la épica origen se replanifica contra el estado real del proyecto cliente. Idempotente. rule_id write o admin. global-admin. "Resincronizá la regla 3."
ops_sync_runs Por regla (sus corridas), por corrida (detalle y eventos) o por ítem (su historia de réplica). rule_id?, run_id?, item_id?, limit?, before? read. global-admin o project-admin del proyecto ORIGEN. "¿Qué hizo la última corrida de la regla 3?"
ops_sync_rule_revisions Una fila por versión, la más nueva primero, con quién y cuándo la cambió. rule_id, limit?, before_version? read. global-admin o project-admin del proyecto ORIGEN. "¿Quién cambió la regla 3?"
ops_sync_engine_switch Sin argumentos lee si los triggers están encolando cambios; con outbox_enabled lo enciende o apaga. outbox_enabled? write o admin. Leer: cualquiera. Cambiar: global-admin. "¿Está encendida la réplica?"
ops_project_config_copy Copia por parts (estados, campos, DRI, planner, palabras excluidas). dry_run para ver antes de aplicar. from_project, to_project, parts?, dry_run?, overwrite? write o admin. project-admin del destino (o global-admin). "Copiá la configuración de la plantilla al proyecto Acme."
ops_sprint_series_add Por ejemplo 17 sprints semanales desde una fecha de inicio; el fin es inclusivo. project_id, start_date, duration_days, count, name_pattern?, first_number? write o admin. project-admin del proyecto (o global-admin). "Creá 17 sprints semanales desde el 3 de noviembre."
ops_plan_snapshot Árbol de ítems con fechas efectivas, avance, atraso y códigos, más KPIs, fases, entregables, carga por sprint, hitos y responsables. project_id, epica_id?, today?, include_history?, view? read alcanza. "Mostrame el plan de Acme."
ops_client_publish Genera un HTML autocontenido (proyección cliente, CSP estricta, marca de la organización) y lo guarda como nueva versión que lee el portal. dry_run para ver sin publicar. project_id, dry_run?, as_of?, include_html?, include_payload? write o admin. project-admin del proyecto (o global-admin). "Publicá el plan de Acme al cliente."
ops_client_unpublish Marca la última versión como retirada; el portal deja de servirla de inmediato. project_id write o admin. project-admin del proyecto (o global-admin). "Despublicá el plan de Acme."
ops_client_publication_get Metadatos de la versión (por defecto la última), si es la vigente y si el portal la serviría. project_id, version?, include_html?, include_payload? read. Requiere project-admin del proyecto (o global-admin). "¿Qué versión del plan ve hoy el cliente?"
ops_client_publication_list Metadatos, de la más nueva a la más vieja (se conservan las últimas 20), más la versión que el portal sirve. project_id read. Requiere project-admin del proyecto (o global-admin). "Listá las publicaciones de Acme."
ops_automation_list Publicación programada del plan al cliente y el correo semanal de avance, con cadencia, estado y próxima corrida. project_id, include_archived? read. Requiere project-admin del proyecto (o global-admin). "¿Qué automatizaciones tiene Acme?"
ops_automation_get Con include_candidates suma las personas que pueden recibir el correo. project_id, id, include_candidates? read. Requiere project-admin del proyecto (o global-admin). "Detalle de la automatización 4."
ops_automation_set Sin id crea (kind y name obligatorios); con id edita parcial; archived:true archiva. project_id, id?, name, kind, cadencia y destinatarios write o admin. project-admin del proyecto (o global-admin). "Programá el informe semanal los lunes a las 8."
ops_automation_run dry_run es TRUE por defecto: muestra lo que saldría sin enviar ni publicar nada. project_id, id, dry_run?, as_of?, include_html? write o admin. project-admin del proyecto (o global-admin). "Mostrame cómo saldría el informe semanal."
ops_automation_test_send Mismo render que el real, sin publicar el plan. Solo encola; el runner de la app ops lo envía. project_id, id write o admin. project-admin del proyecto (o global-admin). "Mandame una prueba del informe semanal."
ops_automation_runs Más nuevas primero (máx. 100): slot, disparador, estado, intentos y conteos de entrega. project_id, automation_id?, status?, limit? read. Requiere project-admin del proyecto (o global-admin). "¿Falló algún envío esta semana?"
ops_email_template_upsert Siempre se valida antes de guardar con el motor de plantillas seguro: variables desconocidas rechazadas, nunca limpiadas en silencio. project_id, name, subject, html, text?, dry_run? write o admin. project-admin del proyecto (o global-admin). "Guardá la plantilla 'Informe Acme'."
ops_email_template_get Por name o id; sin ninguno, lista las plantillas y describe la integrada «Informe semanal». project_id, name?, id?, include_archived? read. Requiere project-admin del proyecto (o global-admin). "¿Qué plantillas de correo hay en Acme?"
ops_email_template_archive Se rechaza (409) mientras una automatización viva la use. project_id, name?, id? write o admin. project-admin del proyecto (o global-admin). "Archivá la plantilla 'Informe Acme'."
ops_factory_summary Contadores del header de /live de la AI Factory: running, queued, blocked y max_parallel. Solo enteros agregados, sin ids ni títulos. Solo existe para el proyecto AI Factory. project_id? (default: AI Factory; otro valor se rechaza) read. Miembro del proyecto AI Factory. "¿Cuántos agentes de la fábrica están corriendo y cuántos en cola?"
ops_replica_mode_get Si el proyecto está en MODO RÉPLICA (D58): su contenido (ítems, notas, adjuntos, vínculos) lo escribe solo el worker de réplica — toda escritura da 409 REPLICA_MODE_READONLY — y la configuración sigue editable. Devuelve quién y cuándo lo activó y las reglas que lo alimentan. project_id read. Cualquier miembro del proyecto. "¿El proyecto HyPro está en modo réplica?"
ops_replica_mode_set ENCIENDE el modo réplica — de una vía e IRREVERSIBLE (no hay forma de apagarlo). Solo sobre un proyecto VACÍO (cero ítems, incluidos archivados; si no, 409 REPLICA_MODE_NOT_EMPTY). dry_run es true por default: solo corre el preflight. project_id, dry_run? (default true) write o admin. Solo global-admin. "Corré el preflight del modo réplica para el proyecto HyPro (dry run)."
ops_factory_capacity_get Perilla de capacidad de la AI Factory: max_parallel efectivo, su origen (source), techo, tope duro (hard_cap), trabajo en curso (wip), último cambio y el bloque tier (perfil de VM registrado, tier actual y tabla de tiers). El max_parallel efectivo es el mínimo entre el valor del board, el techo del ambiente y el cupo del perfil registrado (source profile_clamped cuando el cupo del perfil recorta). Sin argumentos. read. Miembro del proyecto AI Factory. "¿Con cuánto paralelismo está corriendo la fábrica ahora?"
ops_factory_capacity_set Cambia la perilla de capacidad de la fábrica de PROD: max_parallel (1..40, nunca por encima del techo del ambiente ni del cupo del perfil de VM registrado; o null para volver al default) con reason; o vm_profile (reposo, media, ola, turbo) con reason, que solo devuelve el comando gh para redimensionar la VM, no la redimensiona. max_parallel?, vm_profile?, reason write o admin. Solo global-admin. "Subí el paralelismo de la fábrica a 12 por la ola de hoy."

ops_token_mint, ops_token_list y ops_token_revoke ya no existen en el gateway — las reemplazan dynamo_token_mint, dynamo_token_list y dynamo_token_revoke (mismo comportamiento, mismo gate), porque los tokens de máquina dejaron de ser de ops y pasaron a ser del gateway. Ver la sección de abajo.

Tools del gateway (4)

No son de ningún dominio en particular — las expone el propio gateway. Las tres de dynamo_token_* son para máquinas (el dispatcher, agent-factory): Claude no soporta un flujo sin humano de por medio, así que estos siguen siendo bearers opacos, no OAuth.

Tool Qué hace Inputs Permiso Ejemplo de prompt
dynamo_session_status Quién sos, contra qué ambiente estás (con PROD ⚠️ si aplica), tu scope y expiración de token, y tu estado en los cuatro dominios (ops, analytics, forms, auth). Reemplaza a los cuatro *_session_status sueltos. solo_gateway? (bool, default false — con true se salta la consulta a los otros tres dominios) Cualquier token autenticado — read alcanza. "Decime quién soy y contra qué ambiente estoy conectado."
dynamo_token_mint Emite un token opaco de máquina (mcp.machine_tokens) para un user_id. Devuelve el token en claro una sola vez — después solo queda su hash. expires_at es obligatorio y no puede pasar los 90 días. user_id (uuid), scope (read/write/admin), label?, expires_at (ISO-8601, obligatorio, ≤ 90 días) Global-admin real (authz.isGlobalAdmin === true) y los caps de tu propia sesión: acuñar read/write exige caps.write; acuñar admin exige que tu sesión YA sea admin. Un grant OAuth read no acuña nada — una sesión no puede crear un token más poderoso que ella. "Emitime un token de máquina write para el dispatcher, user_id tal-y-tal."
dynamo_token_list Lista los tokens de máquina existentes (id, user_id, scope, label, expiración, revocación). Nunca el valor en claro ni el hash. ninguno Global-admin real, mismo gate que dynamo_token_mint. "Mostrame los tokens de máquina vigentes."
dynamo_token_revoke Revoca un token de máquina por id. Revocar uno inexistente o ya revocado da error explícito, no un no-op silencioso. id (int) Global-admin real, mismo gate que dynamo_token_mint. "Revocá el token de máquina 7."

Errores esperados (401/403/503) y qué hacer con cada uno: Troubleshooting.