All 38 tools — Codens Help

Call pattern: tool_name({ action: "verb", ...params }). organization_id is resolved from credentials automatically, so single-org users can omit it. The same applies to api_url.

Purple Codens (7 tools) — AI development orchestration

Tool	Main actions	Description
`purple_auth`	`login`, `whoami`	Log in via Device Code Flow / browser OAuth / email+password. Token saved to `~/.purple-codens/credentials.json`.
`purple_project`	`analyze_repo`, `list_projects`, `init_project`	Analyze a local repo, list projects, or create a new one (repo link + instruction import in one go).
`purple_repository`	`add`, `list`	Link a GitHub repo to a project, or list links.
`purple_instruction`	`import`, `list`, `sync`	Fetch, diff, and sync CLAUDE.md / .claude/rules/ from GitHub.
`purple_workflow`	`create_workflow`, `get_run_status`, `list_runs`, `cancel_run`, `inject_message`	Create, observe, list, or cancel workflow runs, and inject messages into long-running heartbeat jobs.
`purple_sse`	`subscribe_run_events`	Stream workflow run events via SSE.
`purple_log`	`get_run_logs`, `get_task_log_url`	Fetch VPS / Fargate job logs (S3 presigned URL, 1-hour validity).

Red Codens (4 tools) — Error detection → auto-fix PR

Tool	Main actions	Description
`red_bug_report`	`create`, `create_full`, `list`, `get`, `update`, `analyze`, `retry_analyze`	CRUD + AI analysis for bug reports. Pass `auto_analyze=true` to analyze on creation.
`red_bug_fix_plan`	`generate`, `get`, `get_by_bug`, `submit_to_purple`, `resubmit`	Generate, fetch, and submit fix plans. The Purple chain produces the PR.
`red_fix_proposal`	`create`, `list`, `get`, `get_by_error`	Create / inspect fix proposals from Sentry errors etc.
`red_external_task`	`list`, `get`, `execute`	List and run external integration tasks.

Blue Codens (1 tool) — QA automation

Tool	Main actions	Description
`blue_e2e_test`	`list`, `generate`, `run`, `get_results`	List / generate (Playwright) / run / fetch results (video, trace, network log) for E2E tests.

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

Tool	Main actions	Description
`green_consultation`	`create_with_message`, `send_message`, `convert_to_prd`, `convert_to_kickoff`, `convert_to_bug_report`, ...	Create / chat in consultations; convert to PRD / Kickoff / Bug. The entry point for structuring vague requests.
`green_prd`	`create`, `list`, `get`, `update`, `update_section`, `approve`, `submit_for_review`, `archive`, `link_notion`, ...	PRD CRUD + lifecycle (review / approve / archive) + Notion link.
`green_prd_ai`	`generate`, `generate_sync`, `regenerate`, `regenerate_section`, `get_status`	Claude-powered PRD generation / regeneration, whole-doc or per-section (async + sync).
`green_prd_template`	`list`, `list_org`, `create`, `create_default`, `update`, `set_default`, `reorder_sections`, `delete`	Manage PRD templates (section structures).
`green_prd_comment`	`create`, `list`, `list_replies`, `resolve`, `get_translation`, ...	Inline comments and threads on PRDs.
`green_prd_review`	`create`, `list`, `respond`, `cancel`, `list_my_requested`	Manage PRD review requests / responses.
`green_prd_attachment`	`get_upload_url`, `confirm_upload`, `direct_upload`, `list`, `get`, `delete`	Manage PRD attachments (S3 presigned URLs).
`green_prd_translate`	translation actions	PRD localization (ja ↔ en).
`green_plan`	`create`, `list_by_project`, `get`, `create_version`, `generate_from_prd`, `submit_to_purple`	Manage Plans (task breakdowns), versioning, and submission to Purple.
`green_plan_task`	task actions	Manage individual tasks under a Plan.
`green_plan_monitoring`	`trigger`, `stop`, `update_settings`, `list_snapshots`	Control progress-monitoring snapshots for a Plan.
`green_task`	task actions	Generic task management (designed for Notion Tasks DB integration).
`green_project`	`create`, `list`, `get`, `update`, `delete`, `get_tasks_db_id`, `setup_tasks_db_columns`	CRUD for Green projects + auto-provisioning of the Notion Tasks DB.
`green_repository`	repo actions	Link Green projects to GitHub repositories.
`green_organization`	`list`, `get`, `list_members`, `update_member`, `remove_member`, `list_invitations`	Green Codens organization / member management.
`green_knowledge`	knowledge actions	Manage organization knowledge entries (FAQs, etc.).
`green_notion`	notion actions	Notion workspace integration (OAuth link / unlink / status).
`green_kickoff`	kickoff actions	CRUD for Kickoff sessions (greenfield project bootstraps).
`green_kickoff_wizard`	`start_vision`, `start_scope`, `start_tech`, `start_milestones`, `update_step`, `regenerate_step`	Stepwise Kickoff wizard (Vision / Scope / Tech / Milestones).
`green_kickoff_generate`	`generate_prds`, `generate_ui`, `generate_prototype`	Generate PRDs / UI / prototype from a Kickoff session.
`green_kickoff_refine`	`refine_prototype`, `refine_mockup`	Interactively refine Kickoff artifacts.
`green_kickoff_prototype`	`get`, `refresh_url`, `list_versions`	Fetch a prototype and inspect version history.
`green_kickoff_preview`	`list`, `get`, `regenerate`	Manage UI previews.
`green_kickoff_mockup`	`list_versions`	Mockup version history.

Auth Codens (1 tool) — Identity / pricing

Tool	Main actions	Description
`auth_agent`	`signup`, `get_pricing`	Mint agent capability tokens from an existing user's API key, or fetch the machine-readable pricing.json.

Cross-product (1 tool) — Bulk registration

Tool	Description
`codens_register_project_unified`	Register the same GitHub repo to Purple / Red / Blue / Green in a single call (best-effort; returns ID + errors per product).

Total: Purple 7 + Red 4 + Blue 1 + Green 24 + Auth 1 + Cross 1 = 38 tools. For the complete action list and argument schemas, see the PyPI codens-mcp README and each MCP server's discovery output.