Codex MCP Server 1.2.5 MCP tools and protocol inventory

Tools 8

Tool	Category	Annotations	Risk
ask-codexExecute Codex CLI with file analysis (@syntax), model selection, and safety controls. Supports changeMode. Input schema { "type": "object", "properties": { "prompt": { "type": "string", "minLength": 1, "description": "Task or question. Use @ to include files (e.g., '@largefile.ts explain')." }, "model": { "type": "string", "description": "Model: gpt-5-codex, gpt-5, o3, o4-mini, codex-1, codex-mini-latest, gpt-4.1. Default: gpt-5-codex" }, "sandbox": { "type": "boolean", "default": false, "description": "Quick automation mode: enables workspace-write + on-failure approval. Alias for fullAuto." }, "fullAuto": { "type": "boolean", "description": "Full automation mode" }, "approvalPolicy": { "type": "string", "enum": [ "never", "on-request", "on-failure", "untrusted" ], "description": "Approval: never, on-request, on-failure, untrusted" }, "approval": { "type": "string", "description": "Approval policy: untrusted, on-failure, on-request, never" }, "sandboxMode": { "type": "string", "enum": [ "read-only", "workspace-write", "danger-full-access" ], "description": "Access: read-only, workspace-write, danger-full-access" }, "yolo": { "type": "boolean", "description": "⚠️ Bypass all safety (dangerous)" }, "cd": { "type": "string", "description": "Working directory" }, "workingDir": { "type": "string", "description": "Working directory for execution" }, "changeMode": { "type": "boolean", "default": false, "description": "Return structured OLD/NEW edits for refactoring" }, "chunkIndex": { "type": "number", "minimum": 1, "description": "Chunk index (1-based)" }, "chunkCacheKey": { "type": "string", "description": "Cache key for continuation" }, "image": { "anyOf": [ { "type": "string" }, { "type": "array", "items": { "type": "string" } } ], "description": "Optional image file path(s) to include with the prompt" }, "config": { "anyOf": [ { "type": "string" }, { "type": "object", "additionalProperties": {} } ], "description": "Configuration overrides as 'key=value' string or object" }, "profile": { "type": "string", "description": "Configuration profile to use from ~/.codex/config.toml" }, "timeout": { "type": "number", "description": "Maximum execution time in milliseconds (optional)" }, "includeThinking": { "type": "boolean", "default": true, "description": "Include reasoning/thinking section in response" }, "includeMetadata": { "type": "boolean", "default": true, "description": "Include configuration metadata in response" }, "search": { "type": "boolean", "description": "Enable web search by activating web_search_request feature flag. Requires network access - automatically sets sandbox to workspace-write if not specified." }, "oss": { "type": "boolean", "description": "Use local Ollama server (convenience for -c model_provider=oss). Requires Ollama running locally. Automatically sets sandbox to workspace-write if not specified." }, "enableFeatures": { "type": "array", "items": { "type": "string" }, "description": "Enable feature flags (repeatable). Equivalent to -c features.<name>=true" }, "disableFeatures": { "type": "array", "items": { "type": "string" }, "description": "Disable feature flags (repeatable). Equivalent to -c features.<name>=false" } }, "required": [ "prompt" ] }	—	— · —	—
batch-codexDelegate multiple atomic tasks to Codex for batch processing. Ideal for repetitive operations, mass refactoring, and automated code transformations Input schema { "type": "object", "properties": { "tasks": { "type": "array", "items": { "type": "object", "properties": { "task": { "type": "string", "description": "Atomic task description" }, "target": { "type": "string", "description": "Target files/directories (use @ syntax)" }, "priority": { "type": "string", "enum": [ "high", "normal", "low" ], "default": "normal", "description": "Task priority" } }, "required": [ "task" ], "additionalProperties": false }, "minItems": 1, "description": "Array of atomic tasks to delegate to Codex" }, "model": { "type": "string", "description": "Model to use: gpt-5-codex, gpt-5, o3, o4-mini, codex-1, codex-mini-latest, gpt-4.1" }, "sandbox": { "type": "string", "default": "workspace-write", "description": "Sandbox mode: read-only, workspace-write, danger-full-access" }, "parallel": { "type": "boolean", "default": false, "description": "Execute tasks in parallel (experimental)" }, "stopOnError": { "type": "boolean", "default": true, "description": "Stop execution if any task fails" }, "timeout": { "type": "number", "description": "Maximum execution time per task in milliseconds" }, "workingDir": { "type": "string", "description": "Working directory for execution" }, "search": { "type": "boolean", "description": "Enable web search for all tasks (activates web_search_request feature)" }, "oss": { "type": "boolean", "description": "Use local Ollama server" }, "enableFeatures": { "type": "array", "items": { "type": "string" }, "description": "Enable feature flags" }, "disableFeatures": { "type": "array", "items": { "type": "string" }, "description": "Disable feature flags" } }, "required": [ "tasks" ] }	—	— · —	—
brainstormGenerate creative ideas using structured frameworks with domain context and feasibility analysis. Input schema { "type": "object", "properties": { "prompt": { "type": "string", "minLength": 1, "description": "Brainstorming challenge or question" }, "model": { "type": "string", "description": "Model: gpt-5-codex (default), gpt-5, o3, o4-mini, codex-1, codex-mini-latest, gpt-4.1" }, "approvalPolicy": { "type": "string", "enum": [ "never", "on-request", "on-failure", "untrusted" ], "description": "Approval: never, on-request, on-failure, untrusted" }, "sandboxMode": { "type": "string", "enum": [ "read-only", "workspace-write", "danger-full-access" ], "description": "Access: read-only, workspace-write, danger-full-access" }, "fullAuto": { "type": "boolean", "description": "Full automation mode" }, "yolo": { "type": "boolean", "description": "⚠️ Bypass all safety (dangerous)" }, "cd": { "type": "string", "description": "Working directory" }, "methodology": { "type": "string", "enum": [ "divergent", "convergent", "scamper", "design-thinking", "lateral", "auto" ], "default": "auto", "description": "Framework: divergent, convergent, scamper, design-thinking, lateral, auto (default)" }, "domain": { "type": "string", "description": "Domain: software, business, creative, research, product, marketing, etc." }, "constraints": { "type": "string", "description": "Limitations: budget, time, technical, legal, etc." }, "existingContext": { "type": "string", "description": "Background info or previous attempts" }, "ideaCount": { "type": "integer", "exclusiveMinimum": 0, "default": 12, "description": "Number of ideas (default: 12, range: 5-30)" }, "includeAnalysis": { "type": "boolean", "default": true, "description": "Include feasibility/impact analysis" }, "search": { "type": "boolean", "description": "Enable web search for research (activates web_search_request feature)" }, "oss": { "type": "boolean", "description": "Use local Ollama server" }, "enableFeatures": { "type": "array", "items": { "type": "string" }, "description": "Enable feature flags" }, "disableFeatures": { "type": "array", "items": { "type": "string" }, "description": "Disable feature flags" } }, "required": [ "prompt" ] }	—	— · —	—
fetch-chunkRetrieves cached chunks from a changeMode response. Use this to get subsequent chunks after receiving a partial changeMode response. Input schema { "type": "object", "properties": { "cacheKey": { "type": "string", "description": "The cache key provided in the initial changeMode response" }, "chunkIndex": { "type": "number", "minimum": 1, "description": "Which chunk to retrieve (1-based index)" } }, "required": [ "cacheKey", "chunkIndex" ] }	—	— · —	—
Helpreceive help information Input schema { "type": "object", "properties": {}, "required": [] }	—	— · —	—
pingEcho Input schema { "type": "object", "properties": { "prompt": { "type": "string", "default": "", "description": "Message to echo " } }, "required": [] }	—	— · —	—
timeout-testTest timeout prevention by running for a specified duration Input schema { "type": "object", "properties": { "duration": { "type": "number", "minimum": 10, "description": "Duration in milliseconds (minimum 10ms)" } }, "required": [ "duration" ] }	—	— · —	—
versionDisplay version and system information Input schema { "type": "object", "properties": {}, "required": [] }	—	— · —	—

