mcpField
O
openai-knowledge

openai-knowledge

github.com/openaiDevelopment4.0k132 installsUpdated 1d ago
Repository

About openai-knowledge

A skill for answering questions about OpenAI developer documentation using exact text fetched through the OpenAI Developer Documentation MCP server. It directs Codex users to check server availability, search before fetching, and set up the server if needed.

Key features

  1. 01Check OpenAI docs MCP availability
  2. 02Search documentation before fetching
  3. 03Fetch exact Markdown pages
  4. 04Retrieve API schemas and endpoint lists
  5. 05Guide MCP server setup

Use cases

  1. 01Verify an OpenAI API detail against docs
  2. 02Find the relevant developer documentation page
  3. 03Configure docs MCP when tools are unavailable

MCP support

Uses the OpenAI Developer Documentation MCP server to search and fetch documentation, OpenAPI specs, and endpoint lists. If it is not configured, the skill provides setup instructions.

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/openai/openai-agents-js --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(s).
    • 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