Tools

Epismo MCP server が公開する pack、alias、track tools です。

Pack tools

Tool	用途
`epismo_pack_create`	Workflow/context pack を作成
`epismo_pack_update`	UUID、alias、share URL、hub URL で pack を patch
`epismo_pack_get`	Outline、selected nested content、full content を取得
`epismo_pack_search`	Workflow/context pack を検索
`epismo_pack_like`	Pack を like/unlike
`epismo_pack_delete`	Pack と、その pack を指す自分の alias を削除

大きい pack はまず outline data を読み、その後に必要な stepIds または blockIds だけを取得します。

{
	"reference": "@repo-onboarding"
}

Outline response には contentIndex.stepIds または contentIndex.blockIds が含まれます。その ID を使って selective fetch します。

{
	"reference": "@repo-onboarding",
	"blockIds": ["b001", "b003"]
}

full=true は client がすべての block/step を本当に必要とするときだけ使います。

epismo_pack_search は credit を消費します。Agent に大きな pack 全体を渡す前に、outline で必要な content を絞り込んでください。

Pack creation example

{
	"type": "context",
	"scope": { "type": "projects", "ids": ["project-id"] },
	"title": "Repository onboarding",
	"blocks": [
		{
			"title": "Local setup",
			"content": "Run npm install, then start the services you need."
		}
	]
}

Workflow pack では blocks ではなく steps を渡します。Workflow step assignee は human または agent ID のみです。

Track tools

Tool	用途
`epismo_track_create`	Task/goal を作成
`epismo_track_update`	UUID/URL で task/goal を patch
`epismo_track_get`	1 件の track を取得
`epismo_track_search`	Filter つきで task/goal を検索
`epismo_track_apply`	Track を bulk create/update/delete
`epismo_track_delete`	Track を削除

Agent が複数の関連 task を作る場合は epismo_track_apply が向いています。

{
	"scope": { "type": "projects", "ids": ["project-id"] },
	"updateDrafts": [
		{
			"id": "t001",
			"title": "Review MCP docs",
			"task": { "status": "todo", "dueDate": "2026-06-05" }
		},
		{
			"id": "t002",
			"title": "Publish docs changes",
			"task": { "status": "todo", "dependsOn": ["t001"] }
		}
	]
}

t001 のような非 UUID ID は new track 作成として扱われます。同じ epismo_track_apply call 内では、その label を parentId、dependsOn、goalId に使えます。Server が生成された UUID に解決します。

epismo_track_search は credit を消費します。Agent が探索のために search を繰り返す場合は、query と filter を絞り、必要な record だけ detail get してください。

Task status は backlog, todo, in_progress, done です。Goal status は not_started, on_track, at_risk, postponed, completed です。

Credit behavior

MCP では agent usage と search call が credit を消費します。Credit は OAuth token で解決される current personal/workspace context から消費されます。Credit が不足している場合、tool call は credit/payment error として失敗することがあります。

Alias tools

Tool	用途
`epismo_alias_upsert`	自分が所有する pack の alias を作成または付け替え
`epismo_alias_delete`	自分の alias を削除

Alias input は owner prefix のない alias name です。Leading @ は受け付けられて strip されますが、作成/削除時に @handle/name のような owner prefix は使えません。