Herramientas
La lista completa de herramientas MCP expuestas actualmente a los agentes.
Esta página enumera todas las herramientas MCP actuales. Los nombres siguen la estructura de recursos y acciones de la CLI en formato snake_case; epismo_case_start corresponde a epismo case start.
La exploración del catálogo público, las listas y lecturas públicas de casos, registros y grafos de entregas y la lectura de playbooks públicos por UUID funcionan sin OAuth y cuestan 0 créditos. Las escrituras, el trabajo privado, las consultas de búsqueda no vacías, los alias y los recursos de identidad requieren Authorization: Bearer <oauth_access_token>. Las llamadas protegidas devuelven un desafío OAuth 401; conectarse o listar herramientas no requiere iniciar sesión.
Espacios de trabajo
epismo_workspace_list
epismo_workspace_use
epismo_workspace_clearepismo_workspace_list devuelve los ID, identificadores, roles de los espacios de trabajo accesibles y el defaultWorkspaceId de la conexión (null para el espacio personal). Use epismo_workspace_use para cambiar el espacio de trabajo predeterminado de la conexión por UUID o identificador, equivalente a workspace use en la CLI. Use epismo_workspace_clear para restablecer el valor predeterminado al espacio personal, equivalente a workspace clear en la CLI. Los cambios en el valor predeterminado persisten entre renovaciones de tokens y afectan a todas las conversaciones que usan esa conexión.
Todas las herramientas operativas admiten un parámetro opcional workspaceId: omítalo para usar el valor predeterminado de la conexión, pase un UUID de espacio de trabajo accesible para usar ese espacio en la llamada, o pase null para usar el espacio personal. La anulación a nivel de herramienta limita esa operación sin alterar el valor predeterminado de la conexión.
Equipos
epismo_team_list
epismo_team_create
epismo_team_update
epismo_team_member_list
epismo_team_member_add
epismo_team_member_deleteLas herramientas de equipos requieren un espacio de trabajo. Use epismo_team_list para obtener el ID correspondiente a un nombre como general antes de configurar la ACL de un caso.
Casos
epismo_case_start
epismo_case_get
epismo_case_list
epismo_case_access_get
epismo_case_access_set
epismo_case_share
epismo_case_assign
epismo_case_owner_transfer
epismo_case_update
epismo_case_handoff_create
epismo_case_handoff_remove
epismo_case_handoff_candidates_list
epismo_case_handoff_graph_get
epismo_report_case_get
epismo_report_case_list
epismo_report_case_generate
epismo_report_case_act
epismo_report_personal_generate
epismo_report_personal_get
epismo_report_personal_list
epismo_report_personal_act
epismo_report_team_generate
epismo_report_team_get
epismo_report_team_list
epismo_report_team_act
epismo_case_close
epismo_case_reopen
epismo_case_archive
epismo_case_restore
epismo_case_deleteComience con versionId para un caso respaldado por playbook u omítalo y proporcione un título para un caso ad hoc. Los cambios de asignación y ACL son independientes. Las mutaciones del estado existente requieren la última versión de bloqueo. Conecte casos con epismo_case_handoff_create; elimine una arista obsoleta con epismo_case_handoff_remove cuando pueda leer su origen y trabajar en su destino; descubra candidatos válidos sin generar ciclos usando epismo_case_handoff_candidates_list; y visualice el grafo DAG con epismo_case_handoff_graph_get. epismo_case_list descubre Casos legibles, incluidos los públicos, por fecha de actualización. Filtre con sharingScope (only_me, shared o anyone), playbookId y status; assignedTo=me requiere autenticación.
Fuentes externas
epismo_case_source_link
epismo_case_source_unlink
epismo_case_source_refresh
epismo_case_source_getVincule un hilo de Slack, un mensaje/hilo de Discord o un archivo nativo de Google Docs, Sheets o Slides con su cuenta conectada en el espacio activo. Slack y Discord requieren un espacio de trabajo; Google Drive admite espacios personales y de trabajo. Primero conecte Google Drive y seleccione el archivo con Google Picker en Web; una URL por sí sola no concede acceso. Las fuentes de Google Drive usan la clave de proveedor gdrive. Vincular y desvincular cuestan 2 créditos cada uno; la captura inicial está incluida al vincular. Cada actualización manual o automática completada cuesta 1 crédito a la cuenta de facturación de ese caso. Los casos cerrados solo se actualizan por solicitud explícita. Encolar, fallar, paginar y reintentar no tienen costo; las solicitudes agrupadas en una captura generan un solo cargo para ese caso. case get incluye sources solo para colaboradores de trabajo. Las lecturas usan capturas guardadas; compruebe el estado y las fechas. Si se omite contenido, obtenga la fuente completa más reciente con su ID. No se conserva contenido histórico. Las fuentes son independientes de los registros y no se incluyen en respuestas públicas. Consulte Slack, Discord y Google Drive para compartir, actualizar automáticamente y eliminar capturas.
Use caseId en las cuatro herramientas; vincular añade url, obtener, actualizar y desvincular añaden sourceId. Las escrituras usan idempotencyKey. Consulte snapshotOmitted, checkedAt y snapshot.capturedAt en epismo_case_get.
Tareas
epismo_case_task_create
epismo_case_task_list
epismo_task_list
epismo_case_task_get
epismo_case_task_update
epismo_case_task_set_statusNo se crea ninguna tarea cuando se inicia un caso. Cree tareas work o approval solo cuando la responsabilidad explícita sea útil. Una tarea de aprobación puede señalar su subjectRecordId exacto. epismo_case_task_update cubre campos y el asignado; epismo_case_task_set_status cierra una tarea con un resultado o la reabre.
Registros
epismo_case_record_append
epismo_case_record_update
epismo_case_record_delete
epismo_case_record_listSolo el creador puede actualizar o redactar un registro propio; los registros del sistema no se pueden cambiar. Los clientes escriben kind note u output; activity es exclusivo del servidor. La eliminación vacía el contenido y los datos y conserva un registro de eliminación con deleted_at. epismo_case_record_list enumera los registros de un caso, permitiendo expandir la consulta a través de transferencias conectadas con scope (self, ancestors, descendants, neighbors, connected). Filtre por taskId, createdBy, kinds, origins o acl; elija orden ascendente o descendente y continúe con el cursor. Los filtros nunca otorgan acceso.
Los registros usan note, output o activity, reservado al sistema. Los nuevos registros y los cambios de tipo solo aceptan note u output. Las evaluaciones humanas y de agentes pueden guardarse como notas; AI Review guarda informes separados.
Los editores del caso pueden usar epismo_report_case_generate (POST /v1/cases/{caseId}/report) para encolar una evaluación asíncrona de AI review sobre las evidencias y registros del caso. La generación devuelve de inmediato los metadatos del trabajo. Review utiliza instrucciones de evaluación integradas; no admite instrucciones personalizadas de la cuenta propietaria ni prompts por solicitud. La búsqueda web durante la evaluación se puede habilitar si la política del espacio de trabajo lo permite. Una vez procesado, recupere la última evaluación y las propuestas accionables con epismo_report_case_get (GET /v1/cases/{caseId}/report). Use epismo_report_case_act (POST /v1/cases/{caseId}/report/actions) para confirmar o descartar acciones propuestas, como crear tareas de seguimiento. Revise todo el contenido de la propuesta guardada y envíe reportId, proposalId y action (create o dismiss), con feedback opcional al descartar. La creación utiliza el contenido guardado sin cambios para crear una tarea, un caso con un enlace de traspaso dirigido, una sugerencia o un playbook con su primera versión. No envíe title, content, cambios de definición ni idempotencyKey; los reintentos utilizan la identidad de la propuesta. Las decisiones se conservan por propuesta: repetir una ya atendida devuelve el informe guardado actual sin crear más trabajo.
Los nuevos casos y playbooks utilizan la cuenta de facturación activa de quien confirma, con acceso restringido al creador; no se copian los permisos ni las fuentes externas del caso original. Crear un caso añade un enlace de traspaso dirigido desde el caso evaluado sin cerrarlo. La creación de playbooks se propone con moderación, cuando hay evidencia de un patrón recurrente y un uso futuro probable; las recomendaciones de creación ya atendidas no se vuelven a proponer para ese caso. Un informe desactualizado muestra un aviso orientativo de reevaluación y no bloquea las acciones; siguen aplicándose los permisos actuales y la validación de cada operación.
Playbooks, versiones y alias
epismo_playbook_list
epismo_playbook_search
epismo_playbook_resource_list
epismo_playbook_get
epismo_playbook_copy
epismo_playbook_copies_list
epismo_playbook_create
epismo_playbook_draft_get
epismo_playbook_draft_save
epismo_playbook_draft_publish
epismo_playbook_draft_discard
epismo_playbook_version_list
epismo_playbook_version_get
epismo_playbook_version_publish
epismo_playbook_version_archive
epismo_playbook_access_get
epismo_playbook_access_set
epismo_playbook_owner_transfer
epismo_playbook_alias_set
epismo_playbook_alias_list
epismo_playbook_alias_delete
epismo_playbook_share
epismo_playbook_archive
epismo_playbook_restore
epismo_playbook_assignPlaybooks y Casos tienen una cuenta propietaria de Usuario o Espacio de trabajo (ownerId), que también paga su uso. El propietario personal tiene todos los derechos; los Owners y Admins actuales ejercen esos derechos para un Espacio de trabajo. Los demás miembros necesitan permisos explícitos de usuario o Equipo, o visibilidad pública para leer contenido publicado. La membresía por sí sola no concede acceso. Al eliminar un miembro, se revocan sus permisos directos sobre los recursos propiedad de ese Espacio, incluidos los completados y archivados. Si la eliminación dejara algún recurso sin editor explícito, añada primero otro usuario o equipo editor, incluidos los recursos completados o archivados. Se conservan los permisos sobre recursos personales y de otros Espacios. Los permisos de Equipo y administración dependen de la membresía actual. El SSO obligatorio se aplica a los miembros; los usuarios externos con permisos directos usan la autenticación normal de Epismo. El acceso de Equipo entre espacios verifica el SSO del espacio de participación. Los listados usan permisos explícitos y la visibilidad pública admitida; la propiedad por sí sola no incluye un recurso.
Los lectores pueden leer contenido compartido, pero no editar; los borradores requieren edición. Los editores pueden cambiar contenido y permisos, conservar al menos un editor explícito al cambiar permisos, archivar y restaurar. Transferir la cuenta propietaria, cambiar el mantenedor, eliminar Casos definitivamente y archivar versiones históricas requieren derechos de propietario. assignedTo indica responsabilidad sin conceder acceso. Un nuevo responsable o mantenedor debe tener edición y, en recursos del Espacio, pertenecer a ese Espacio. Reasignar conserva los permisos; transferir la propiedad no añade automáticamente al antiguo propietario como editor.
Omita ownerId al crear o copiar para usar el Espacio de trabajo activo, o su cuenta personal si no hay uno seleccionado. La selección explícita también requiere autorización. Los creadores en un Espacio reciben un permiso explícito de edición; mantener o tener asignado un recurso no sustituye los permisos.
Sugerencias
epismo_playbook_suggestion_create
epismo_playbook_suggestion_list
epismo_suggestion_list
epismo_playbook_suggestion_get
epismo_playbook_suggestion_update
epismo_playbook_suggestion_resolveLas Sugerencias pertenecen al Playbook padre actual y no tienen propietario ni permisos históricos independientes. authorId identifica al creador y baseVersionId conserva la referencia de contenido inmutable para evaluar la mejora. La lectura requiere acceso actual al padre; archivarlo oculta sus Sugerencias hasta restaurarlo. Los autores pueden editar sus propuestas abiertas mientras mantengan acceso; los editores actuales del Playbook pueden adoptar o rechazar propuestas. Tras una transferencia, las propuestas existentes siguen los permisos actuales del padre. Publique el resultado antes de marcar la propuesta como aplicada.
epismo_suggestion_list (view="inbox" / view="sent")
Créditos
epismo_credit_balance
epismo_credit_checkoutLas herramientas de créditos usan la cuenta del espacio de trabajo activo o, si no hay ninguno, la cuenta personal. epismo_credit_checkout devuelve la URL de una página de pago; la llamada por sí sola no añade créditos.
Disciplina de llamada de herramientas
- Lea el estado más reciente antes de modificar algo que requiera una versión de bloqueo o una versión base.
- Si el esquema solicita una clave de idempotencia, genere un UUID nuevo para cada operación. Reutilícelo solo al reintentar la misma operación cuyo resultado se desconoce.
- Si hay un conflicto, vuelva a leer el estado y revise la operación; no cambie únicamente la versión de bloqueo.
- Mantenga los detalles temporales de ejecución en el cliente y guarde en Epismo solo la información necesaria para colaborar.
La creación y los cambios de acceso usan access: { visibility, grants }: visibilidad restricted/public y UUID de usuarios o equipos con valores viewer/editor. Cada cambio reemplaza el objeto completo; conserve los permisos ajenos al cambio. Los propietarios conservan la gestión independientemente de los permisos. Los responsables y mantenedores no reciben acceso implícito. Los editores pueden consultar y reemplazar permisos, conservar al menos un editor explícito al cambiar permisos, archivar y restaurar. El JSON normal omite mapas privados; los editores pueden obtenerlos con access-get. Consulte Acceso e identidad.
Copie una versión publicada legible para adaptarla de forma independiente. La copia tiene contenido y versiones propios; no hereda permisos, borradores, Casos, sugerencias, alias, estrellas ni historial, y las ediciones nunca se sincronizan. Elija los permisos explícitamente; omita ownerId para usar el Espacio activo o su cuenta personal. copiedFrom registra el origen inmediato y su versión inmutable; sourceAccessible indica si aún puede leerlo. Las listas muestran solo copias legibles. Copiar cuesta lo mismo que crear un Playbook.
Propiedad, responsabilidad y ciclo de vida
Archivar es distinto de cerrar. Los editores y propietarios pueden archivar desde Web, CLI, API o MCP. Los Casos archivados salen de vistas activas, recuentos y grafos y no pueden abrirse, pero conservan su trabajo. Liste con archived=true (case list --archived) para obtener el UUID y la última versión de bloqueo; restaurar conserva estado, responsables y permisos. Solo un propietario puede eliminar definitivamente un Caso archivado, con el último expectedLockVersion. Se eliminan sus Tareas, Registros, Fuentes y enlaces; otros Casos y el contenido original del proveedor permanecen.
Los editores y propietarios pueden archivar y restaurar el Playbook. Liste los archivados sin consulta de texto con archived=true (playbook list --archived o epismo_playbook_search) y restaure con playbook restore o epismo_playbook_restore. Se conservan versiones, permisos y mantenimiento. Los propietarios pueden cambiar al responsable con playbook assign --assigned-to o epismo_playbook_assign, sin conceder acceso. Archivar versiones históricas sigue requiriendo propiedad; la última versión no se puede archivar.
Las Sugerencias pertenecen al Playbook padre actual y no tienen propietario ni permisos históricos independientes. authorId identifica al creador y baseVersionId conserva la referencia de contenido inmutable para evaluar la mejora. La lectura requiere acceso actual al padre; archivarlo oculta sus Sugerencias hasta restaurarlo. Los autores pueden editar sus propuestas abiertas mientras mantengan acceso; los editores actuales del Playbook pueden adoptar o rechazar propuestas. Tras una transferencia, las propuestas existentes siguen los permisos actuales del padre. Publique el resultado antes de marcar la propuesta como aplicada.
Transfiera la propiedad de un Caso con epismo_case_owner_transfer, case owner transfer <case-id> --owner-id <account-id> --lock-version <n> o PATCH /v1/cases/{caseId}/owner (ownerId, expectedLockVersion, idempotencyKey). Requiere propiedad actual. Un Caso personal puede pasar al Espacio conectado; si es público, también exige gestión del Espacio de destino. Un Caso del Espacio puede pasar a su creador o a un Owner de ese Espacio. Se rechazan transferencias entre usuarios o entre Espacios. Se conservan asignación y permisos, cambia la cuenta de facturación y se borran los informes de Review derivados. Reasignar por sí solo no realiza estos cambios de propiedad.
Consultar evaluaciones guardadas
El detalle del caso incluye el último informe accesible y el trabajo de generación sin cargar el historial ni ejecutar IA. Usa epismo_report_case_list con caseId y los campos opcionales pageSize y cursor para consultar fechas, diagnósticos de salud y resúmenes del más reciente al más antiguo. Pasa un reportId guardado a epismo_report_case_get para leer el informe completo.
El historial exige acceso de trabajo actual al caso y devuelve solo evaluaciones que coinciden con la audiencia compartida actual. Los lectores públicos no reciben informes ni resúmenes. Los informes reemplazados tienen historical: true y son de solo lectura: crear o descartar una propuesta pendiente de uno devuelve HTTP 409. Lee el informe más reciente y reconsidera la propuesta antes de actuar. Los cambios de evidencia por sí solos siguen mostrando un aviso orientativo de reevaluación.
Consulta los argumentos de las herramientas de informes para generar, leer, consultar el historial y atender propuestas personales o de equipo. AI review explica los alcances, los diagnósticos compartidos de health y los permisos.