How do I connect Squad MCP Server to Claude?

Run `claude mcp add squad-mcp -- npx -y @gempack/squad-mcp` in Claude Code, or add the same command and arguments under mcpServers in Cursor's mcp.json or Claude Desktop's claude_desktop_config.json, then restart the client. The blocks above are ready to paste.

Is Squad MCP Server free?

The listed licence is Apache-2.0. Check the upstream terms for permitted use and commercial requirements; a public repository does not by itself mean the software is free or open source. Connected APIs and hosted services may have separate charges.

What can Squad MCP Server do?

Squad MCP Server documents 26 tools to the agent, including apply_consolidation_rules, classify_work_type, compose_advisory_bundle. The descriptions above come from project documentation. A live handshake does not test individual tool behavior.

Squad MCP

Unclaimed

by ggemba

MCP server + Claude Code plugin: multi-agent advisory squad with PRD-decomposed tasks, persistent learnings, weighted rubric scorecard, and PR posting.

Set up this server

Compare servers My Stack

01 / Choose your client

02 / Before you connect

Authentication is not specified. Check the project instructions before connecting.

Install the runtime required by the project and make it available to your client.

Project instructionsEnvironment variable names (optional)

Use names from the project instructions, separated by commas. Enter names only, never secret values.

03 / Add the configuration

Source: generated from public install instructions

claude mcp add --transport stdio 'squad-mcp' -- 'npx' '-y' '@gempack/squad-mcp'

Run in your terminal after replacing any placeholders.

04 / Check it in your client

Open your client’s MCP settings and confirm the server connects and lists its tools. A copied configuration does not confirm a working connection.

ai-agentsclaude-codeclaude-code-plugincode-reviewmcpmcp-servernpm-packagetask-managementtypescript

Is this your MCP server?

This listing was auto-indexed from the public record. Claim it to edit the page, set compatibility and unlock growth tools. Takes under two minutes.

Claim this server

Security profile

Claimed and verified servers get a weekly static scan that shows what the code can reach: external services, environment variables, shell commands, agent configuration folders, plus any dependencies with known advisories. Claim this listing to get one. How the security profile works

26 of 26 tools

Documented tools (26)

From project documentation. A server handshake does not verify each tool’s description or behavior.

apply_consolidation_rules

Aggregate advisory reports → final verdict (APPROVED / CHANGESREQUIRED / REJECTED). Returns weighted rubric scorecard when reports carry per-dimension scores.

classify_work_type

Heuristic WorkType from prompt + paths (Feature / Bug Fix / Refactor / Performance / Security / Business Rule) with Low/Medium/High confidence.

compose_advisory_bundle

One-call full bundle: composesquadworkflow + slicefilesforagent per selected agent + validateplantext.

compose_prd_parse

Build a prompt + JSON schema for the host LLM to decompose a PRD into atomic tasks. Pure-MCP: server does NO LLM calls. Caller (skill) feeds the prompt to its model, then calls recordtasks after user confirmation.

compose_squad_workflow

One-call pipeline: detectchangedfiles → classifyworktype → scorerisk → selectsquad.

detect_changed_files

Hardened git diff --name-status --no-renames for a workspace. Allowlisted refs, 10s timeout, 1MB stdout cap.

expand_task

Append subtasks to an existing task. Mechanical only — caller (skill or LLM) supplies the subtask inputs.

get_agent_definition

Return the full markdown system prompt for an agent (local override → embedded default).

init_local_config

Copy embedded defaults to the local override directory so they can be edited.

list_agents

List configured agents with role, ownership, naming conventions.

list_runs

Read-only journal read. Folds the two-row pair by id, filters (since / limit / agent / verdict / mode / invocation / worktype), and returns either the folded list or an aggregate bundle (outcomes + health + trend) when aggregate: true.

list_tasks

Read tasks from .squad/tasks.json. Filters: status, agent (matches agenthints), changedfiles (glob match against task scope).

next_task

Pick the next ready task: candidate status (default pending), all dependencies done, optional agent / changedfiles filter. Tiebreak priority then id. Returns null + reason when none ready.

prune_learnings

Lifecycle maintenance (v0.11.0+): mark entries older than maxagedays as archived and entries with ≥ minrecurrence accepts on the same canonicalised finding as promoted. Atomic rewrite under file lock. Never auto-runs.

read_learnings

Load past accept/reject decisions from .squad/learnings.jsonl. Filters by agent / decision / changed-file scope. Returns entries plus a markdown block ready to inject into agent or consolidator prompts.

read_squad_config

Read and resolve .squad.yaml (or .squad.yml) at workspaceroot. Returns effective weights, threshold, minscore, skippaths, disableagents.

record_learning

Append one accept/reject decision to .squad/learnings.jsonl. Side-effecting; the skill (or CLI) is responsible for per-finding user authorisation.

record_run

Append one RunRecord to .squad/runs.jsonl. Single-writer contract: only the squad skill calls this (Phase 1 inflight + Phase 10 terminal). Validates against schemaversion 1, enforces 4 KB per-record cap, file mode 0o600.

record_tasks

Bulk-create tasks. Allocates ids sequentially, validates dependencies resolve (forward refs in batch ok), rejects duplicates and self-deps. Atomic write.

score_risk

Compute Low/Medium/High from boolean signals (auth, money, migration, filescount, newmodule, apichange).

score_rubric

Pure rubric calculator. Takes per-agent scores (0-100) + optional weight overrides, returns weighted score, per-dimension breakdown, and pre-formatted ASCII scorecard.

select_squad

Select advisory agents for a work type. Combines matrix + path hints + content sniff. Returns evidence per file.

slice_files_for_agent

Filter a file list to those owned by a single agent. Used to build sliced advisory prompts.

slice_files_for_task

Filter a file list to those matching a task's scope glob. Same glob primitive as skippaths and learnings scope.

update_task_status

Flip a task or subtask status: pending / in-progress / review / done / blocked / cancelled.

validate_plan_text

Advisory check for inviolable-rule violations in a plan (commit/push fences, emojis in code blocks, non-English identifiers, impl-before-approval).

Tool change history

Compared across complete checks of the same configuration. Tools were listed, not invoked. Input-schema changes are not measured here.

No complete tool checks yet.

FAQ

Questions about Squad MCP Server

How do I connect Squad MCP Server to Claude?: Run `claude mcp add squad-mcp -- npx -y @gempack/squad-mcp` in Claude Code, or add the same command and arguments under mcpServers in Cursor's mcp.json or Claude Desktop's claude_desktop_config.json, then restart the client. The blocks above are ready to paste.
Is Squad MCP Server free?: The listed licence is Apache-2.0. Check the upstream terms for permitted use and commercial requirements; a public repository does not by itself mean the software is free or open source. Connected APIs and hosted services may have separate charges.
What can Squad MCP Server do?: Squad MCP Server documents 26 tools to the agent, including apply_consolidation_rules, classify_work_type, compose_advisory_bundle. The descriptions above come from project documentation. A live handshake does not test individual tool behavior.