Prompts 8

ask-codex

Execute Codex CLI with optional changeMode

Metadata

{
  "prompt_key": "ask-codex",
  "name": "ask-codex",
  "description": "Execute Codex CLI with optional changeMode",
  "arguments": [
    {
      "name": "prompt",
      "description": "Task or question. Use @ to include files (e.g., '@largefile.ts explain').",
      "required": true
    },
    {
      "name": "model",
      "description": "Model: gpt-5-codex, gpt-5, o3, o4-mini, codex-1, codex-mini-latest, gpt-4.1. Default: gpt-5-codex",
      "required": false
    },
    {
      "name": "sandbox",
      "description": "Quick automation mode: enables workspace-write + on-failure approval. Alias for fullAuto.",
      "required": false
    },
    {
      "name": "fullAuto",
      "description": "Full automation mode",
      "required": false
    },
    {
      "name": "approvalPolicy",
      "description": "Approval: never, on-request, on-failure, untrusted",
      "required": false
    },
    {
      "name": "approval",
      "description": "Approval policy: untrusted, on-failure, on-request, never",
      "required": false
    },
    {
      "name": "sandboxMode",
      "description": "Access: read-only, workspace-write, danger-full-access",
      "required": false
    },
    {
      "name": "yolo",
      "description": "⚠️ Bypass all safety (dangerous)",
      "required": false
    },
    {
      "name": "cd",
      "description": "Working directory",
      "required": false
    },
    {
      "name": "workingDir",
      "description": "Working directory for execution",
      "required": false
    },
    {
      "name": "changeMode",
      "description": "Return structured OLD/NEW edits for refactoring",
      "required": false
    },
    {
      "name": "chunkIndex",
      "description": "Chunk index (1-based)",
      "required": false
    },
    {
      "name": "chunkCacheKey",
      "description": "Cache key for continuation",
      "required": false
    },
    {
      "name": "image",
      "description": "Optional image file path(s) to include with the prompt",
      "required": false
    },
    {
      "name": "config",
      "description": "Configuration overrides as 'key=value' string or object",
      "required": false
    },
    {
      "name": "profile",
      "description": "Configuration profile to use from ~/.codex/config.toml",
      "required": false
    },
    {
      "name": "timeout",
      "description": "Maximum execution time in milliseconds (optional)",
      "required": false
    },
    {
      "name": "includeThinking",
      "description": "Include reasoning/thinking section in response",
      "required": false
    },
    {
      "name": "includeMetadata",
      "description": "Include configuration metadata in response",
      "required": false
    },
    {
      "name": "search",
      "description": "Enable web search by activating web_search_request feature flag. Requires network access - automatically sets sandbox to workspace-write if not specified.",
      "required": false
    },
    {
      "name": "oss",
      "description": "Use local Ollama server (convenience for -c model_provider=oss). Requires Ollama running locally. Automatically sets sandbox to workspace-write if not specified.",
      "required": false
    },
    {
      "name": "enableFeatures",
      "description": "Enable feature flags (repeatable). Equivalent to -c features.<name>=true",
      "required": false
    },
    {
      "name": "disableFeatures",
      "description": "Disable feature flags (repeatable). Equivalent to -c features.<name>=false",
      "required": false
    }
  ],
  "metadata_hash": "21a6f0d3fb696393ed8ef9c38a2bbeb819e772bd01c8d1643045261b5fec91b4"
}

