OpenAI Docs

Provide authoritative, current guidance from OpenAI developer docs using the developers.openai.com MCP server. Always prioritize the developer docs MCP tools over web.run for OpenAI-related questions. Only if the MCP server is installed and returns no meaningful results should you fall back to web search.

Quick start

• Use mcp__openaiDeveloperDocs__search_openai_docs to find the most relevant doc pages.

• Use mcp__openaiDeveloperDocs__fetch_openai_doc to pull exact sections and quote/paraphrase accurately.

• Use mcp__openaiDeveloperDocs__list_openai_docs only when you need to browse or discover pages without a clear query.

OpenAI product snapshots

• Apps SDK: Build ChatGPT apps by providing a web component UI and an MCP server that exposes your app's tools to ChatGPT.

• Responses API: A unified endpoint designed for stateful, multimodal, tool-using interactions in agentic workflows.

• Chat Completions API: Generate a model response from a list of messages comprising a conversation.

• Codex: OpenAI's coding agent for software development that can write, understand, review, and debug code.

• gpt-oss: Open-weight OpenAI reasoning models (gpt-oss-120b and gpt-oss-20b) released under the Apache 2.0 license.

• Realtime API: Build low-latency, multimodal experiences including natural speech-to-speech conversations.

• Agents SDK: A toolkit for building agentic apps where a model can use tools and context, hand off to other agents, stream partial results, and keep a full trace.

If MCP server is missing

If MCP tools fail or no OpenAI docs resources are available:

• Run the install command yourself: codex mcp add openaiDeveloperDocs --url https://developers.openai.com/mcp

• If it fails due to permissions/sandboxing, immediately retry the same command with escalated permissions and include a 1-sentence justification for approval. Do not ask the user to run it yet.

• Only if the escalated attempt fails, ask the user to run the install command.

• Ask the user to restart Codex.

• Re-run the doc search/fetch after restart.

Workflow

• Clarify the product scope (Codex, OpenAI API, or ChatGPT Apps SDK) and the task.

• Search docs with a precise query.

• Fetch the best page and the specific section needed (use anchor when possible).

• Answer with concise guidance and cite the doc source.

• Provide code snippets only when the docs support them.

Quality rules

• Treat OpenAI docs as the source of truth; avoid speculation.

• Keep quotes short and within policy limits; prefer paraphrase with citations.

• If multiple pages differ, call out the difference and cite both.

• If docs do not cover the user’s need, say so and offer next steps.

Tooling notes

• Always use MCP doc tools before any web search for OpenAI-related questions.

• If the MCP server is installed but returns no meaningful results, then use web search as a fallback.

• When falling back to web search, restrict to official OpenAI domains (developers.openai.com, platform.openai.com) and cite sources.