MCP Tools Reference
Complete catalog of 104 MCP tools exposed by the protoLabs server. See packages/mcp-server/src/tools/ for the full definitions.
For installation and configuration, see Claude Plugin Setup. For commands and examples, see Plugin Commands.
This page is generated from
packages/mcp-server/src/tools/*.ts. Regenerate withnode scripts/gen-mcp-tools-doc.mjs.
Feature Management (9 tools)
| Tool | Description |
|---|---|
list_features | List all features in a project. Returns features organized by status (backlog, in-progress, review, done). |
get_feature | Get detailed information about a specific feature including its description, status, and agent output. |
create_feature | Create a new feature on the Kanban board. Features start in the backlog by default. |
update_feature | Update a feature's properties. Can be used to change status, title, description, or move between columns. |
delete_feature | Delete a feature from the board. This is a destructive action. |
update_feature_git_settings | Update git workflow settings for a specific feature. Override global git workflow settings (auto-commit, auto-push, auto-PR, auto-merge)... |
rollback_feature | Rollback a deployed feature by reverting its merge commit. Finds the merge commit from the feature's prNumber, runs git revert -m 1, and... |
list_workflows | List all available workflows for a project. Returns built-in workflows (standard, read-only, content, audit, research, tech-debt-scan, po... |
reconcile_feature_with_pr | Manually reconcile a feature with a merged GitHub PR. Use this when a feature shipped via an out-of-band PR (cherry-pick, re-cut branch,... |
Agent Control (5 tools)
| Tool | Description |
|---|---|
start_agent | Start an AI agent to work on a feature. The agent will create a git worktree and begin implementation. |
stop_agent | Stop a running agent. |
list_running_agents | List all currently running agents across all projects. |
get_agent_output | Get the output/log from an agent's execution on a feature. Useful for reviewing what the agent did. |
send_message_to_agent | Send a message to a running agent. Use this to provide clarification or additional instructions. |
Queue Management (3 tools)
| Tool | Description |
|---|---|
queue_feature | Add a feature to the agent queue for processing. Features in queue are automatically picked up. |
list_queue | List all features currently in the agent queue. |
clear_queue | Clear all features from the agent queue. This is a destructive action. |
Context & Skills (4 tools)
| Tool | Description |
|---|---|
list_context_files | List all context files in a project's .automaker/context/ directory. These files are injected into agent prompts. |
get_context_file | Read the contents of a context file. |
create_context_file | Create a new context file that will be injected into all agent prompts for this project. |
delete_context_file | Delete a context file. |
Orchestration (6 tools)
| Tool | Description |
|---|---|
set_feature_dependencies | Set dependencies for a feature. The feature will not start until all dependencies are marked Done. |
get_dependency_graph | Get the dependency graph for all features in a project. Shows which features block others. Pass an optional featureId to get detailed dep... |
start_auto_mode | Start auto-mode for a project. Agents will automatically pick up and process backlog features respecting dependencies. |
stop_auto_mode | Stop auto-mode for a project. |
get_auto_mode_status | Check if auto-mode is running for a project and get its status. |
get_execution_order | Get the resolved execution order for features based on dependencies. Useful for planning. |
Project Orchestration (17 tools)
| Tool | Description |
|---|---|
get_project_spec | Get the project specification from .automaker/spec.md. This provides architectural context to agents. |
update_project_spec | Update the project specification. This is shown to agents for architectural context. |
list_projects | List all project plans in a project. Returns project slugs that can be used with get_project. |
get_project | Get detailed information about a project plan including milestones, phases, and PRD. |
create_project | Create a new project plan with milestones and phases. This scaffolds the project structure in .automaker/projects/. |
update_project | Update a project plan. Can update title, goal, status, or PRD. |
delete_project | Delete a project plan and all its files. This is a destructive action. |
archive_project | Archive a completed project. Slims project.json to mapping data only (slug, title, milestone/phase IDs) and deletes .md files and milesto... |
create_project_features | Create Kanban board features from a project plan. Converts phases to features with optional epic grouping. |
initiate_project | Start a new project lifecycle. Creates a local project cache with the idea description. Returns duplicates if found (caller should confir... |
generate_project_prd | Check if a PRD exists for a project. If not, suggests generating one via the /plan-project skill or create_project tool. Returns existing... |
save_project_milestones | Save structured milestone/phase data to a project. This bridges the gap between PM agent PRD output and approve_project_prd. Call this af... |
approve_project_prd | Approve the PRD and create board features from project milestones. Call after the project has a PRD and milestones defined. |
launch_project | Launch a project and start auto-mode. Requires features to exist in backlog (call approve_project_prd first). |
get_lifecycle_status | Get the current lifecycle phase and next actions for a project. Reads local board state to determine where the project is in the pipeline. |
assign_project | Assign a project to an instance. Writes assignedTo, assignedAt, and assignedBy fields to the project. |
unassign_project | Clear the assignment fields on a project. |
GitHub Operations (9 tools)
| Tool | Description |
|---|---|
merge_pr | Merge a pull request using GitHub CLI. Supports different merge strategies (merge, squash, rebase) and can optionally wait for CI checks... |
check_pr_status | Check the CI check status of a pull request. Returns information about passed, failed, and pending checks. |
get_pr_feedback | Fetch CodeRabbit review feedback for a PR, including both issue-level and inline review threads with severity. Returns parsed feedback wi... |
resolve_pr_threads | Resolve all unresolved CodeRabbit review threads for a PR using the GitHub GraphQL resolveReviewThread mutation. Fetches PRRT_ thread nod... |
list_worktrees | List all git worktrees for a project. Returns worktree paths, branches, and optionally PR info. |
get_worktree_status | Get the git status of a specific worktree for a feature. Returns modified files, diff stats, and recent commits. |
create_pr_from_worktree | Commit, push, and create a PR from a worktree. Handles the full workflow: stage changes, commit, push branch, create GitHub PR. |
get_pr_review_comments | List inline code review comment threads on a PR via GitHub GraphQL API. Returns thread IDs, file paths, line numbers, and comment bodies. |
resolve_pr_comment | Resolve a single PR review thread by thread ID via GitHub GraphQL resolveReviewThread mutation. |
Git Operations (2 tools)
| Tool | Description |
|---|---|
git_enhanced_status | Get detailed per-file git status including index status, work tree status, conflict markers, staged state, and line-change counts. |
git_file_details | Get the last commit information for a specific file including commit hash, message, author, and timestamp. |
Lead Engineer (4 tools)
| Tool | Description |
|---|---|
start_lead_engineer | Start the Lead Engineer to manage a project through the production phase. Orchestrates auto-mode, reacts to events with fast-path rules,... |
stop_lead_engineer | Stop the Lead Engineer from managing a project. |
get_lead_engineer_status | Get Lead Engineer status including world state, flow state, rule execution log, and metrics. |
get_feature_handoff | Get the latest Lead Engineer phase handoff document for a feature. Handoff documents summarise what was done in each lifecycle phase (INT... |
Notes & Workspace (6 tools)
| Tool | Description |
|---|---|
query_board | Query features with compound filters. Supports filtering by status, epic, complexity, blocked state, dependencies, date range, and text s... |
list_note_tabs | List all note tabs in a project workspace. Returns tab names, permissions (agentRead/agentWrite), and word counts. Only tabs with agentRe... |
read_note_tab | Read the content of a specific note tab. Requires agentRead permission on the tab. Returns HTML content, word count, and metadata. |
write_note_tab | Write content to a specific note tab. Requires agentWrite permission on the tab. Supports replace (default) or append mode. Content shoul... |
create_note_tab | Create a new note tab in the workspace. Returns the created tab with its ID. |
delete_note_tab | Delete a note tab from the workspace. Cannot delete the last remaining tab. |
Content Pipeline (6 tools)
| Tool | Description |
|---|---|
create_content | Start a new content creation pipeline flow. Runs research → outline → writing → antagonistic review → export phases via LangGraph. Runs a... |
get_content_status | Get the current status of a content creation flow run. Returns progress (0-100), current node, review scores for each phase (research/out... |
list_content | List all content items for a project. Returns metadata about generated content including topic, format, status, review scores, and output... |
review_content | Submit a HITL review decision at a content flow interrupt gate. Only applicable when the flow was started with enableHITL=true and is cur... |
export_content | Export completed content to a specific format. The run must be in "completed" status. Formats: markdown (raw .md), frontmatter-md (YAML f... |
execute_antagonistic_review | Run an antagonistic quality review on content text. Scores across 6 dimensions on a 1-10 scale: Accuracy (factual correctness), Usefulnes... |
Observability (5 tools)
| Tool | Description |
|---|---|
get_settings | Get global Automaker settings including theme, log level, auto-mode config, and project profiles. |
update_settings | Update global Automaker settings. Pass only the fields you want to change. |
get_project_metrics | Get aggregated project metrics including cycle time, cost, throughput, success rate, and token usage. |
get_capacity_metrics | Get capacity utilization metrics including concurrency, backlog size, and estimated backlog clearance time. |
get_forecast | Estimate duration and cost for a new feature based on historical averages scaled by complexity. |
Knowledge (4 tools)
| Tool | Description |
|---|---|
knowledge_search | Search the knowledge store using hybrid retrieval (BM25 + vector). Returns relevant chunks for the given query, optionally filtered by do... |
knowledge_ingest | Add a text chunk to the knowledge store with a required domain tag for categorization. |
knowledge_rebuild | Rebuild the knowledge store FTS5 index. Use after bulk changes to ensure search reflects the latest content. |
knowledge_stats | Get statistics about the knowledge store, including total chunk counts grouped by domain. |
QA (1 tools)
| Tool | Description |
|---|---|
run_qa_check | Run a consolidated QA health check that aggregates server health, service wiring, scheduler timers, deployment tracking, DORA metrics, bo... |
Portfolio (2 tools)
| Tool | Description |
|---|---|
sync_registry | Compare Studio settings.projects[] against the Workstacean project registry. Reports missing projects (in Workstacean but not in settings... |
get_portfolio_sitrep | Get a fleet-wide portfolio status report aggregating all active projects in one call. Returns per-project health (green/yellow/red), acti... |
Scheduler (2 tools)
| Tool | Description |
|---|---|
get_scheduler_status | Get the status of all scheduled timers (cron tasks and managed intervals) including their schedules, enable/disable state, execution coun... |
update_maintenance_task | Update a maintenance task — enable/disable it or change its cron schedule. Changes persist across server restarts via GlobalSettings. |
Cross-Repo (3 tools)
| Tool | Description |
|---|---|
get_cross_repo_dependencies | Get the cross-repository dependency graph across all projects in the portfolio. Returns nodes (repos), edges (dependencies with type and... |
flag_cross_repo_dependency | Record a cross-repository dependency on a feature. Call this when a PR introduces a breaking interface change that affects other repos (e... |
resolve_cross_repo_dependency | Mark a cross-repository dependency as satisfied. Call this when the foreign feature has reached done/review status and the blocking dep s... |
SetupLab (6 tools)
| Tool | Description |
|---|---|
research_repo | Scan a repository to detect its current tech stack, structure, and configuration. Returns detailed research results including monorepo se... |
analyze_gaps | Compare repository research results against the ProtoLabs gold standard. Returns a structured gap analysis report with alignment score, g... |
propose_alignment | Convert gap analysis into alignment features organized into milestones. Optionally creates features on the Automaker board. Returns miles... |
provision_discord | Create Discord category and channels for a project. Creates a category named after the project with #general, #updates, and #dev channels. |
generate_report | Generate a self-contained HTML report from gap analysis and research results. Saves to {projectPath}/protoLabs.report.html and automatica... |
run_full_setup | Run the complete setup pipeline: clone (if git URL), research repo, analyze gaps, generate HTML report, initialize .automaker, generate p... |
Integrations (4 tools)
| Tool | Description |
|---|---|
request_user_input | Create a HITL form request that renders as a dialog in the UI. Provide JSON Schema definitions for each form step. Returns a formId — pol... |
get_form_response | Check the status of a HITL form request and retrieve the user response when submitted. Poll this after calling request_user_input. |
list_pending_forms | List all pending HITL form requests for a project. Returns form summaries with formId, title, featureId, and expiresAt. |
submit_form_response | Programmatically submit a response to a pending HITL form. Allows Ava to answer form questions on behalf of the user, which resumes the w... |
Utilities (6 tools)
| Tool | Description |
|---|---|
setup_lab | Initialize Automaker for a new repository. Creates .automaker/ directory structure (features/, context/, memory/), generates protolab.con... |
health_check | Check if the Automaker server is running and healthy. Set detailed: true to include memory usage, uptime, and environment info. |
get_server_logs | Read server log file directly from disk. Works even when the server is down — useful for diagnosing crashes, OOM errors, agent failures,... |
get_sitrep | Get a full operational status report in one call. Returns board summary, running agents, auto-mode status, blocked features, escalations... |
get_briefing | Get a briefing digest of important events since last session. Returns events grouped by severity (critical, high, medium, low) for quick... |
submit_prd | Submit a SPARC PRD from the Chief of Staff to the Project Manager for decomposition and execution. Creates a feature on the board. |