Codex Subagent

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/parisbs-codex-subagent-mcp

About

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

6 read · 1 write · 2 delete

Secrets

None asked for

Install scripts

Not scanned yet

Runs as

Node.js package

Tools (9)

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

• codex_delegateDelegate a task to Codex

  Description is built at runtime.

• codex_doctorCheck the Codex CLI installationread-only

  Check whether the local Codex CLI is installed, recent enough, signed in and able to load its configuration, and report the exact steps to fix it if not. Run this when any other tool reports the CLI is unavailable, or before relying on delegation for the first time. It only inspects the installation; it never installs or repairs anything. Opt in with extended for a slow, networked config.load report from codex doctor --json.

• codex_follow_upContinue a Codex session

  Send a follow-up message to a previous delegation using its thread_id. Codex retains the earlier context, so only the new instruction needs to be sent. Like a delegation, it is sent to OpenAI and spends the user's Codex usage.

• codex_job_cancelCancel a background delegationcan change or delete data

  Terminate a running background delegation.

• codex_job_resultRead a background delegation's resultread-only

  Return the full output of a finished background delegation. Errors if the job is still running.

• codex_job_statusCheck a background delegationread-only

  Report the state and recent activity of a background delegation started with mode=background. Call it with no job_id to list every known job.

• codex_recommendRecommend a Codex model and effortread-only

  Given a task description, recommend which Codex model and reasoning effort to delegate it with. Runs no model call; applies a documented matrix reconciled against the installed catalog.

• codex_usageSummarise the local usage logread-only

  Summarise this server's local usage log (CODEX_SUBAGENT_USAGE_LOG) over a window: per group, the number of delegation processes, their outcomes, commands, durations and the tokens the Codex CLI reported. Reads local files only and runs no Codex process. It never reports quota, credits or remaining allowance.

• list_codex_modelsList Codex modelsread-only

  List the Codex models available on this machine, with the reasoning-effort levels each one supports. Read from the installed Codex CLI, with a warned static fallback if its catalog cannot be read. Call this before codex_delegate when choosing a model explicitly.

Signals

Stars

0

Forks

0

Open issues

15

Last commit

Oct 22, 2026 (8 days ago)

Last release

Oct 21, 2026 (10 days ago)

From GitHub (fetched Oct 24, 2026).

Details

Registry name

io.github.parisbs/codex-subagent-mcp

Version

0.6.0

Auth

No auth

Packages

npm codex-subagent-mcp

License

MIT

Repository

github.com/parisbs/codex-subagent-mcp

Website

github.com/parisbs/codex-subagent-mcp#readme

First seen

Oct 24, 2026

Last checked

Oct 24, 2026

Source

Official MCP Registrygithub-graphql