Use Codex from Claude Code, or Claude Code from Codex, through the subscriptions you already have. Multi-turn consultations between agent CLIs with no provider API key, a validated response envelope, and a local dashboard of every consultation.
Setup
Choose your client, copy the config, then fill in any required environment variables.
claude mcp add orchestrator --env ORCHESTRATOR_HOST_RUNTIME='<ORCHESTRATOR_HOST_RUNTIME>' --env ORCHESTRATOR_CONFIG='<ORCHESTRATOR_CONFIG>' -- uvx orchestrator-mcp-server~/.codex/config.toml
[mcp_servers.orchestrator]
command = "uvx"
args = ["orchestrator-mcp-server"]
env = { ORCHESTRATOR_HOST_RUNTIME = "<ORCHESTRATOR_HOST_RUNTIME>", ORCHESTRATOR_CONFIG = "<ORCHESTRATOR_CONFIG>" }
# codex mcp add orchestrator --env ORCHESTRATOR_HOST_RUNTIME='<ORCHESTRATOR_HOST_RUNTIME>' --env ORCHESTRATOR_CONFIG='<ORCHESTRATOR_CONFIG>' -- uvx orchestrator-mcp-server~/.cursor/mcp.json
{
"mcpServers": {
"orchestrator": {
"command": "uvx",
"args": [
"orchestrator-mcp-server"
],
"env": {
"ORCHESTRATOR_HOST_RUNTIME": "<ORCHESTRATOR_HOST_RUNTIME>",
"ORCHESTRATOR_CONFIG": "<ORCHESTRATOR_CONFIG>"
}
}
}
}.vscode/mcp.json
{
"servers": {
"orchestrator": {
"type": "stdio",
"command": "uvx",
"args": [
"orchestrator-mcp-server"
],
"env": {
"ORCHESTRATOR_HOST_RUNTIME": "<ORCHESTRATOR_HOST_RUNTIME>",
"ORCHESTRATOR_CONFIG": "<ORCHESTRATOR_CONFIG>"
}
}
}
}~/.gemini/settings.json
{
"mcpServers": {
"orchestrator": {
"command": "uvx",
"args": [
"orchestrator-mcp-server"
],
"env": {
"ORCHESTRATOR_HOST_RUNTIME": "<ORCHESTRATOR_HOST_RUNTIME>",
"ORCHESTRATOR_CONFIG": "<ORCHESTRATOR_CONFIG>"
}
}
}
}claude_desktop_config.json
{
"mcpServers": {
"orchestrator": {
"command": "uvx",
"args": [
"orchestrator-mcp-server"
],
"env": {
"ORCHESTRATOR_HOST_RUNTIME": "<ORCHESTRATOR_HOST_RUNTIME>",
"ORCHESTRATOR_CONFIG": "<ORCHESTRATOR_CONFIG>"
}
}
}
}.trae/mcp.json
{
"mcpServers": {
"orchestrator": {
"command": "uvx",
"args": [
"orchestrator-mcp-server"
],
"env": {
"ORCHESTRATOR_HOST_RUNTIME": "<ORCHESTRATOR_HOST_RUNTIME>",
"ORCHESTRATOR_CONFIG": "<ORCHESTRATOR_CONFIG>"
}
}
}
}Environment variables
ORCHESTRATOR_HOST_RUNTIMEORCHESTRATOR_CONFIG
Replace the placeholders with your own credentials and keep them out of version control.