Codex Control Plane MCP

Durable MCP control plane for long-running Codex Desktop tasks.

Connector by aresyn · GitHub account verified by the MCP Registry

IndexedApache-2.0Local (stdio)★ 124

Chalk Labs

Need help deploying Codex Control Plane MCP?

Chalk Labs sets up agents like this inside real teams: connected to your tools, tested on your data, with a human in the loop where it matters.

Book a call

Install

Works with Claude Code, Codex, VS Code, Cursor, Windsurf, Claude Desktop. Read the repository before you give any tool access to your data.

npx agentmarket install connector/aresyn-codex-control-plane-mcp

Asks which of your tools to add it to (Claude Code, Codex, Cursor, VS Code, Windsurf, Gemini CLI, Claude Desktop) and shows the change first. See https://agentmart.dev/cli.

Get the weekly diff

The weekly diff: one email a week with new agent tools, notable updates and grade changes, plus security alerts for tools you follow. Double opt-in, one-click unsubscribe.

About

Durable MCP control plane for long-running Codex Desktop tasks.

Use cases: agent-orchestration, debugging

Reviews

Write a review

No reviews yet. Installed it? Reviews come from verified installers only. How reviews work

Permissions

What this server can do and what it asks for, from its tool list and install config. Checked Oct 25, 2026.

Tools: 23 read · 12 write · 0 delete · 3 not yet classified
Secrets: None asked for
Install scripts: Not scanned yet
Runs as: Python package

Tools by what they do 38

Read from the source code; the running server may list different tools.

Read 23 · Look things up without changing anything.

codex_adopt_workflow_plan
codex_analyze_issue
codex_answer_pending_interaction
codex_get_agent_contract
codex_get_app_server_status
codex_get_chat
codex_get_chat_status
codex_get_concurrency_status
codex_get_diagnostic_logs
codex_get_operation_status
codex_get_queue_status
codex_get_runtime_capabilities

Show 11 more tools

codex_get_thread_compaction_status
codex_get_turn_status
codex_get_worker_command_status
codex_get_worker_status
codex_get_workflow_status
codex_health_summary
codex_list_active_chats
codex_list_pending_interactions
codex_list_project_chats
codex_list_projects
codex_search_chats

Write 12 · Create, change, send or run things.

codex_approve_plan
codex_archive_thread
codex_execute_plan
codex_preflight_project_run
codex_repair_issue
codex_restart_app_server
codex_send_message
codex_start_chat
codex_start_plan_workflow
codex_start_review_workflow
codex_start_thread_compaction
codex_submit_task

Not yet classified 3 · We could not tell from the name and description.

codex_collect_diagnostics
codex_interrupt_turn
codex_unarchive_thread

Files it touches

Any path the agent passes to its tools

Tools (38)

Read from the source code; the running server may differ. Descriptions are the server’s own words; hidden characters are shown as [U+…].

codex_adopt_workflow_plan
Adopt a newer valid Plan Mode candidate from the same Codex thread into an existing durable workflow. This is idempotent by workflow and plan hash and never starts execution by itself.
codex_analyze_issue
Analyze MCP/Codex diagnostics and logs to classify likely root cause and recommend safe repair actions.
codex_answer_pending_interaction
Answer a pending Codex app-server approval/input/elicitation request so the active turn can continue.
codex_approve_plan
Approve the latest completed Plan Mode plan for a durable workflow and queue the execution turn. Repeated calls are idempotent and do not create duplicate execution turns.
codex_archive_thread
Archive a known Codex thread through codex-app-server thread/archive. Refuses to run while the thread has active work.
codex_collect_diagnostics
Collect a read-only MCP/Codex diagnostic snapshot: paths, app-server state, active work, pending interactions, workflows, logs/events pointers, and health checks.
codex_execute_plan
Compatibility layer low-level workflow write tool: submit the latest approved Plan Mode plan for implementation by sending 'Implement the plan.' in default collaboration mode. For durable long-running tasks and client-timeout resilience, prefer codex_submit_task(operation_type='execute_plan').
codex_get_agent_contract
Read the machine-readable agent guide for this MCP server. Use this when tools/list metadata was unavailable or when a client wants full flow examples. It is passive and never starts app-server or writes durable state.
codex_get_app_server_status
Get status of the MCP-owned Codex app-server subprocess without starting it.
codex_get_chat
Get Codex chat content from MCP hook history, Codex transcripts, or legacy KB history fallback. The history before the latest user/orchestrator message is summarized with DeepSeek, and only the latest user/orchestrator message plus following raw Codex/tool/event messages are returned.
codex_get_chat_status
Get lightweight Codex chat status and short previews without DeepSeek and without full transcript content.
codex_get_concurrency_status
Read active turn counts and resource locks used by the central MCP worker scheduler.
codex_get_diagnostic_logs
Read redacted MCP diagnostic log lines and MCP-owned app-server event audit entries with thread/turn/workflow filters.
codex_get_operation_status
Poll a durable Codex operation created by codex_submit_task. Returns current operation phase, thread/turn ids, latest messages, pending interactions, and recommended next action.
codex_get_queue_status
Read durable operation queue state, queued reasons, and assigned worker ids.

Show 23 more tools

