# MCP Client Config Example

Recommended named modes for most chat hosts in `4.x`:

- `repro-fix`
- `inspect`
- `cold-start`
- `review-eval`

Use the host-specific examples first when they apply:

- Claude Code: [examples/claude_code_mcp.md](claude_code_mcp.md)
- Codex: [examples/codex_mcp.md](codex_mcp.md)
- OpenCode: [examples/opencode_mcp_config.json](opencode_mcp_config.json)

Preferred repair/bootstrap helpers:

- `pyro host connect codex --mode repro-fix`
- `pyro host connect codex --mode inspect`
- `pyro host connect claude-code --mode cold-start`
- `pyro host connect claude-code --mode review-eval`
- `pyro host print-config opencode --mode repro-fix`
- `pyro host doctor --mode repro-fix`
- `pyro host repair opencode --mode repro-fix`

Use this generic config only when the host expects a plain `mcpServers` JSON
shape or when the named modes are too narrow for the workflow.

`pyro-mcp` is intended to be exposed to LLM clients through the public `pyro` CLI.

Generic stdio MCP configuration using `uvx`:

```json
{
  "mcpServers": {
    "pyro": {
      "command": "uvx",
      "args": ["--from", "pyro-mcp", "pyro", "mcp", "serve", "--mode", "repro-fix"]
    }
  }
}
```

If `pyro-mcp` is already installed locally, the same server can be configured with:

```json
{
  "mcpServers": {
    "pyro": {
      "command": "pyro",
      "args": ["mcp", "serve", "--mode", "repro-fix"]
    }
  }
}
```

If the host does not preserve the server working directory and you want the
first `workspace_create` to start from a specific checkout, add
`"--project-path", "/abs/path/to/repo"` after `"serve"` in the same args list.

Mode progression:

- `repro-fix`: patch, rerun, diff, export, reset
- `inspect`: narrow offline-by-default inspection
- `cold-start`: validation plus service readiness
- `review-eval`: shell and snapshot-driven review
- generic no-mode path: the fallback when the named mode is too narrow
- `workspace-full`: explicit advanced opt-in for shells, services, snapshots, secrets, network policy, and disk tools

Primary mode for most agents:

- `repro-fix`

Use lifecycle tools only when the agent needs persistent VM state across multiple tool calls.

Other generic-client examples:

- Claude Desktop: [examples/claude_desktop_mcp_config.json](claude_desktop_mcp_config.json)
- Cursor: [examples/cursor_mcp_config.json](cursor_mcp_config.json)