Codex Control Plane MCP
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| CODEX_HOME | No | Codex home directory. In central worker mode, every MCP client should use the same CODEX_HOME. | |
| CODEX_MCP_STATE_DB | No | Path to the MCP SQLite state database. In central worker mode, every MCP client should use the same CODEX_MCP_STATE_DB. | |
| CODEX_MCP_EXECUTION_MODE | No | Execution mode for the server. Default is 'inline'. Use 'client' for MCP clients that should submit and poll but not execute queued operations, and 'worker' for the long-running worker process (codex-control-plane-mcp-worker) that owns codex-app-server, leases, queue slots, and resource locks. | |
| CODEX_MCP_MAX_ACTIVE_TURNS_GLOBAL | No | Maximum number of active turns globally (default 4). | |
| CODEX_MCP_MAX_ACTIVE_TURNS_PER_AGENT | No | Maximum number of active turns per agent (default 3). | |
| CODEX_MCP_MAX_ACTIVE_TURNS_PER_THREAD | No | Maximum number of active turns per thread (default 1). | |
| CODEX_MCP_MAX_ACTIVE_TURNS_PER_PROJECT | No | Maximum number of active turns per project (default 3). | |
| CODEX_MCP_MAX_APP_SERVER_PENDING_REQUESTS | No | Maximum number of pending app-server requests (default 8). | |
| CODEX_MCP_MAX_ACTIVE_WRITE_TURNS_PER_PROJECT | No | Maximum number of active write turns per project (default 1). |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Server capabilities have not been inspected yet.
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
No tools | |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
This server cannot be deployed
Maintenance
ActivityActive
ResponsivenessNo issues