openai-docs

name	openai-docs
description	Use official OpenAI docs.
practices	["prompt-as-spec","ai-assisted-dev"]
hexagonal_role	driven-adapter
consumes	["external-api"]
produces	[]
context_rel	[]
skill_api_version	1
context	{"window":"fork","intent":{"mode":"questions"},"sections":{"exclude":["HISTORY","TASK"]},"intel_scope":"none"}
metadata	{"tier":"cross-vendor","internal":false}
output_contract	stdout: documentation with citations

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

1. Apps SDK: Build ChatGPT apps by providing a web component UI and an MCP server that exposes your app's tools to ChatGPT.
2. Responses API: A unified endpoint designed for stateful, multimodal, tool-using interactions in agentic workflows.
3. Chat Completions API: Generate a model response from a list of messages comprising a conversation.
4. Codex: OpenAI's coding agent for software development that can write, understand, review, and debug code.
5. gpt-oss: Open-weight OpenAI reasoning models (gpt-oss-120b and gpt-oss-20b) released under the Apache 2.0 license.
6. Realtime API: Build low-latency, multimodal experiences including natural speech-to-speech conversations.
7. 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:

In Codex:

1. Run: codex mcp add openaiDeveloperDocs --url https://developers.openai.com/mcp
2. If it fails due to permissions/sandboxing, retry with escalated permissions.
3. Ask the user to restart Codex, then re-run doc search/fetch.

In Claude Code:

1. Add the MCP server to ~/.claude/settings.json under "mcpServers":

   {
     "mcpServers": {
       "openaiDeveloperDocs": {
         "type":