CLI Reference

Global Options

Option	Description
--config, -c	Path to config file (default: config/default.yaml)
--json	Emit machine-readable JSON output
--dry-run	Show what would change without applying it
--yes	Automatically confirm destructive actions

Commands

serve

Start the aggregator hub.

mcp-director serve [OPTIONS]

Option	Description
--config, -c	Path to config file
--log-level, -l	Override log level
--quiet, -q	Do not print logs to stderr (only the banner)
--project, -p	Active project to load
--profile	Profile to use for STDIO connections
--lang	Language (en/ru)
--no-web	Do not start the integrated web interface
--no-stdio	Disable STDIO transport (run as daemon for multi-client setup)

connect

Connect to a running MCP Director server via stdio.

mcp-director connect [OPTIONS]

Option	Description
--url, -u	URL of the MCP Director server (default: http://127.0.0.1:3000)
--project, -p	Project to use
--profile	Profile to use
--token	Authentication token
--quiet, -q	Suppress status messages to stderr

Multi-Client Architecture

┌─────────────────────────────────────────────────────────────────┐
│                    mcp-director serve --no-stdio                │
│  ┌───────────────┐  ┌───────────────┐  ┌───────────────────┐   │
│  │ HTTP :3000    │  │ Router        │  │ Web UI            │   │
│  │  - /mcp       │  │ Registry      │  │ (single instance) │   │
│  │  - /sse       │  │ Backends      │  │                   │   │
│  │  - /api       │  │ Database      │  │                   │   │
│  └───────────────┘  └───────────────┘  └───────────────────┘   │
└─────────────────────────────────────────────────────────────────┘
                               ▲
                               │ HTTP POST /mcp
         ┌─────────────────────┼─────────────────────┐
         │                     │                     │
         ▼                     ▼                     ▼
┌─────────────────┐  ┌─────────────────┐  ┌─────────────────┐
│ mcp-director    │  │ mcp-director    │  │ mcp-director    │
│ connect         │  │ connect         │  │ connect         │
│ (Claude)        │  │ (Cursor)        │  │ (Other)         │
│ stdin ↔ HTTP    │  │ stdin ↔ HTTP    │  │ stdin ↔ HTTP    │
└─────────────────┘  └─────────────────┘  └─────────────────┘

server

Manage configured servers.

mcp-director server <COMMAND>

Command	Description
list	List all servers
add <name>	Add new server
remove <name>	Remove server from config
start <name>	Start a server
stop <name>	Stop a server
status <name>	Check server configuration status

project

Manage projects.

mcp-director project <COMMAND>

Command	Description
list	List all projects
set <name>	Set default project in config
add <name> --servers <s1,s2>	Create new project
remove <name>	Delete project

profile

Manage client profiles.

mcp-director profile <COMMAND>

Command	Description
list	List all profiles
add <name>	Create new profile
remove <name>	Delete profile

auth

Manage authentication settings.

mcp-director auth <COMMAND>

Command	Description
status	Check authentication status
enable	Enable authentication
disable	Disable authentication

reload

Send a reload signal to a running mcp-director serve process via API.

mcp-director reload [OPTIONS]