Skip to main content
Glama
aether-platform

Circus MCP

by aether-platform
OverviewSchemaRelated ServersScoreDiscussions
Python
Local

Circus MCP

PyPI version Python 3.10+ License: MIT

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

—

Related MCP server: token-pilot

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

License

MIT — see LICENSE. Built on Circus.

This server cannot be installed

A
license - permissive license
-
quality - not tested
C
maintenance

How are these scores calculated?

Maintenance

–Maintainers
–Response time
–Release cycle
–Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

  • persistproc

    irskep
    A
    license
    -
    quality
    D
    maintenance
    An MCP server that lets agents and humans monitor and control long-running processes, reducing copy-pasting between AI tools and enabling multiple agents to interact with the same process outputs.
    Last updated
    8
    MIT

  • Delta-MCP

    norhther
    A
    license
    -
    quality
    A
    maintenance
    Token-efficient MCP reimplementation with progressive tool discovery, result handling, and compact wire encoding, reducing token usage by up to 89% on tool definitions.
    Last updated
    1
    MIT

View all related MCP servers

Related MCP Connectors

  • ToolAPI

    Free public MCP for AI agents — 193 tools, 44 workflows. No API key.

  • Frenchie

    OCR, transcription, file extraction, and image generation for AI agents via MCP.

  • kansei-mcp-server

    SaaS intelligence for AI agents. 5 unified tools cover 1,000+ services with 91-96% token savings.

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/aether-platform/circus-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server