mcpField
O
openai-knowledge

openai-knowledge

github.com/openaiDevelopment30.4k445 installsUpdated 1d ago
Repository

About openai-knowledge

openai-knowledge is a skill for answering questions from the exact text of OpenAI developer documentation. It guides users to search and fetch documentation through the OpenAI Developer Documentation MCP server before responding.

Key features

  1. 01Search and fetch documentation pages
  2. 02Retrieve OpenAPI specifications
  3. 03List API endpoints
  4. 04Ground answers in fetched documentation

Use cases

  1. 01Verify an OpenAI API parameter
  2. 02Find documentation for a feature
  3. 03Check endpoint schemas

MCP support

The skill uses the OpenAI Developer Documentation MCP server to search and fetch documentation, and describes setup options if it is unavailable.

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/openai/openai-agents-python --skill openai-knowledge

After installing, type/openai-knowledgein Claude Code to confirm it loaded.

Bundled filesagents/openai.yaml

Details

From the project README

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

Comments

Markdown supported