# Muster MCP server

> Launches Claude Code, Codex and OpenCode coding agent sessions on your machine with configurable containment and returns a reachable address.

- Repository: https://github.com/BrutalSystems/muster
- Page: https://hostedmcp.org/servers/brutalsystems/muster
- Transport: stdio
- Stars: 1
- License: MIT

## Install

### Claude Code

```sh
claude mcp add muster -- npx -y @brutalsystems/muster
```

### Cursor (`~/.cursor/mcp.json`)

```json
{
  "mcpServers": {
    "muster": {
      "command": "npx",
      "args": [
        "-y",
        "@brutalsystems/muster"
      ]
    }
  }
}
```

### VS Code (`.vscode/mcp.json`)

```json
{
  "servers": {
    "muster": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@brutalsystems/muster"
      ]
    }
  }
}
```

### VS Code CLI

```sh
code --add-mcp '{"name":"muster","type":"stdio","command":"npx","args":["-y","@brutalsystems/muster"]}'
```

### Claude Desktop (`claude_desktop_config.json`)

```json
{
  "mcpServers": {
    "muster": {
      "command": "npx",
      "args": [
        "-y",
        "@brutalsystems/muster"
      ]
    }
  }
}
```

### Codex

```sh
codex mcp add muster -- npx -y @brutalsystems/muster
```

### Codex config.toml (`~/.codex/config.toml`)

```toml
[mcp_servers.muster]
command = "npx"
args = ["-y", "@brutalsystems/muster"]
```

### Gemini CLI

```sh
gemini mcp add -s user muster npx -- -y @brutalsystems/muster
```

### Gemini settings.json (`~/.gemini/settings.json`)

```json
{
  "mcpServers": {
    "muster": {
      "command": "npx",
      "args": [
        "-y",
        "@brutalsystems/muster"
      ]
    }
  }
}
```

## Tools (2)

- `list`: List Muster-owned sessions and tasks, including host capabilities. (read-only)
- `output`: Read captured output from a task run. (read-only)

## FAQ

### Which coding agents can Muster launch?

Muster starts Claude Code, Codex and OpenCode sessions on your behalf. It is verified against Claude Code 2.1.274, Codex 0.155.1 and OpenCode 1.18.31 or newer.

### What containment levels can I give a launched agent?

There are three sealed levels: --read-only (agent asks and touches nothing on disk), --write-here (no asking, limited to its cwd) and --unrestricted (everything, requires allow_dangerous_flags).

### Does the MCP server let an agent launch sessions?

By default the MCP server is read-only with list and output. Running muster mcp install --allow-launch adds run, stop, title and open tools.

### What happens if a session never becomes reachable?

Muster only reports a session ready once its runtime is genuinely reachable, and otherwise returns a diagnosis naming what stopped it instead of a process that looks fine but isn't.

### Does the OS sandbox work on Linux?

Kernel-enforced containment uses seatbelt, so it is macOS only; elsewhere enforcement reports what was actually applied.
