cli-orchestrator-mcp

MCP Server for resilient multi-CLI orchestration — route AI tasks to Claude, Gemini, or Codex with automatic retry, circuit breaker, and fallback.

Works with any MCP-compatible client: Claude Code, Codex CLI, Gemini CLI, OpenClaw, and more.

• Role-based Routing — Automatically select the best CLI based on agent role
• Circuit Breaker — Per-provider fault isolation (closed → open → half-open)
• Retry with Backoff — Exponential backoff with jitter for transient failures
• Automatic Fallback — If primary CLI fails, try alternatives in order
• Auto-detection — Discovers installed CLIs at startup
• Cross-platform — Windows, macOS, Linux support

npx -y cli-orchestrator-mcp

Prerequisites: At least one CLI must be installed: claude, gemini, or codex.

claude mcp add cli-orchestrator --transport stdio -- npx -y cli-orchestrator-mcp

[mcp_servers.cli-orchestrator]
command = "npx"
args = ["-y", "cli-orchestrator-mcp"]

{
  "mcpServers": {
    "cli-orchestrator": {
      "command": "npx",
      "args": ["-y", "cli-orchestrator-mcp"]
    }
  }
}

mcp: {
  servers: {
    "cli-orchestrator": { command: "npx", args: ["-y", "cli-orchestrator-mcp"] }
  }
}

| Tool | Description | |------|-------------| | cli_execute | Execute a task on a CLI with full resilience (retry + circuit breaker + fallback) | | cli_status | Health dashboard with per-provider installation, circuit breaker state, and stats | | cli_route | Suggest best CLI for a task based on agent role |

| Role | Primary CLI | Strengths | Fallbacks | |------|-------------|-----------|-----------| | Manager | Gemini | research, trends, large-context | Claude → Codex | | **Coordi