Skip to content
Agentmart
Submit a tool

Codex Subagent

Delegate coding tasks to the OpenAI Codex CLI, installed separately, with explicit model and effort.

Connector by parisbs · GitHub account verified by the MCP Registry

IndexedMITLocal (stdio)
Write a review

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

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.

We use your email only for this newsletter. Privacy

About

Delegate coding tasks to the OpenAI Codex CLI, installed separately, with explicit model and effort.

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
6 read · 1 write · 2 delete
Secrets
None asked for
Install scripts
Not scanned yet
Runs as
Node.js package

Tools by what they do 9

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

Read 6 · Look things up without changing anything.

  • codex_doctor
  • codex_job_result
  • codex_job_status
  • codex_recommend
  • codex_usage
  • list_codex_models

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

  • codex_follow_up

Delete 2 · Delete, drop, revoke or wipe things.

  • codex_delegate
  • codex_job_cancel

Secrets and settings it asks for

Other settings (environment variables or headers).

  • CODEX_BIN
  • CODEX_SUBAGENT_ALLOWED_MODELS
  • CODEX_SUBAGENT_APPS
  • CODEX_SUBAGENT_DEFAULT_EFFORT
  • CODEX_SUBAGENT_DEFAULT_MODEL
  • CODEX_SUBAGENT_DEFAULT_SANDBOX
  • CODEX_SUBAGENT_MAX_BACKGROUND_JOBS
  • CODEX_SUBAGENT_MAX_DELEGATIONS_PER_HOUR
  • CODEX_SUBAGENT_MAX_EFFORT
  • CODEX_SUBAGENT_MAX_SANDBOX
  • CODEX_SUBAGENT_MCP_SERVERS
  • CODEX_SUBAGENT_PLUGINS
Show 1 more settings
  • CODEX_SUBAGENT_USAGE_LOG

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 (6 days ago)
Last release
Oct 21, 2026 (8 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
Cite this page

Codex Subagent MCP server. Agent Mart. https://agentmart.dev/connectors/parisbs-codex-subagent-mcp (last updated 2026-10-24)