Project
SCRUM MCP
A practical coordination layer for AI agents that share a codebase
I built SCRUM MCP because my AI agents kept stepping on each other's changes. Not in a dramatic sci-fi way. In the very boring and painful way where two agents edit the same file and one silently overwrites the other.
It started as file claims and intent tracking. It has grown into a local-first coordination layer with permissions, budget tracking, compliance history, persistent knowledge, evidence receipts and the practical checks agents need if they are going to do real work without making a mess.
Why I built it
When multiple AI agents edit code at the same time, politeness is not enough. They need shared state and hard rules. SCRUM MCP started with three mechanisms:
- Intent declarations - agents announce what they plan to change before touching any files
- File claims - atomic locks prevent two agents from editing the same file
- Evidence receipts - agents must prove their work with command output before releasing claims
The useful bit was not making agents sound clever. It was making them behave around files, evidence and shared context. Later versions added compliance checks, sprint collaboration, role-based tool permissions, budget tracking, audit history and a searchable knowledge base.
The numbers
44 MCP tools
Full governance + coordination toolkit covering RBAC, budgets, compliance history, knowledge base, intents, claims, evidence, and sprints.
7 agents coordinated
Running across shared codebases without file conflicts or lost work.
12 issues / 2hrs
Agent productivity after Paperclip integration, from zero completions to consistent output.
175KB per heartbeat
Context output per agent cycle, up from 2.8KB before inbox pre-processing.
Paperclip Integration (v0.6)
The real test was running a group of named agents across several web projects at once. Very quickly the problem stopped being "can the model write code?" and became "can it see the right work, avoid touching the wrong files, and prove what it did?"
The inbox pre-processor solved one of the least glamorous but most important problems: agents could not call the APIs they were being told to use. So the system brought the task queue to them instead. Result: productivity went from zero completions to 12 issues resolved in 2 hours.
Governance Pillars
RBAC on Tools
5 roles (admin/lead/developer/reviewer/observer) with default tool sets. Custom per-agent overrides. Permission guard blocks unauthorised MCP calls.
Budget Tracking
Log tokens and cost per agent per task. Set limits with 80% warnings and hard blocks. Daily, per-task, and per-sprint periods.
Compliance History
Every compliance check auto-recorded. Query by agent, task, or date range. Trend analysis with avg score and compliance rate.
Knowledge Base
Persistent cross-sprint knowledge with FTS5 full-text search. Categories: lesson, SOP, architecture, pitfall, decision. Promote sprint shares to permanent entries.
How it works
Declare Intent
Agent announces planned changes and affected files before any code is touched.
Claim Files
Atomic lock prevents conflicts across agents, so no two agents can edit the same file.
Do the Work
Agent executes with full tool access, making changes within the scope of their intent.
Submit Evidence
Command output proves the work was done, with no self-reporting, only verifiable results.
Compliance Check
System verifies that the intent matches the actual changes made to the codebase.
Release Claims
Files are unlocked and available for other agents to claim and work on.
Compatible With
Claude Code
Full MCP integration with Anthropic's CLI agent for autonomous coding workflows.
Cursor
Works with Cursor's MCP support for multi-agent editing in the IDE.
Gemini CLI
Compatible with Google's command-line agent via standard MCP protocol.
OpenCode
Integrates with OpenCode's MCP client for open-source agent coordination.
Continue
Supports Continue's MCP integration for collaborative AI development.
Any MCP Client
Standard MCP protocol means any compatible client can coordinate through SCRUM.
For agents that need to share the same files
SCRUM MCP gives a multi-agent setup intent declarations, file claims and compliance checks so the work is visible before something gets overwritten.