Skip to content
codexclawcodexclaw

MCP Tools

codexclaw exposes one MCP server, codexclaw-subagent-config, for reading and writing subagent role configuration. It is declared through the plugin manifest’s mcpServers entry.

Tools

Section titled “Tools”

subagents_get

Section titled “subagents_get”

Read the per-role subagent config (explorer / reviewer / executor): mode, model, promptOverride.

// input
{}

subagents_set

Section titled “subagents_set”

Update one role’s subagent config.

// input
{
  "role": "explorer | reviewer | executor",   // required
  "mode": "default | model",                    // "model" requires a model id
  "model": "<model id> | null",
  "promptOverride": "<string> | null"
}

catalog_list

Section titled “catalog_list”

List selectable models: Codex-native entries first, then ocx-backed entries when ocx is active.

// input
{}

Storage

Section titled “Storage”

subagents_get and subagents_set read and write .codexclaw/subagents.json. catalog_list reads the Codex model cache and returns native entries first, then ocx-backed entries when present. There is no network service; the MCP server is a local stdio process started by Codex.

Section titled “Related”