ツール

Epismo MCP サーバーが公開するパック、エイリアス、トラックツールです。

パックツール

ツール	用途	コスト
`epismo_pack_create`	workflow / context pack を作成	5 credits
`epismo_pack_search`	workflow / context pack を検索	5 credits
`epismo_pack_get`	アウトライン、指定したネスト内容、全文を取得	1 credit
`epismo_pack_update`	UUID、エイリアス、共有 URL、ハブ URL でパックを更新	1 credit
`epismo_pack_like`	パックをいいね / 解除	1 credit
`epismo_pack_delete`	パックと、そのパックを指す自分のエイリアスを削除	1 credit

大きいパックはまずアウトラインデータを読み、その後に必要な stepIds または blockIds だけを取得します。

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

アウトラインのレスポンスには contentIndex.stepIds または contentIndex.blockIds が含まれます。その ID を使って必要な部分を取得します。

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

full=true はクライアントがすべてのブロック/ステップを本当に必要とするときだけ使います。

エージェントに大きなパック全体を渡す前に、アウトラインで必要な内容を絞り込んでください。

パック作成の例

{
	"type": "context",
	"scope": { "type": "projects", "ids": ["project-id"] },
	"title": "Team onboarding",
	"blocks": [
		{
			"title": "Where things live",
			"content": "Docs in Notion, code in GitHub, designs in Figma."
		}
	]
}

workflow pack では blocks ではなく steps を渡します。ワークフローステップ担当者は human またはエージェント ID のみです。

トラックツール

ツール	用途	コスト
`epismo_track_search`	フィルターつきでタスク/ゴールを検索	2 credits
`epismo_track_create`	タスク/ゴールを作成	1 credit
`epismo_track_update`	UUID/URL でタスク/ゴールを更新	1 credit
`epismo_track_get`	1件のトラックを取得	1 credit
`epismo_track_apply`	トラックを一括作成 / 更新 / 削除	1 credit
`epismo_track_delete`	トラックを削除	1 credit

エージェントが複数の関連タスクを作る場合は epismo_track_apply が向いています。

{
	"scope": { "type": "projects", "ids": ["project-id"] },
	"upserts": [
		{
			"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 は新規トラック作成として扱われます。同じ epismo_track_apply 呼び出し内では、そのラベルを parentId、dependsOn、goalId に使えます。サーバーが生成された UUID に解決します。

エージェントが探索のために検索を繰り返す場合は、検索語とフィルターを絞り、必要なレコードだけ詳細を取得してください。

タスクのステータスは backlog, todo, in_progress, done です。ゴールのステータスは not_started, on_track, at_risk, postponed, completed です。

クレジットの挙動

各ツールのコストは上の表に記載しています。クレジットは OAuth トークンで解決される現在の個人用 / ワークスペースのコンテキストから消費されます。クレジットが不足している場合、ツール呼び出しはクレジットまたは支払いのエラーとして失敗することがあります。

エイリアスツール

ツール	用途	コスト
`epismo_alias_upsert`	自分が所有するパックのエイリアスを作成または付け替え	1 credit
`epismo_alias_list`	自分の個人用とアクティブなワークスペースのエイリアスを一覧	1 credit
`epismo_alias_delete`	エイリアスを削除	1 credit

エイリアスの入力はエイリアス名です。先頭の @ は受け付けられ、保存時に除去されます。@handle/name の形式は別アカウントのエイリアスを読み取るためのもので、作成・削除には使えません。

epismo_alias_upsert と epismo_alias_delete は任意の namespace を受け取ります。personal(デフォルト)または workspace(アクティブなワークスペースの共有アカウント。メンバー全員が解決可能)です。エイリアスを作成・付け替え・削除できるのは対象パックの所有者だけです。epismo_alias_list は各エントリの namespace と、すぐ使える reference を返します。