全 38 tools リファレンス

呼び出しパターン: tool_name({ action: "verb", ...params })。organization_id は credentials から自動解決されるため、単一 org の場合は省略可能。api_url も同様。

Purple Codens (7 tools) — AI 開発オーケストレーション

Tool	主な actions	説明
`purple_auth`	`login`, `whoami`	Device Code Flow / browser OAuth / email+password でログイン。`~/.purple-codens/credentials.json` に token 保存。
`purple_project`	`analyze_repo`, `list_projects`, `init_project`	ローカル repo 構造解析・project 一覧・新規 project 作成（repo link + instruction import を一括）。
`purple_repository`	`add`, `list`	GitHub repo の project への紐付け / 一覧。
`purple_instruction`	`import`, `list`, `sync`	CLAUDE.md / .claude/rules/ を GitHub から取得・diff・同期。
`purple_workflow`	`create_workflow`, `get_run_status`, `list_runs`, `cancel_run`, `inject_message`	Workflow run の生成・進捗確認・一覧・中断、長時間 heartbeat job へのメッセージ注入。
`purple_sse`	`subscribe_run_events`	Workflow run の SSE イベントを stream 購読。
`purple_log`	`get_run_logs`, `get_task_log_url`	VPS / Fargate job の log を取得（S3 presigned URL、1 時間有効）。

Red Codens (4 tools) — エラー検知 → 自動修正 PR

Tool	主な actions	説明
`red_bug_report`	`create`, `create_full`, `list`, `get`, `update`, `analyze`, `retry_analyze`	Bug report の CRUD + AI 解析。`auto_analyze=true` で create と同時に解析開始。
`red_bug_fix_plan`	`generate`, `get`, `get_by_bug`, `submit_to_purple`, `resubmit`	Fix plan の生成・取得・Purple Codens への提出。Purple chain で PR 生成。
`red_fix_proposal`	`create`, `list`, `get`, `get_by_error`	Sentry error 等から fix proposal を作成・参照。
`red_external_task`	`list`, `get`, `execute`	外部システム連携タスクの一覧・実行。

Blue Codens (1 tool) — QA 自動化

Tool	主な actions	説明
`blue_e2e_test`	`list`, `generate`, `run`, `get_results`	E2E テストの一覧 / 自然言語要件からの生成（Playwright）/ 実行 / 結果取得（video, trace, network log）。

Green Codens (24 tools) — PRD / Plan / Kickoff 管理

Tool	主な actions	説明
`green_consultation`	`create_with_message`, `send_message`, `convert_to_prd`, `convert_to_kickoff`, `convert_to_bug_report`, ...	相談セッションの作成・チャット・PRD / Kickoff / Bug 変換。曖昧な要望の構造化のエントリポイント。
`green_prd`	`create`, `list`, `get`, `update`, `update_section`, `approve`, `submit_for_review`, `archive`, `link_notion`, ...	PRD の CRUD + ライフサイクル（review / approve / archive）+ Notion 連携。
`green_prd_ai`	`generate`, `generate_sync`, `regenerate`, `regenerate_section`, `get_status`	Claude による PRD 全体 / セクション単位の生成 / 再生成（非同期 + 同期）。
`green_prd_template`	`list`, `list_org`, `create`, `create_default`, `update`, `set_default`, `reorder_sections`, `delete`	PRD テンプレート（セクション構成）の管理。
`green_prd_comment`	`create`, `list`, `list_replies`, `resolve`, `get_translation`, ...	PRD へのインラインコメントとスレッド管理。
`green_prd_review`	`create`, `list`, `respond`, `cancel`, `list_my_requested`	PRD レビュー依頼の発行 / 応答管理。
`green_prd_attachment`	`get_upload_url`, `confirm_upload`, `direct_upload`, `list`, `get`, `delete`	PRD への添付ファイル管理（S3 presigned URL）。
`green_prd_translate`	翻訳系	PRD の多言語化（ja ↔ en）。
`green_plan`	`create`, `list_by_project`, `get`, `create_version`, `generate_from_prd`, `submit_to_purple`	Plan（実装タスク分解）の作成・バージョン管理・Purple への提出。
`green_plan_task`	task 系	Plan 配下の個別タスクの管理。
`green_plan_monitoring`	`trigger`, `stop`, `update_settings`, `list_snapshots`	Plan の進捗モニタリング snapshot 制御。
`green_task`	task 系	汎用タスク管理（Notion Tasks DB 連携想定）。
`green_project`	`create`, `list`, `get`, `update`, `delete`, `get_tasks_db_id`, `setup_tasks_db_columns`	Green project の CRUD + Notion Tasks DB の自動セットアップ。
`green_repository`	repo 系	Green project と GitHub repo の紐付け。
`green_organization`	`list`, `get`, `list_members`, `update_member`, `remove_member`, `list_invitations`	Green Codens の organization / member 管理。
`green_knowledge`	knowledge 系	組織ナレッジ（FAQ 等）の管理。
`green_notion`	notion 系	Notion workspace 連携（OAuth link / unlink / status）。
`green_kickoff`	kickoff 系	Kickoff（プロジェクト立ち上げ）セッションの CRUD。
`green_kickoff_wizard`	`start_vision`, `start_scope`, `start_tech`, `start_milestones`, `update_step`, `regenerate_step`	Kickoff ウィザード（Vision / Scope / Tech / Milestones の段階的ヒアリング）。
`green_kickoff_generate`	`generate_prds`, `generate_ui`, `generate_prototype`	Kickoff から PRDs / UI / Prototype をまとめて生成。
`green_kickoff_refine`	`refine_prototype`, `refine_mockup`	Kickoff 成果物の対話的リファイン。
`green_kickoff_prototype`	`get`, `refresh_url`, `list_versions`	Prototype の取得とバージョン履歴。
`green_kickoff_preview`	`list`, `get`, `regenerate`	UI preview の管理。
`green_kickoff_mockup`	`list_versions`	Mockup の version 履歴。

Auth Codens (1 tool) — 認証 / Pricing

Tool	主な actions	説明
`auth_agent`	`signup`, `get_pricing`	既存ユーザーの API key 経由で agent 用の capability token を発行 / 機械可読 pricing.json を取得。

Cross-product (1 tool) — 一括登録

Tool	説明
`codens_register_project_unified`	同一 GitHub repo を Purple / Red / Blue / Green の各サービスに 1 コールで登録（best-effort、各プロダクトごとに ID と errors を返す）。

合計：Purple 7 + Red 4 + Blue 1 + Green 24 + Auth 1 + Cross 1 = 38 tools。完全な action 一覧と引数は PyPI: codens-mcp の README と各 MCP server の discovery 出力を参照してください。