batch-codex

Execute multiple atomic Codex tasks in batch mode for efficient automation

Metadata

{
  "prompt_key": "batch-codex",
  "name": "batch-codex",
  "description": "Execute multiple atomic Codex tasks in batch mode for efficient automation",
  "arguments": [
    {
      "name": "tasks",
      "description": "Array of atomic tasks to delegate to Codex",
      "required": true
    },
    {
      "name": "model",
      "description": "Model to use: gpt-5-codex, gpt-5, o3, o4-mini, codex-1, codex-mini-latest, gpt-4.1",
      "required": false
    },
    {
      "name": "sandbox",
      "description": "Sandbox mode: read-only, workspace-write, danger-full-access",
      "required": false
    },
    {
      "name": "parallel",
      "description": "Execute tasks in parallel (experimental)",
      "required": false
    },
    {
      "name": "stopOnError",
      "description": "Stop execution if any task fails",
      "required": false
    },
    {
      "name": "timeout",
      "description": "Maximum execution time per task in milliseconds",
      "required": false
    },
    {
      "name": "workingDir",
      "description": "Working directory for execution",
      "required": false
    },
    {
      "name": "search",
      "description": "Enable web search for all tasks (activates web_search_request feature)",
      "required": false
    },
    {
      "name": "oss",
      "description": "Use local Ollama server",
      "required": false
    },
    {
      "name": "enableFeatures",
      "description": "Enable feature flags",
      "required": false
    },
    {
      "name": "disableFeatures",
      "description": "Disable feature flags",
      "required": false
    }
  ],
  "metadata_hash": "65e5a6b3bccacf8eb9d78136f2b8e31c2c117010766674a3667e886d0eb68b8a"
}

brainstorm

Create structured brainstorming with chosen methodology and analysis

Metadata

