{"library":"mcp-codex-worker","title":"MCP Codex Worker","description":"The `mcp-codex-worker` package provides a stdio MCP server that acts as a bridge between MCP clients and the Codex app-server runtime. It offers a set of five specialized task tools (`spawn-task`, `wait-task`, `respond-task`, `message-task`, `cancel-task`) designed for orchestrating fully autonomous AI agents. A key differentiator is its automatic approval mechanism for all Codex commands, file changes, elicitation requests, and permission requests, enabling unassisted task execution. The worker delegates all direct OpenAI API interactions to the `codex app-server` and exclusively supports `gpt-5.4` models, allowing users to specify reasoning levels like `medium` or `xhigh`. It provides comprehensive observability through file-backed reporting (including `meta.json`, `summary.log`, `verbose.log`, `events.jsonl`) and MCP resource subscriptions. The current stable version is `1.0.34`.","language":"javascript","status":"active","last_verified":"Sun Apr 19","install":{"commands":["npm install mcp-codex-worker"],"cli":{"name":"mcp-codex-worker","version":null}},"imports":[],"auth":{"required":false,"env_vars":[]},"quickstart":{"code":"{\n  \"mcpServers\": {\n    \"codex-worker\": {\n      \"command\": \"npx\",\n      \"args\": [\n        \"-y\",\n        \"mcp-codex-worker@latest\"\n      ],\n      \"env\": {\n        \"CODEX_LB_API_KEY\": \"${CODEX_LB_API_KEY}\" \n      }\n    }\n  }\n}\n\n// To launch an agent task:\n// const spawnResult = await agent.tools['spawn-task']({\n//   prompt: \"Write a NodeJS script that fetches data from an API and saves it to a file.\",\n//   reasoning: \"gpt-5.4(medium)\"\n// });\n// console.log(`Task spawned: ${spawnResult.task_id}`);\n\n// // To wait for the task to complete:\n// const waitResult = await agent.tools['wait-task']({ task_id: spawnResult.task_id });\n// console.log(`Task ${spawnResult.task_id} completed with status: ${waitResult.status}`);\n// if (waitResult.output) {\n//   console.log('Task output:', waitResult.output);\n// }","lang":"typescript","description":"Demonstrates how to install the `mcp-codex-worker` using `npx` and integrate it as an MCP server within a Claude Code environment, including how an agent would hypothetically invoke its task tools.","tag":null,"tag_description":null,"last_tested":null,"results":[]},"compatibility":null}