CTRLRun Operator — Claude Code MCP server: features and setup
Review CTRLRun requests waiting for a human decision, then approve or reject them from an MCP client.
claude mcp add ctrlrun-mcp-operator -- uvx ctrlrunWhat CTRLRun Operator does
CTRLRun Operator brings CTRLRun’s pending approval workflow into an MCP client. It lets you list held requests, inspect one, and decide whether to grant or deny it. This is useful when an agent must pause for a person before a sensitive action proceeds.
In Claude Code, launch the server with uvx ctrlrun through the MCP registration command. The server exposes CTRLRun approvals; it does not replace CTRLRun’s rules or request handling. That distinction matters: this MCP server is the interface for responding to pending decisions.
What it helps with
- find CTRLRun actions awaiting a human decision
- inspect a pending request before responding
- grant an action that is waiting for approval
- deny an agent’s pending request
Example prompts for the agent
- List CTRLRun requests waiting for a human decision.
- Inspect the pending request and explain what action needs approval.
- Reject this CTRLRun request.
How to install CTRLRun Operator
Platform CLI
claude mcp add ctrlrun-mcp-operator -- uvx ctrlrunuvx runs the command named after the package; if the README names another one, use uvx --from ctrlrun <command>
Platform CLI
codex mcp add ctrlrun-operator -- uvx ctrlrunuvx runs the command named after the package; if the README names another one, use uvx --from ctrlrun <command>
Config file
{
"mcpServers": {
"ctrlrun-operator": {
"command": "uvx",
"args": [
"ctrlrun"
]
}
}
}uvx runs the command named after the package; if the README names another one, use uvx --from ctrlrun <command>
Config file
{
"servers": {
"ctrlrun-operator": {
"type": "stdio",
"command": "uvx",
"args": [
"ctrlrun"
]
}
}
}uvx runs the command named after the package; if the README names another one, use uvx --from ctrlrun <command>
Platform CLI
gemini mcp add ctrlrun-operator uvx ctrlrunuvx runs the command named after the package; if the README names another one, use uvx --from ctrlrun <command>
Step 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 CTRLRun Operator
How do I install CTRLRun Operator in Claude Code?
Run claude mcp add ctrlrun-mcp-operator -- uvx ctrlrun. The alternate server name is claude mcp add ctrlrun-operator -- uvx ctrlrun.
What does CTRLRun Operator do?
It lets an MCP client view CTRLRun requests awaiting approval, inspect a request, and grant or deny it.
Can I approve or reject a request with it?
Yes. CTRLRun Operator lets you grant or deny a pending CTRLRun request.
