Install
$ agentstack add mcp-barkain-madrox ✓ scanned · ✓ verified, works with Claude Code, Cursor, and more.
Security review
✓ PassedNo issues found. Passed automated security review. · v0.1.0 How review works →
- ✓ Prompt-injection patterns
- ✓ Secret / credential exfiltration
- ✓ Dangerous shell & filesystem operations
- ✓ Untrusted network calls
- ✓ Known-malicious package signatures
What it can access
- ✓ Network access No
- ✓ Filesystem access No
- ✓ Shell / process execution No
- ✓ Environment & secrets No
- ✓ Dynamic code execution No
From automated source analysis of v0.1.0. “Used” means the capability is present in the source — more access means more to trust, not that it’s unsafe.
Verified badge
Passed review? Show it. Paste this badge into your README, it links to the public security report.
Reliability & compatibility
Declared compatibility
Compatibility is declared by the source manifest. End-to-end runtime verification is coming, see below.
We're building live execution health for every listing: tool-call success rate, median latency, uptime, and last-checked timestamps, measured, not self-reported. It isn't live yet, so we don't show numbers we can't stand behind.
How agent discovery & health will work →About
Madrox - Multi-Agent Orchestrator for Claude, Codex & Grok
[](https://www.python.org/downloads/) [](https://opensource.org/licenses/MIT) [](https://github.com/barkain/madrox/actions/workflows/test.yml) [](https://github.com/astral-sh/ruff)
An MCP server that lets AI instances spawn and manage hierarchical networks of Claude, Codex and Grok agents. Build recursive multi-level teams with bidirectional communication, role specialization, task interruption, and real-time monitoring — all orchestrated through tmux sessions.
Why Madrox?
| Capability | Claude Subagent | Madrox | |------------|----------------|--------| | Hierarchy depth | 2 levels (flat) | 3+ levels (recursive) | | Models | Claude only | Claude + Codex + Grok, any model id | | Interruption | Must terminate & restart | Stop & redirect, keep context | | Visibility | Black box | Full tree view, metrics, dashboard | | Parallel ops | Sequential only | Batch spawn/message/interrupt | | Communication | One-way (parent → child) | Bidirectional + peer-to-peer | | Workspace | Shared | Isolated per-instance | | Resource tracking | None | Tokens, cost limits, auto-cleanup |
Plugin Installation (Recommended)
The fastest way to get started — install Madrox as a Claude Code plugin:
# Install from local clone
/plugin install /path/to/madrox
After installing, restart your Claude Code session. All Madrox MCP tools become available automatically. The plugin starts the HTTP backend (port 8001) and the monitor dashboard (port 3002) in the background.
Use the /madrox:dashboard skill to open the real-time monitor dashboard in your browser.
Prerequisites: Python 3.11+, tmux, uv, npm
Quick Start (Manual)
# 1. Install
git clone https://github.com/barkain/madrox.git && cd madrox
uv sync && source .venv/bin/activate
# 2. Start (backend + dashboard)
./start.sh
# 3. Register with Claude Code
claude mcp add madrox http://localhost:8001/mcp --transport http
Then ask Claude Code to spawn a madrox dev team from template — or see [examples/](examples/) for scripted usage.
Documentation
| Topic | Link | |-------|------| | Installation & setup | [docs/SETUP.md](docs/SETUP.md) | | Architecture & design | [docs/ARCHITECTURE.md](docs/ARCHITECTURE.md) | | API reference (24+ MCP tools) | [docs/APIREFERENCE.md](docs/APIREFERENCE.md) | | Features & usage patterns | [docs/FEATURES.md](docs/FEATURES.md) | | Troubleshooting | [docs/TROUBLESHOOTING.md](docs/TROUBLESHOOTING.md) | | Team templates | [docs/TEMPLATES.md](docs/TEMPLATES.md) | | Examples | [examples/](examples/) |
Contributing
See [CONTRIBUTING.md](CONTRIBUTING.md). Run uv run pytest tests/ -v and uv run ruff check src/ before submitting.
License
MIT — see [LICENSE](LICENSE).
Source & license
This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.
- Author: barkain
- Source: barkain/madrox
- License: MIT
Install and usage instructions live in the source repository linked above.
Reviews
No reviews yet, be the first.
Write a review
Versions
- v0.1.0 Imported from the upstream source.