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.