Tools

MCP names mirror the CLI resource and verb hierarchy in snake case. For example, epismo_case_start corresponds to epismo case start.

Playbooks, Versions, aliases, and stars

epismo_playbook_search
epismo_playbook_resource_list
epismo_playbook_get
epismo_playbook_create
epismo_playbook_version_publish
epismo_playbook_draft_get | save | publish | discard
epismo_playbook_access_get | set
epismo_playbook_archive
epismo_playbook_star
epismo_playbook_unstar
epismo_playbook_starred
epismo_playbook_version_list
epismo_playbook_version_get
epismo_playbook_version_archive
epismo_playbook_alias_set
epismo_playbook_alias_list
epismo_playbook_alias_delete

epismo_playbook_get accepts a UUID or pb:alias / pb:handle/alias. epismo_playbook_search also serves a plain catalog listing: omit query for Playbooks most recently updated first, still scoped by category and paging. epismo_playbook_access_get and set use visibility plus explicit editors; public grants published read access only, while editors may edit content. Only owner managers can manage access, archive a Playbook, or archive a historical Version; the latest Version is always protected.

Cases

epismo_case_start
epismo_case_get
epismo_case_list
epismo_case_assign
epismo_case_acl
epismo_case_update
epismo_case_close
epismo_case_reopen

Start with versionId for a Playbook-backed Case or omit it and supply a title for an ad hoc Case. Assignment and ACL changes are independent. Existing-state mutations require the latest lock version.

Tasks

epismo_task_create
epismo_task_list
epismo_task_get
epismo_task_assign
epismo_task_update
epismo_task_close
epismo_task_reopen

No Task is created when a Case starts. Create work or review Tasks only when explicit responsibility is useful. A review Task can point to its exact subjectRecordId.

Records

epismo_record_append
epismo_record_list

epismo_record_list is both a Case timeline and an ACL-scoped cross-Case activity feed. Narrow it with caseId, taskId, createdBy, kinds, origins, or acl; choose ascending or descending order and continue with its cursor. Filters never grant access.

Suggestions

epismo_suggestion_create
epismo_suggestion_get
epismo_suggestion_list
epismo_suggestion_update
epismo_suggestion_resolve

Suggestions target immutable base Versions. The author edits an open Suggestion and the Playbook owner resolves it. applied requires the result Version ID; resolving never publishes automatically.

Every tool on this page is credit-gated on success; see Credits for the cost of each one.

Tool-call discipline

• Read before mutating when an operation needs a lock or base Version.
• Generate a fresh idempotency UUID for each new intent; reuse one only for an identical uncertain retry.
• After a conflict, re-read and reconsider instead of changing only the lock version.
• Keep ephemeral execution details in the agent runtime; append only collaboration-worthy state.