codex_get_runtime_capabilities
Read a compact cached inventory of local codex-app-server runtime capabilities: models, permission profiles, sandbox readiness, hooks, skills, provider features, redacted account status, and supported schema methods.
codex_get_thread_compaction_status
Poll a thread compaction action created by codex_start_thread_compaction.
codex_get_turn_status
Get tracked Codex turn status and the latest assistant messages. Uses live app-server tracking with MCP hook history and legacy KB history fallback.
codex_get_worker_command_status
Poll a control command delegated to the central MCP worker from client mode.
codex_get_worker_status
Read central MCP worker heartbeats and execution mode state without starting codex-app-server.
codex_get_workflow_status
Poll a durable long-running orchestrator -> Codex workflow. Aggregates plan turn, execution turn, latest plan, pending interactions, and recommended next action.
codex_health_summary
Get a compact read-only MCP/Codex health summary for orchestrators without starting app-server or returning large logs.
codex_interrupt_turn
Interrupt a running Codex turn through the MCP-owned Codex app-server subprocess. Accepts direct thread/turn ids or durable operation/workflow context.
codex_list_active_chats
List chats that appear active from live/cache/transcript evidence.
codex_list_pending_interactions
List pending Codex app-server approval/input/elicitation requests waiting for the orchestrator.
codex_list_project_chats
List Codex chats for a project with UI-like titles where available.
codex_list_projects
List known Codex projects from the project registry, MCP hook history, transcript index, and read-only Codex state. Each result's projectId is the canonical value to pass as project_id to codex_submit_task, workflow, preflight, and chat tools.
codex_preflight_project_run
Run read-only preflight checks before a long Codex workflow. Optionally starts a tiny live probe when live_probe=true.
codex_repair_issue
Run an allowlisted MCP/Codex repair action with before/after audit. Unsafe actions require force=true.
codex_restart_app_server
Restart only the MCP-owned Codex app-server subprocess. This does not restart Codex Desktop and refuses to run while the MCP app-server has active turns, captures, or pending requests.
codex_search_chats
Search Codex chats across projects by keywords, multiple terms, or exact phrases using the MCP-owned FTS index over hook history, transcripts, and legacy KB history. Returns ranked chat matches, not full transcripts, and never calls DeepSeek.
codex_send_message
Compatibility layer low-level write tool: send a new user message into an existing Codex persisted chat via app-server thread/resume + turn/start. Returns after turn/start is accepted; poll codex_get_turn_status for messages and completion. For durable long-running tasks and client-timeout resilience, prefer codex_submit_task(operation_type='send_message').
codex_start_chat
Compatibility layer low-level write tool: start a new Codex chat in a known project via app-server thread/start + turn/start. Returns after turn/start is accepted; poll codex_get_turn_status for messages and completion. For durable long-running tasks and client-timeout resilience, prefer codex_submit_task(operation_type='start_chat').
codex_start_plan_workflow
Start a durable long-running orchestrator -> Codex workflow by launching a new Codex chat in real Plan Mode. Returns workflowId, threadId, and planTurnId for polling.
codex_start_review_workflow
Start a durable Codex code review workflow through app-server review/start. Returns a fast workflow ack; poll codex_get_workflow_status for review progress and final report.
codex_start_thread_compaction
Start Codex context compaction for a known thread through codex-app-server thread/compact/start. Poll codex_get_thread_compaction_status with the returned actionId.
codex_submit_task
Durably queue a Codex write operation and return immediately with operationId. For new work, pass project_id from codex_list_projects.projectId; project name or project path are accepted as aliases and MCP stores the canonical projectId. Use codex_get_operation_status to poll threadId, turnId, messages, pending interactions, and completion.
codex_unarchive_thread
Unarchive a known Codex thread through codex-app-server thread/unarchive. Refuses to run while the thread has active work.

Signals

Stars: 124
Forks: 5
Open issues: 8
Weekly downloads: 95
Last commit: Sep 9, 2026 (1 month ago)
Last release: Jun 21, 2026 (4 months ago)
Last package publish: Jun 21, 2026 (4 months ago)

From GitHub (fetched Oct 24, 2026) and the package registry.

Details

Registry name: io.github.aresyn/codex-control-plane-mcp
Version: 0.2.1
Auth: No auth
Packages: pypi codex-control-plane-mcp
License: Apache-2.0
Repository: github.com/aresyn/codex-control-plane-mcp
Website: github.com/aresyn/codex-control-plane-mcp
First seen: Oct 24, 2026
Last checked: Oct 25, 2026
Source: Official MCP Registry github-graphql

Done for you

Rather not set it up yourself?

Chalk Labs scopes, builds and runs agents for your team: the task audit, the eval harness, the integrations and the weekly ops report. Fixed scope, priced before we start.

See how we build AI agents →Read the case studies

Chalk Labs is a two-founder AI and growth studio. We build AI agents, CRMs and MVPs for Web3 and AI companies, and have shipped 50+ product and token launches.

launches shipped: 50+; launches shipped
media placements: 500+; media placements
founders on every account: 2; founders on every account

Press we've placed: Forbes · CoinDesk · Decrypt · Cointelegraph · The Block

Rahil Jain, Co-founder, Chalk Labs. Ex-Goldman Sachs engineer. You talk to the person who builds it.

Get Codex Control Plane MCP running in your business

Tell us what you want to automate. A founder replies within one working day with a plan, not a pitch deck.

Need help deploying Codex Control Plane MCP?

Call Get help

Cite this page

Codex Control Plane MCP. Agent Mart. https://agentmart.dev/connectors/aresyn-codex-control-plane-mcp (last updated 2026-10-25)