About Circus MCP
Circus MCP is an MCP server published by aether-platform in the Developer Tools category: the Model Context Protocol (MCP) Server for Circus. https://circus.readthedocs.io/en/latest/.
The repository has 2 stars and 1 forks, with the last commit 7 months ago. Six months or more without a commit doesn't mean the server is broken, but check the open issues before depending on it in production.
Install
git clone https://github.com/aether-platform/circus-mcpThis server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.
Tools (6)
add_process`name`, `command`, `numprocesses?`, `working_dir?`
Parameters not published.
get_process_status`name`
Parameters not published.
list_processes—
Parameters not published.
restart_process`name`
Parameters not published.
start_process`name`
Parameters not published.
stop_process`name`
Parameters not published.
Ask AI
Ask AI about Circus MCP
Powered by Claude · Grounded in docs
Security checks
Static checks derived from the repository 5 days ago. Heuristics on the source, not an audit.
- ✓README presentThe repository ships documentation.
- ✓License declaredUsable under a stated license.
- ✓Tests presentA test suite exists in the repository.
- ✓Dependencies pinnedA lockfile pins dependency versions.
- ✓No dynamic code executionSource scan found no eval, dynamic Function, or shell execution.
- !Scoped permissionsDoesn't declare a permission scope. Assume it can do anything its process can.
Releases
README
Circus MCP
Cut 75-80% of AI agent debugging tokens in development cycle. Process management via MCP — structured tools replace shell commands.
75-80% Token Reduction for AI Agent Debugging in Development Cycle
AI agents debugging processes via raw shell commands (supervisorctl, ps, journalctl) burn most of their tokens on unstructured output parsing, repeated commands, and inter-step reasoning. Circus MCP replaces this with structured, bounded MCP tool responses.
| Raw Commands | Circus MCP | Reduction | |
|---|---|---|---|
| Tool calls per investigation | 8-12 | 3-5 | 60-70% |
| Tokens per investigation | 2,900-9,400 | 935-1,535 | ~75% |
| With retries (typical) | ~10,000+ | ~2,000 | ~80% |
| Retry cost scaling | Exponential | Linear | — |
Process Management via MCP
Circus MCP exposes process lifecycle operations as MCP tools. AI agents call structured tools instead of parsing shell output.
| Tool | Parameters | Description |
|---|---|---|
list_processes |
— | List all managed processes |
get_process_status |
name |
Process state and PID |
start_process |
name |
Start a process |
stop_process |
name |
Stop a process |
restart_process |
name |
Restart a process |
add_process |
name, command, numprocesses?, working_dir? |
Add a new process dynamically |
Claude Code
claude mcp add circus-mcp -- uv run circus-mcp mcp
VS Code / Cursor
.vscode/mcp.json:
{
"servers": {
"circus-mcp": {
"command": "uv",
"args": ["run", "circus-mcp", "mcp"]
}
}
}
Circus MCP vs Supervisord MCP
| Circus MCP | Supervisord MCP | |
|---|---|---|
| Dynamic process addition | Via API | Not supported (requires config file edit + reload) |
| Log retrieval | stdout + stderr in one call | Separate calls |
| System stats (CPU/memory) | Available | Not available |
| Idempotent operations | ensure_started / ensure_stopped |
Throws error if already running |
| Transport | ZeroMQ (async) | HTTP XML-RPC (sync) |
| Best for | AI agent workflows | Existing Supervisord environments |
Documentation
- AI Token Reduction Solution — Token cost analysis, team-scale projections, research references
- AI & MCP Technical Background — Architecture, MCP hosting, tenant isolation
- Installation & CLI Reference — Setup, configuration, full command reference
License
README fetched from the repository 5 days ago. The original is authoritative.