{
  "prompt_key": "brainstorm",
  "name": "brainstorm",
  "description": "Create structured brainstorming with chosen methodology and analysis",
  "arguments": [
    {
      "name": "prompt",
      "description": "Brainstorming challenge or question",
      "required": true
    },
    {
      "name": "model",
      "description": "Model: gpt-5-codex (default), gpt-5, o3, o4-mini, codex-1, codex-mini-latest, gpt-4.1",
      "required": false
    },
    {
      "name": "approvalPolicy",
      "description": "Approval: never, on-request, on-failure, untrusted",
      "required": false
    },
    {
      "name": "sandboxMode",
      "description": "Access: read-only, workspace-write, danger-full-access",
      "required": false
    },
    {
      "name": "fullAuto",
      "description": "Full automation mode",
      "required": false
    },
    {
      "name": "yolo",
      "description": "⚠️ Bypass all safety (dangerous)",
      "required": false
    },
    {
      "name": "cd",
      "description": "Working directory",
      "required": false
    },
    {
      "name": "methodology",
      "description": "Framework: divergent, convergent, scamper, design-thinking, lateral, auto (default)",
      "required": false
    },
    {
      "name": "domain",
      "description": "Domain: software, business, creative, research, product, marketing, etc.",
      "required": false
    },
    {
      "name": "constraints",
      "description": "Limitations: budget, time, technical, legal, etc.",
      "required": false
    },
    {
      "name": "existingContext",
      "description": "Background info or previous attempts",
      "required": false
    },
    {
      "name": "ideaCount",
      "description": "Number of ideas (default: 12, range: 5-30)",
      "required": false
    },
    {
      "name": "includeAnalysis",
      "description": "Include feasibility/impact analysis",
      "required": false
    },
    {
      "name": "search",
      "description": "Enable web search for research (activates web_search_request feature)",
      "required": false
    },
    {
      "name": "oss",
      "description": "Use local Ollama server",
      "required": false
    },
    {
      "name": "enableFeatures",
      "description": "Enable feature flags",
      "required": false
    },
    {
      "name": "disableFeatures",
      "description": "Disable feature flags",
      "required": false
    }
  ],
  "metadata_hash": "86a860cbb9da3597ad82172662027f5dbb08692035306eac33ff947725f9295c"
}

fetch-chunk

Fetch the next chunk of a response

Metadata

{
  "prompt_key": "fetch-chunk",
  "name": "fetch-chunk",
  "description": "Fetch the next chunk of a response",
  "arguments": [
    {
      "name": "prompt",
      "description": "fetch-chunk cacheKey=<key> chunkIndex=<number>",
      "required": true
    }
  ],
  "metadata_hash": "f8539a5c0d1608628f527906481aacb19b5871ebdc46a2ea18621306663b871e"
}

Help

receive help information

Metadata

{
  "prompt_key": "Help",
  "name": "Help",
  "description": "receive help information",
  "arguments": [],
  "metadata_hash": "c6f429def3cfc729b24d768211d4b0e53cdb3318e14c89c62f81df0033fa8ef0"
}

ping

Echo test message with structured response.

Metadata

{
  "prompt_key": "ping",
  "name": "ping",
  "description": "Echo test message with structured response.",
  "arguments": [
    {
      "name": "prompt",
      "description": "Message to echo ",
      "required": false
    }
  ],
  "metadata_hash": "573f2e64bd1595897e6802d4a0ee4de904fe254dfdd3a87c02648ce58d8ca4af"
}

timeout-test

Test the timeout prevention system by running a long operation

Metadata

{
  "prompt_key": "timeout-test",
  "name": "timeout-test",
  "description": "Test the timeout prevention system by running a long operation",
  "arguments": [
    {
      "name": "duration",
      "description": "Duration in milliseconds (minimum 10ms)",
      "required": true
    }
  ],
  "metadata_hash": "e287544c1e28af8183ce940fb3d1d31c676eed8572587f16cc449e04aa5ea802"
}

version

Get version information for Codex CLI and MCP server

Metadata

{
  "prompt_key": "version",
  "name": "version",
  "description": "Get version information for Codex CLI and MCP server",
  "arguments": [],
  "metadata_hash": "b6a86545e3c1be255d0c6a7ee0c4a5b110a17e9d6cbedbefbc651d53eba9d594"
}

Codex MCP Server `1.2.5`

Observation

Tools 8

Resources 0

Resource templates 0

Prompts 8

Let’s talk about MCP security.