codex exec session schema does not expose MCP tools even though `codex mcp list` shows server enabled

Open 💬 2 comments Opened Apr 15, 2026 by bupt1987
💡 Likely answer: A maintainer (github-actions[bot], contributor) responded on this thread — see the highlighted reply below.

What version of Codex CLI is running?

codex-cli 0.120.0

What subscription do you have?

200$ PRO

Which model were you using?

gpt-5.4

What platform is your computer?

Darwin 25.4.0 arm64 arm

What terminal emulator and version are you using (if applicable)?

iTerm2

What issue are you seeing?

I can confirm that my MCP server is registered and enabled:

codex mcp list
-> code-review-graph code-review-graph serve enabled

However, in a real codex exec --json session, the model-visible tool schema does not include any functions.mcp__code_review_graph__* tools.

Observed behavior:

  • MCP server is enabled in config and visible in codex mcp list
  • MCP server itself can start (code-review-graph serve)
  • But the actual codex exec session does not expose the MCP tools to the model
  • The model explicitly reports that no code-review-graph-related tools are available in the current session

Important clarification:

  • resources / resourceTemplates being empty is expected here because this MCP server is tool-only
  • The problem is specifically that tools are not injected into the exec session schema

Question:
Is codex exec expected to expose external MCP tools configured in ~/.codex/config.toml?
If yes, what conditions can cause an enabled MCP server to be omitted from the exec session tool schema?

What steps can reproduce the bug?

I can confirm that my MCP server is registered and enabled:

codex mcp list
-> code-review-graph code-review-graph serve enabled

However, in a real codex exec --json session, the model-visible tool schema does not include any functions.mcp__code_review_graph__* tools.

Observed behavior:

  • MCP server is enabled in config and visible in codex mcp list
  • MCP server itself can start (code-review-graph serve)
  • But the actual codex exec session does not expose the MCP tools to the model
  • The model explicitly reports that no code-review-graph-related tools are available in the current session

Important clarification:

  • resources / resourceTemplates being empty is expected here because this MCP server is tool-only
  • The problem is specifically that tools are not injected into the exec session schema

Question:
Is codex exec expected to expose external MCP tools configured in ~/.codex/config.toml?
If yes, what conditions can cause an enabled MCP server to be omitted from the exec session tool schema?

What is the expected behavior?

_No response_

Additional information

_No response_

View original on GitHub ↗

2 Comments

github-actions[bot] contributor · 4 months ago

Potential duplicates detected. Please review them and close your issue if it is a duplicate.

  • #16702
  • #16326
  • #17246
  • #16689

Powered by Codex Action

TunaTung · 27 days ago

Data point + working fix for the DeepSeek-official-setup variant of this. Windows 11, codex 0.146.0, models.json generated by DeepSeek's official one-command setup registers deepseek models with supports_search_tool=true + tool_mode=null — with that combination all configured MCP tools are silently hidden in exec mode (and intermittently in other modes). Setting supports_search_tool: false on those models makes all 10 of our hermes-team MCP tools appear immediately and calls succeed in exec mode.

Full details + the same workaround in #36382 (the DeepSeek-setup-specific report).