ControlKeel — Claude Code MCP server: what it does, how to install
Enforces project policies on AI agent outputs using deterministic validation checks and human review gates.
claude mcp add controlkeel -- npx -y @aryaminus/controlkeelWhat ControlKeel does
ControlKeel intercepts AI coding tasks before changes hit production branches. Markdown prompt files merely suggest rules. Models frequently ignore them during complex work. ControlKeel replaces loose guidelines with machine-validated policy checks.
The system packages a CLI alongside a local stdio MCP tool suite. It stores policy findings and review proofs across host switches. Automated scanner checks consume 0 provider tokens.
Setup defaults to repository scope. Your agent host requires a full restart after running attach commands.
What it helps with
- Block risky code modifications before they merge into the main branch
- Retain review findings and audit proof across different agent sessions
- Run deterministic policy validations with 0 token spend
- Enforce explicit human review gates on high-impact agent actions
Example prompts for the agent
- Run controlkeel status to see active policies and pending findings
- Inspect our current branch with controlkeel findings before pushing
- Execute controlkeel attach doctor to verify agent host integration
How to install ControlKeel
Platform CLI
claude mcp add controlkeel -- npx -y @aryaminus/controlkeelPlatform CLI
codex mcp add controlkeel -- npx -y @aryaminus/controlkeelConfig file
{
"mcpServers": {
"controlkeel": {
"command": "npx",
"args": [
"-y",
"@aryaminus/controlkeel"
]
}
}
}Config file
{
"servers": {
"controlkeel": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@aryaminus/controlkeel"
]
}
}
}Platform CLI
gemini mcp add controlkeel npx -y @aryaminus/controlkeelStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about ControlKeel
How do I install ControlKeel in Claude Code?
Run claude mcp add controlkeel -- npx -y @aryaminus/controlkeel in your terminal.
What does ControlKeel do?
It validates agent output against defined project policies, tracks findings, and gates dangerous changes until a human approves them.
Where does ControlKeel save its configuration?
By default, attach commands apply project scope and write configuration files strictly inside the target repository.
