# Madrox

> Madrox — Multi-Agent Orchestrator for Claude & Codex. MCP server that spawns, delegates, and coordinates parallel AI agent teams via tmux.

- **Type:** MCP server
- **Install:** `agentstack add mcp-barkain-madrox`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [barkain](https://agentstack.voostack.com/s/barkain)
- **Installs:** 0
- **Category:** [Communication](https://agentstack.voostack.com/c/communication)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [barkain](https://github.com/barkain)
- **Source:** https://github.com/barkain/madrox

## Install

```sh
agentstack add mcp-barkain-madrox
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## 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:

```bash
# 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](https://github.com/tmux/tmux/wiki/Installing), [uv](https://docs.astral.sh/uv/), npm

## Quick Start (Manual)

```bash
# 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/API_REFERENCE.md](docs/API_REFERENCE.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](https://github.com/barkain)
- **Source:** [barkain/madrox](https://github.com/barkain/madrox)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-barkain-madrox
- Seller: https://agentstack.voostack.com/s/barkain
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.