Read-only access to OpenAI developer documentation (search + page content)
Well-curated, focused tool set (5 tools) with clear documentation purposes. Tools follow a logical workflow pattern: search → fetch → spec exploration. Descriptions are substantive and explain WHEN to use each tool. Schema design is typed and intentional. Primary weakness is incomplete description text (truncation) in search_openai_docs and list_openai_docs, and slightly generic descriptions in list_api_endpoints.
Fetch the markdown for a specific doc page (from `developers.openai.com` or `platform.openai.com`) so you can quote/summarize exact, up-to-date guidance (schemas, examples, limits, edge cases). Prefer to **`search_openai_docs` first** (or `list_openai_docs` if you’re browsing) to find the best URL, then `fetch_openai_doc` to pull the exact text; you can pass `anchor` (e.g. `#streaming`) to fetch just that section.
Return the OpenAPI spec for a specific API endpoint URL. Optionally filter code samples by language, or return only code samples.
List all OpenAI API endpoint URLs available in the OpenAPI spec.
List/browse pages from `platform.openai.com` + `developers.openai.com` that this server crawls (useful when you don’t know the right query yet or you’re paging through results). Search across `platform.openai.com` + `developers.openai.com` docs. Use this whenever you are working with the OpenAI API (including the Responses API), OpenAI API SDKs, ChatGPT Apps SDK, or ChatGPT Codex. Results include URLs—**after `list`, use `fetch_openai_doc`** on a result URL to get the full markdown.
Search across `platform.openai.com` + `developers.openai.com` docs. Use this whenever you are working with the OpenAI API (including the Responses API), OpenAI API SDKs, ChatGPT Apps SDK, or ChatGPT Codex. Results include URLs—**after `search`, use `fetch_openai_doc`** to read/quote the exact markdown.
Description text truncation in search_openai_docs and fetch_openai_doc
list_api_endpoints description is generic and doesn't explain workflow context or when to use it
Duplicate/overlapping description text between search_openai_docs and list_openai_docs creates confusion about intended use cases
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-04-14 | C | 67 | 2025-11-25 | v1 |