codex-mcp-bridge
by menaje
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| CODEX_MCP_BRIDGE_HOST | No | HTTP bind host; no-auth mode rejects non-loopback values | 127.0.0.1 |
| CODEX_MCP_BRIDGE_PORT | No | Direct-server port; the bundled local/secure launcher defaults to 8876 | 8765 |
| CONTROL_PLANE_API_KEY | No | Runtime API key for the Secure MCP Tunnel | |
| CODEX_MCP_BRIDGE_CODEX | No | Codex CLI executable path or command | codex |
| CODEX_MCP_BRIDGE_DEBUG | No | Emit local diagnostic errors and Codex stderr | |
| CODEX_MCP_BRIDGE_ROOTS | No | Comma-separated absolute allowed roots | current directory |
| CODEX_MCP_BRIDGE_TOKEN | No | Optional bearer token; required unless loopback-only no-auth mode is enabled | |
| CONTROL_PLANE_TUNNEL_ID | No | Tunnel ID for the Secure MCP Tunnel | |
| CODEX_MCP_BRIDGE_NO_AUTH | No | Set to 1 only for a loopback endpoint or Secure MCP Tunnel transport boundary | |
| CODEX_MCP_BRIDGE_JOB_TTL_MS | No | Completed job retention | 21600000 |
| CODEX_MCP_BRIDGE_ALLOW_WRITE | No | Must be 1 before write mode is accepted | |
| CODEX_MCP_BRIDGE_ALLOWED_HOSTS | No | Optional comma-separated HTTP Host allowlist; the launcher sets loopback hosts | |
| CODEX_MCP_BRIDGE_DEFAULT_MODEL | No | Optional default Codex model id; individual initial calls may override it | |
| CODEX_MCP_BRIDGE_FAST_RETURN_MS | No | Delay before returning a job ID | 25000 |
| CODEX_MCP_BRIDGE_JOB_STATE_FILE | No | Legacy job JSON imported once when present | ~/.codex-mcp-bridge/jobs.json |
| CODEX_MCP_BRIDGE_APPROVAL_POLICY | No | untrusted, on-request, or never | on-request |
| CODEX_MCP_BRIDGE_DEFAULT_BACKEND | No | Backend for new threads: stable mcp-server or experimental app-server; each thread remains sticky | mcp-server |
| CODEX_MCP_BRIDGE_DEFAULT_SANDBOX | No | read-only, workspace-write, or danger-full-access; the matching capability must be enabled | read-only |
| CODEX_MCP_BRIDGE_MAX_PROMPT_CHARS | No | Maximum prompt length per tool call | 50000 |
| CODEX_MCP_BRIDGE_MAX_RETAINED_JOBS | No | Maximum running/terminal job records retained in memory and durable state | 100 |
| CODEX_MCP_BRIDGE_AUTO_RESUME_TTL_MS | No | Initial saved idle window for automatic recent-session reuse; explicit continuation is still allowed | 21600000 |
| CODEX_MCP_BRIDGE_JOB_STALE_AFTER_MS | No | No-progress interval before a running job is labeled no-progress-observed; this does not establish process liveness | 600000 |
| CODEX_MCP_BRIDGE_SESSION_STATE_FILE | No | Legacy session JSON imported once when present | ~/.codex-mcp-bridge/sessions.json |
| CODEX_MCP_BRIDGE_UPSTREAM_POOL_SIZE | No | Lazy Codex MCP worker pool; cannot exceed the active-job limit | 4 |
| CODEX_MCP_BRIDGE_DISABLE_SECRET_SCAN | No | Explicitly bypass filename preflight | |
| CODEX_MCP_BRIDGE_MAX_CONCURRENT_JOBS | No | Owner maximum and initial saved active Codex-call limit | 30 |
| CODEX_MCP_BRIDGE_SETTINGS_STATE_FILE | No | Legacy settings JSON imported once when present | ~/.codex-mcp-bridge/settings.json |
| CODEX_MCP_BRIDGE_STATE_DATABASE_FILE | No | Primary private transactional settings/session/job store | ~/.codex-mcp-bridge/state.sqlite |
| CODEX_MCP_BRIDGE_DEFAULT_SESSION_MODE | No | Initial card default for omitted session mode: auto or new | auto |
| CODEX_MCP_BRIDGE_MAX_JOB_RESULT_BYTES | No | Maximum retained serialized result size per job | 1048576 |
| CODEX_MCP_BRIDGE_DEFAULT_ACCESS_STRATEGY | No | Initial card strategy: read-only, adaptive, or always-full; the last value requires full-access capability | adaptive |
| CODEX_MCP_BRIDGE_ALLOW_DANGER_FULL_ACCESS | No | Must be 1 before danger-full-access is accepted | |
| CODEX_MCP_BRIDGE_DEFAULT_REASONING_EFFORT | No | Optional default effort; must be supported by the selected model | |
| CODEX_MCP_BRIDGE_MODEL_CATALOG_STATE_FILE | No | Private last-successful model catalog fallback | ~/.codex-mcp-bridge/models.json |
| CODEX_MCP_BRIDGE_MODEL_CATALOG_TIMEOUT_MS | No | Timeout for refreshing the Codex model catalog | 30000 |
| CODEX_MCP_BRIDGE_MODEL_CATALOG_CACHE_TTL_MS | No | Time to cache a successful dynamic Codex model catalog | 600000 |
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 | |
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/menaje/codex-mcp-bridge-for-chatgpt'
If you have feedback or need assistance with the MCP directory API, please join our Discord server