ツール

MCP 名は CLI の resource・verb hierarchy を snake_case に対応させます。たとえば epismo_case_start は epismo case start に対応します。

プレイブック、Version、alias、star

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 は UUID または pb:alias / pb:handle/alias を受け取ります。epismo_playbook_search は一覧取得も兼ねます。query を省略すると、category と paging はそのまま使いつつ、更新が新しい順の一覧になります。MCP では create、publish、Draft、access、archive の tool を利用できます。epismo_playbook_access_get と set は visibility と明示的な editor を扱い、public は公開済み content の read だけを許可します。access 管理と archive は owner manager に限られ、latest Version は常に保護されます。

案件

epismo_case_start
epismo_case_get
epismo_case_list
epismo_case_assign
epismo_case_acl
epismo_case_update
epismo_case_close
epismo_case_reopen

プレイブック-backed 案件 は versionId、ad hoc 案件 はそれを省略して title を指定します。assignment と ACL 変更は独立しています。既存状態の mutation には latest lock version が必要です。

タスク

epismo_task_create
epismo_task_list
epismo_task_get
epismo_task_assign
epismo_task_update
epismo_task_close
epismo_task_reopen

案件 開始時に タスク は作られません。明示的な責任が必要なときだけ work または review タスク を作ります。review タスク は対象の subjectRecordId を指定できます。

記録

epismo_record_append
epismo_record_list

epismo_record_list は 案件 timeline であり、ACL-scoped な 案件 横断 activity feed でもあります。caseId、taskId、createdBy、kinds、origins、acl で絞り、昇順・降順を選び、cursor で続けます。filter は access を付与しません。

Suggestion

epismo_suggestion_create
epismo_suggestion_get
epismo_suggestion_list
epismo_suggestion_update
epismo_suggestion_resolve

Suggestion は immutable な base Version を target にします。author が open Suggestion を編集し、プレイブック owner が resolve します。applied には result Version ID が必要で、resolve は自動 publish しません。

このページのすべての tool は成功時にクレジットを消費します。それぞれのコストはクレジットを参照してください。

tool call の規律

• lock または base Version が必要な mutation 前に read します。
• 新しい intent ごとに fresh idempotency UUID を生成し、同一の不確実な retry だけで再利用します。
• conflict 後は lock version だけを変えず、再 read して intent を再検討します。
• 一時的な実行詳細は agent runtime に残し、collaboration 価値のある状態だけを追記します。