forgespec-mcp

MCP Server for Spec-Driven Development (SDD) — contract validation, task board management, and file reservation for multi-agent AI systems.

Works with any MCP-compatible client: Claude Code, Codex CLI, Gemini CLI, OpenClaw, and more.

• SDD Contract Validation — Enforce typed contracts across a 9-phase development pipeline
• Task Board — SQLite-backed task management with dependency tracking and auto-unblocking
• File Reservation — Advisory file locking to prevent multi-agent conflicts

npx -y forgespec-mcp

npm install -g forgespec-mcp

claude mcp add forgespec --transport stdio -- npx -y forgespec-mcp

[mcp_servers.forgespec]
command = "npx"
args = ["-y", "forgespec-mcp"]

{
  "mcpServers": {
    "forgespec": {
      "command": "npx",
      "args": ["-y", "forgespec-mcp"]
    }
  }
}

mcp: {
  servers: {
    forgespec: { command: "npx", args: ["-y", "forgespec-mcp"] }
  }
}

| Tool | Description | |------|-------------| | sdd_validate | Validate an SDD contract against phase schema | | sdd_save | Validate and persist a contract | | sdd_history | Get phase transition history for a project | | sdd_phases | Get all phases with transitions and confidence thresholds |

| Tool | Description | |------|-------------| | board_create | Create a new task board | | board_status | Get board status with tasks grouped by status | | board_list | List all boards | | task_add | Add a task with priority, spec ref, and acceptance criteria | | task_claim | Claim a task (checks dependencies) | | task_update | Update task status (auto-unblocks dependents) | | `t