Skip to main content
Glama
jcosta33

swarm-mcp

by jcosta33
OverviewSchemaRelated ServersScoreDiscussions
TypeScript
Local

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
SWARM_BINNoPath to the swarm binary (default: 'swarm' on PATH)swarm
SWARM_WORKSPACEYesThe workspace root path for swarm-mcp

Instructions

Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.

This server publishes no instructions, or was last inspected before Glama recorded them.

Capabilities

Features and capabilities supported by this server

Protocol revision2025-11-25

CapabilityDetails
tools
{
  "listChanged": true
}
prompts
{
  "listChanged": true
}
resources
{
  "listChanged": true
}

Tools

Functions exposed to the LLM to take actions

NameDescription
swarm_get_statusA

The derived workspace board — specs, their tasks, and review status. Read-only; no verdict.

swarm_check_workspaceA

Run the Swarm checks contract over every spec + change plan. Returns diagnostics, never a verdict.

swarm_check_fileA

Run the Swarm checks contract over one file (spec / task / review / change-plan). Returns diagnostics, never a verdict.

swarm_scan_taskA

Reconcile a task against its spec and the worktree diff to surface coverage gaps, out-of-scope changes, and self-report mismatches — before a review packet exists. Same engine as reconcile_review. Never a verdict. If the task has no live worktree, returns a structured "not runnable here" result, not an error.

swarm_reconcile_reviewA

Reconcile a finished run: compare task, spec, review packet, and git diff. Returns coverage gaps, empty-evidence Pass rows, scope drift, and self-report mismatches as facts + a derived human-attention list. Never issues a final verdict — a human or an independent reviewer owns the result.

swarm_validate_review_packetA

Run the review-file checks (C012 coverage, C013 verify-evidence) over a review packet: structure, status, and that Pass rows carry evidence. The diff-aware half (out-of-scope, self-report) comes from reconcile_review when a worktree exists. Returns diagnostics, never a verdict.

swarm_get_taskA

The task packet`s scope, affected areas, claimed changes, and frontmatter (id/source/status). Read-only.

swarm_get_specA

The spec`s frontmatter, requirements (id + line + named verify command), and sections. Read-only.

swarm_get_reviewA

The review packets status, coverage rows, and verify blocks. Read-only; the verdict is the humans.

swarm_get_checksA

The checks contract — version + the core checks (id/name/severity). What review must satisfy.

Prompts

Interactive templates invoked by user choice

NameDescription
swarm_task_briefingPrepare to work on a task: read its scope, do-not-change list, verify items, and open questions first.
swarm_before_doneThe implementer-facing pre-handoff check: clean the mechanical drift you can see — but you cannot sign off.
swarm_review_assistantHelp an INDEPENDENT reviewer: re-derive the facts, treat a clean reconcile as something to falsify, not trust.
swarm_evidence_ruleA claim is not evidence; an empty Evidence cell is Unverified, never Pass.
swarm_finding_candidateScaffold a durable finding from a discovered fact — as a candidate, never accepted.

Resources

Contextual data attached and managed by the client

NameDescription
workspaceWorkspace root, mode, and the current board summary.
statusThe derived workspace board — specs, tasks, reviews, gaps.
checksThe checks contract — version + the core checks.

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/jcosta33/suspec-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server