gpt-5.6-sol does not receive tool_search, leaving deferred MCP tools unreachable
What version of the Codex App are you using (From “About Codex” dialog)?
Version 26.707.91948
What subscription do you have?
Pro plan 20x
What platform is your computer?
Darwin 24.6.0 arm64 arm
What issue are you seeing?
Codex App bug report: gpt-5.6-sol cannot load deferred MCP tools
What issue are you seeing?
Codex Desktop can connect to a configured MCP server, but a freshgpt-5.6-sol task is not given the native tool-loading path needed to call the
server's deferred tools.
I reproduced this with OpenAI's public Developer Docs MCP server, so the
reproduction does not depend on a private server, OAuth, a third-party plugin,
or project-specific code.
The affected task's telemetry indicates that MCP tools are deferred. In thegpt-5.6-sol task:
- The configured MCP server is available to Codex.
- Its callable functions are not included directly in the model-facing tool
list.
tool_searchis not included in the session.- The model therefore cannot discover or load the deferred MCP function tools.
- Generic
list_mcp_resourcesandlist_mcp_resource_templatescalls do not
provide access to a tool-only server's functions.
- The model eventually bypasses Codex's native MCP tool interface by sending
raw MCP JSON-RPC requests to the public endpoint with shell curl commands.
There is no explicit runtime error message. The failure is the absence of both
the deferred MCP functions and the tool_search loader from the model-facing
toolbox.
The equivalent gpt-5.5 task works normally:
- It receives
tool_search. - It searches for the OpenAI Developer Docs tools.
- Codex loads the
mcp__openaiDeveloperDocsnamespace. - The model calls
search_openai_docsandfetch_openai_docthrough the
native MCP interface.
The prompt, workspace, Codex installation, MCP configuration, and server were
the same. Only the selected model changed.
Environment:
- Embedded Codex runtime:
0.144.5 - Platform:
Darwin 24.6.0 arm64 arm - MCP transport: Streamable HTTP
- MCP server:
https://developers.openai.com/mcp
This appears to be a Codex Desktop task/tool-exposure defect affectinggpt-5.6-sol, rather than an MCP server defect.
Related reports:
What steps can reproduce the bug?
- Configure OpenAI's public Developer Docs MCP server:
``toml``
[mcp_servers.openaiDeveloperDocs]
url = "https://developers.openai.com/mcp"
The equivalent CLI command is:
``sh``
codex mcp add openaiDeveloperDocs --url https://developers.openai.com/mcp
- Restart Codex Desktop.
- Start a fresh task using
gpt-5.5.
- Submit this exact prompt:
``text``
Use the OpenAI Developer Docs MCP server to search for Codex MCP configuration documentation.
- Observe the native tool path:
``text``
tool_search
-> loads mcp__openaiDeveloperDocs
-> search_openai_docs
-> fetch_openai_doc
-> successful response
- Start another fresh task in the same workspace using
gpt-5.6-sol.
- Submit the identical prompt.
- Observe that the task receives neither
tool_searchnor the deferred
mcp__openaiDeveloperDocs function tools.
- In the reproduced task, the model tries generic MCP resource calls and then
works around the missing native tool path with commands equivalent to:
``sh``
curl -sS -X POST https://developers.openai.com/mcp \
-H 'Content-Type: application/json' \
-H 'Accept: application/json, text/event-stream' \
--data '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}'
It then sends a raw tools/call request through curl. This proves that
the public MCP endpoint is reachable, but it is not a successful native
Codex MCP tool invocation.
Session evidence
Working gpt-5.5 session:
019f6b3e-86fc-73a2-ad6a-6b658338822d
Affected gpt-5.6-sol session:
019f6b3f-2a0e-7c70-9814-b4c288fee944
Token and context usage
Both were fresh, single-prompt tasks with a model context window of 258,400
tokens.
First recorded token-count event:
gpt-5.5:21,300 / 258,400tokens, approximately8.2%gpt-5.6-sol:17,979 / 258,400tokens, approximately7.0%
Final model request:
gpt-5.5:65,602 / 258,400tokens, approximately25.4%gpt-5.6-sol:61,620 / 258,400tokens, approximately23.8%
No context compaction, context-window exhaustion, or token-limit failure
occurred in either task.
What is the expected behavior?
When Codex defers MCP function tools, every supported model session should
receive a working mechanism for discovering and loading those tools.
For gpt-5.6-sol, Codex should do one of the following:
- Provide
tool_search, allowing the model to discover and load the deferred
MCP namespace; or
- Expose the applicable MCP function tools directly when
tool_searchis not
available.
With the same configuration and prompt, gpt-5.6-sol should follow the same
native path demonstrated by gpt-5.5:
tool_search
-> load mcp__openaiDeveloperDocs
-> call search_openai_docs
-> call fetch_openai_doc
-> return the documentation result
The model should not need to inspect MCP configuration, call generic resource
APIs, or manually recreate the MCP protocol with shell curl commands.
Additional information
<img width="874" height="1152" alt="Image" src="https://github.com/user-attachments/assets/efa8d2e7-7a99-430c-ba13-181559f04e1a" />
<img width="935" height="1156" alt="Image" src="https://github.com/user-attachments/assets/0b637c3d-da17-4611-a203-91c187b79753" />
First discover when building a mcp plugin for our platform:
<img width="910" height="975" alt="Image" src="https://github.com/user-attachments/assets/b4b7a5eb-8c86-463c-96c7-c00239ddc5b8" />
<img width="965" height="1031" alt="Image" src="https://github.com/user-attachments/assets/eb551926-584f-4f42-95ca-abb7eca186d6" />
This issue has 1 comment on GitHub. Read the full discussion on GitHub ↗