Tools Reference
Planu exposes 32 official MCP tools. They cover the complete Spec Driven Development loop without flooding the agent context with rarely used actions.
Advanced workflows still exist, but they are intentionally delivered through skills, CLI commands, and internal pipelines instead of being loaded into every MCP session.
Official MCP Tools
| Tool | Purpose |
|---|---|
planu_status | Get the current project/spec state before deciding what to do next. |
facilitate | Start from a natural-language request and route it into the SDD workflow. |
init_project | Initialize Planu for a project and detect its stack/context. |
clarify_requirements | Ask structured questions when product intent is incomplete. |
create_spec | Create an English spec.md from approved requirements. |
challenge_spec | Stress-test the spec through product, architecture, security, and QA lenses. |
check_readiness | Gate whether the spec is detailed enough to implement. |
update_status | Move a spec through draft, review, approved, implementing, done, or discarded. |
package_handoff | Build a compact implementation context pack for the agent. |
validate | Compare code against the approved spec and acceptance criteria. |
reconcile_spec | Bring the spec back in sync when implementation changed intentionally. |
create_rule | Add a project rule for the active AI host. |
create_skill | Add a project skill for repeatable workflows. |
skill_search | Discover relevant skills before repeatable implementation patterns. |
Why Only 32?
Large MCP tool lists cost tokens and reduce model focus. Planu keeps the default MCP surface small so the agent sees the lifecycle it must follow:
intent → questions → spec → challenge → readiness → approval → handoff → validate → done
Roles such as Product Analyst, Architect, Security Reviewer, QA Engineer, Implementer, and Validator are handled inside the workflow rather than as separate public tools.
Tools vs Skills
| Tools | Skills | |
|---|---|---|
| What | Focused SDD operations | Multi-step workflows and best-practice procedures |
| Where | MCP server | Host skill files loaded on demand |
| Example | create_spec, validate, update_status | /autonomous-sdd, /implement-spec, /release |
Use a tool for one SDD operation. Use a skill when you want a repeatable workflow.