// MCP TOOL REFERENCE

PROJECT MCP TOOLS

42 tools from the Project MCP MCP Server, categorised by risk level.

// ALL 42 PROJECT MCP TOOLS

READ 19 tools

Read check_project_state Checks the current state of project management files. Returns which files exist (.project/index.md, ROADMAP... Read get_backlog Reads and returns the current backlog contents with optional filtering. Shows tasks organized by priority w... Read get_decision Reads a specific architecture decision by ADR ID. Returns the full decision content including context, deci... Read get_doc Get the full content of a specific file. Supports files from .project/, root-level, or docs/. Use the path ... Read get_doc_structure Get the complete documentation directory structure with file paths and descriptions. Useful for understandi... Read get_next_task Returns the next task(s) that should be worked on. Considers: dependencies (only returns tasks whose depend... Read get_roadmap Reads the current roadmap content from ROADMAP.md. Returns milestones, phases, and planned work. Read get_task Reads and returns a specific task by ID. Shows all metadata including frontmatter, description, subtasks, a... Read get_thought Reads a specific thought file and returns its raw content for review. Read list_archived_tasks Lists tasks in the archive/ directory. Shows completed work history with optional filtering by project or d... Read list_archived_thoughts Lists all archived thought files with their processing history. Shows what thoughts were processed, when, a... Read list_decisions Lists all architecture decisions from DECISIONS.md with optional filtering by status or tag. Read list_docs List all available documentation files organized by category. Use this to discover what documentation is av... Read list_tasks Lists all tasks with optional filtering. Returns a summary view of tasks organized by status and priority. Read list_thoughts Lists all thought files in the .project/thoughts/ directory structure. Shows available brain dump files org... Read process_thoughts Reads brain dump markdown files from .project/thoughts/todos/ and returns the content along with project co... Read search_docs Search only the docs/ directory for reference documentation. Use this when the user specifically asks for Read search_project Search across project sources with smart intent detection. IMPORTANT: Read search_tasks Search tasks by keyword in title, description, or content. Returns matching tasks with relevance ranking.

WRITE 20 tools

Write init_project Initializes the .project/ directory with all standard files following strict templates. Creates index.md (c... Write sync_todo_index Syncs the parent TODO.md file with all tasks. Generates a dashboard view with tasks organized by status, pr... Write add_decision Adds a single architecture decision record (ADR) to DECISIONS.md. Creates a structured entry with title, co... Write add_roadmap_milestone Adds a milestone or phase to ROADMAP.md. Creates a structured entry with title, description, target date, a... Write add_to_backlog Adds a single item to BACKLOG.md. Use this for quick task creation without bulk import. Items are added to ... Write archive_task Archives a completed task by moving it from todos/ to archive/. Keeps the active task queue small and focus... Write archive_thought Archives a processed thought file by moving it to .project/thoughts/todos/.archive/. Use this after you Write create_or_update_decisions Creates or updates the DECISIONS.md file in .project/ directory. Use this when documenting architecture dec... Write create_or_update_index Creates or updates the index.md file in .project/ directory. This is the contract file that defines how age... Write create_or_update_roadmap Creates or updates the ROADMAP.md file in .project/ directory. Use this when planning future work, mileston... Write create_or_update_status Creates or updates the STATUS.md file in .project/ directory. Use this when updating project health, recent... Write create_or_update_todo Creates or updates the TODO.md file in .project/ directory. Use this when adding tasks, marking items compl... Write create_task Creates a new task with YAML frontmatter metadata. Uses Jira-like IDs (e.g., AUTH-001, API-042) for stable ... Write import_tasks Parses a plan document and imports tasks to BACKLOG.md (not individual files). Use this to populate the bac... Write manage_project_file Smart tool that automatically determines which project file to create or update based on context. Use this ... Write promote_task Promotes a task from BACKLOG.md to an active YAML task file in todos/. Use this when starting work on a bac... Write unarchive_task Restores a task from archive/ back to todos/ for further work. Use when a completed task needs to be reopened. Write update_backlog_item Updates an item in BACKLOG.md. Can change priority, title, tags, or phase without promoting to active work. Write update_project_status Quick status update for the project. Adds a timestamped entry to STATUS.md with the current status, changes... Write update_task Updates an existing task by ID. Can update any field including status, priority, owner, dependencies, etc. ...

DESTRUCTIVE 2 tools

Destructive delete_task Permanently deletes a task from todos/. Use with caution - this cannot be undone. Consider using archive_ta... Destructive remove_from_backlog Removes an item from BACKLOG.md without promoting it. Use for tasks that are no longer needed or were added...

EXECUTE 1 tools

Execute lint_project_docs Validates project documentation against standards. Checks for required files, valid frontmatter, broken dep...

// FAQ

How many tools does the Project MCP MCP server have? +

The Project MCP MCP server exposes 42 tools across 4 categories: Read, Write, Destructive, Execute.

How do I enforce policies on Project MCP tools? +

Route the Project MCP server through the PolicyLayer gateway. Define allow, deny, or approval rules per tool in the dashboard; they are enforced on every call before it reaches the server.

What risk categories do Project MCP tools fall into? +

Project MCP tools are categorised as Read (19), Write (20), Destructive (2), Execute (1). Each category has a recommended default policy.

Enforce policy on every Project MCP tool call.

Start from Project MCP, add the rest of your stack, and see everything your agents can call. Then put policy on all of it.

CHECK YOUR STACK →

Free to start. No card required.

43,000+ MCP servers and 220,000+ tools scanned and risk-classified.