About

This skill provides authoritative OpenAI API documentation through MCP tools, enabling developers to access up-to-date schemas, examples, and platform details. It automatically searches and fetches exact documentation when working with OpenAI APIs, Responses API, or platform features like tools and streaming. Use it to get accurate technical information instead of relying on Claude's internal knowledge.

Quick Install

Claude Code

Recommended

Primary

npx skills add openai/openai-agents-python

Plugin CommandAlternative

/plugin add https://github.com/openai/openai-agents-python

Git CloneAlternative

git clone https://github.com/openai/openai-agents-python.git ~/.claude/skills/openai-knowledge

Copy and paste this command in Claude Code to install this skill

Documentation

OpenAI Knowledge

Overview

Use the OpenAI Developer Documentation MCP server to search and fetch exact docs (markdown), then base your answer on that text instead of guessing.

Workflow

1) Check whether the Docs MCP server is available

If the mcp__openaiDeveloperDocs__* tools are available, use them.

If you are unsure, run codex mcp list and check for openaiDeveloperDocs.

2) Use MCP tools to pull exact docs

Search first, then fetch the specific page or pages.
- mcp__openaiDeveloperDocs__search_openai_docs → pick the best URL.
- mcp__openaiDeveloperDocs__fetch_openai_doc → retrieve the exact markdown (optionally with an anchor).
When you need endpoint schemas or parameters, use:
- mcp__openaiDeveloperDocs__get_openapi_spec
- mcp__openaiDeveloperDocs__list_api_endpoints

Base your answer on the fetched text and quote or paraphrase it precisely. Do not invent flags, field names, defaults, or limits.

3) If MCP is not configured, guide setup (do not change config unless asked)

Provide one of these setup options, then ask the user to restart the Codex session so the tools load:

CLI:
- codex mcp add openaiDeveloperDocs --url https://developers.openai.com/mcp

Config file (~/.codex/config.toml):

Add:

[mcp_servers.openaiDeveloperDocs]
url = "https://developers.openai.com/mcp"

Also point to: https://developers.openai.com/resources/docs-mcp#quickstart

openai-knowledge