# Orchestrator MCP Server
Model Context Protocol (MCP) server for Claude Code Orchestrator Plugin.
## Features
- **ALWAYS ON**: Auto-activates like Serena MCP
- **Multi-Agent Orchestration**: Coordinate up to 64 parallel agents
- **Intelligent Routing**: Automatic expert agent selection
- **Cost Prediction**: ML-based cost estimation
- **Hierarchical Execution**: 3-level parallel task execution
## Installation
The MCP server is automatically installed via Claude Code's MCP system.
### Manual Installation
```bash
pip install orchestrator-mcp-server
```
Or via uvx (recommended):
```bash
uvx --from git+https://github.com/LeoDg/orchestrator-mcp-server orchestrator-mcp
```
## MCP Tools
### `orchestrator_analyze`
Analyze a request and generate execution plan without executing.
**Parameters:**
- `request` (string, required): The user request to analyze
- `show_table` (boolean, optional): Show execution plan table (default: true)
### `orchestrator_execute`
Execute orchestration plan (generates plan for Task tool execution).
**Parameters:**
- `request` (string, required): The user request to orchestrate
- `parallel` (number, optional): Max parallel agents 1-64 (default: 6)
- `model` (string, optional): Force specific model (auto/haiku/sonnet/opus)
### `orchestrator_status`
Get status of an orchestration session.
**Parameters:**
- `session_id` (string, optional): Session ID to check (empty for latest)
### `orchestrator_agents`
List all available expert agents.
**Parameters:**
- `filter` (string, optional): Filter by domain or keyword
### `orchestrator_list`
List recent orchestration sessions.
**Parameters:**
- `limit` (number, optional): Max sessions to return (default: 10)
### `orchestrator_preview`
Preview orchestration with detailed task breakdown.
**Parameters:**
- `request` (string, required): Request to preview
### `orchestrator_cancel`
Cancel an active orchestration session.
**Parameters:**
- `session_id` (string, required): Session ID to cancel
## MCP Resources
- `orchestrator://sessions` - All orchestration sessions
- `orchestrator://agents` - Available expert agents
- `orchestrator://config` - Server configuration
## Architecture
```
┌─────────────────────────────────────────────────────────┐
│ Claude Code │
│ ┌───────────────────────────────────────────────────┐ │
│ │ Orchestrator MCP Server │ │
│ │ │ │
│ │ ┌─────────────┐ ┌─────────────┐ ┌───────────┐ │ │
│ │ │ Analyzer │ │ Router │ │ Executor │ │ │
│ │ └─────────────┘ └─────────────┘ └───────────┘ │ │
│ │ │ │
│ │ ┌─────────────────────────────────────────────┐ │ │
│ │ │ Expert Agents Registry │ │ │
│ │ │ GUI | DB | Security | API | MQL | ... │ │ │
│ │ └─────────────────────────────────────────────┘ │ │
│ └───────────────────────────────────────────────────┘ │
└─────────────────────────────────────────────────────────┘
```
## License
MIT License - See LICENSE file for details.
