OpenAI Docs MCP: what works in Claude, ChatGPT, Cursor, and Grok Bot
OpenAI developer docs remote MCP server: search and fetch OpenAI API docs, list API endpoints, and read the OpenAPI spec. No sign-in needed.
Registry name: (v)
Set it up
URL https://developers.openai.com/mcp. No sign-in. Paste the URL and it connects. Copy-paste setup: Claude | Claude Code | Cursor | VS Code | ChatGPT
Status grid
| App | Status | Date tested |
|---|---|---|
| Claude | Untested | Not yet tested |
| ChatGPT | Untested | Not yet tested |
| Cursor | Untested | Not yet tested |
| Grok Bot | Untested | Not yet tested |
| MCP Inspector (reference client) | Untested | Not yet tested |
| MCP TypeScript SDK (reference client) | Works | Fri Oct 16 2026 |
Hands-on test results
| App | Task | Result | Time | Detail | Date tested |
|---|---|---|---|---|---|
| MCP TypeScript SDK (reference client) | connect (no auth) | Works | 482 ms | Connected without sign-in in 482 ms. | Oct 16, 2026, 4:45 PM CT |
| MCP TypeScript SDK (reference client) | list tools | Works | 186 ms | 5 tools: search_openai_docs, list_openai_docs, fetch_openai_doc, list_api_endpoints, get_openapi_spec. | Oct 16, 2026, 4:45 PM CT |
| MCP TypeScript SDK (reference client) | search docs ("Responses API streaming") | Works | 320 ms | search_openai_docs: about 8 KB returned. "{"hits":[{"url":"https://developers.openai.com/api/docs/guides/streaming-responses","url_without_anchor":"https://developers.openai.com/api/" | Oct 16, 2026, 4:45 PM CT |
| MCP TypeScript SDK (reference client) | fetch a doc (Responses API streaming guide) | Works | 290 ms | fetch_openai_doc: about 7 KB returned. "# Streaming API responses > For the complete documentation index, see [llms.txt](/llms.txt). Markdown versions of documentation pages are av" | Oct 16, 2026, 4:45 PM CT |
| MCP TypeScript SDK (reference client) | list API endpoints | Works | 67 ms | list_api_endpoints: about 24 KB returned. "{ "baseUrls": [ "https://api.openai.com/v1" ], "paths": [ "/agents", "/agents/environments", "/agents/environments/templates", "/agents/envi" | Oct 16, 2026, 4:45 PM CT |
| MCP TypeScript SDK (reference client) | search with nonsense query | Works | 284 ms | search_openai_docs: 31 characters returned. "{"hits":[],"nbHits":0,"page":0}" | Oct 16, 2026, 4:45 PM CT |
| MCP TypeScript SDK (reference client) | error handling (missing url) | Works | 47 ms | fetch_openai_doc: tool error, 253 characters returned. "MCP error -32602: Input validation error: Invalid arguments for tool fetch_openai_doc: [ { "expected": "string", "code": "invalid_type", "pa" | Oct 16, 2026, 4:45 PM CT |
Oct 16, 2026, 4:45 PM CT, MCP TypeScript SDK (reference client): Scripted client using the official MCP TypeScript SDK v1.32.1 against https://developers.openai.com/mcp (Streamable HTTP, protocol 2025-11-25). No sign-in needed. Server openai-docs-mcp v1.0.0. Read-only server, so no create task. 7 of 7 tasks passed.
Automated handshake
No public remote endpoint to check (local or package-only server).
Gotchas
- MCP TypeScript SDK (reference client): list_api_endpoints returns about 25 KB of paths in one call.
FAQ
Does the OpenAI Docs MCP server work?
In our hands-on test on Oct 16, 2026, 7 of 7 tasks passed. Main gotcha: list_api_endpoints returns about 25 KB of paths in one call.
What is the OpenAI Docs MCP server URL?
https://developers.openai.com/mcp (Streamable HTTP).
Does the OpenAI Docs MCP server need sign-in?
No sign-in. Paste the URL and it connects.
How do I add the OpenAI Docs MCP server to Claude, Cursor, VS Code or ChatGPT?
Follow our copy-paste setup guides: https://connectorreport.com/c/openai-docs/setup/claude https://connectorreport.com/c/openai-docs/setup/claude-code https://connectorreport.com/c/openai-docs/setup/cursor https://connectorreport.com/c/openai-docs/setup/vscode https://connectorreport.com/c/openai-docs/setup/chatgpt
Compare
- OpenAI Docs vs Microsoft Learn
- OpenAI Docs vs Model Context Protocol Docs
- OpenAI Docs vs LangChain Docs
- OpenAI Docs vs GitMCP (generic docs endpoint)
- OpenAI Docs vs GitMCP for Next.js
- OpenAI Docs vs Astro Docs
- OpenAI Docs vs Perplexity Docs
- OpenAI Docs vs Firecrawl Docs
Best MCP servers for documentation and docs search
Compare with other tested connectors | Connector Weather
Request a hands-on test of OpenAI Docs
Get the badge
Maintain OpenAI Docs or write about it? Show its live ConnectorReport status in your README or docs.
Markdown (README, docs)
[](https://connectorreport.com/c/openai-docs?utm_source=badge&utm_medium=embed&utm_campaign=openai-docs)
HTML
<a href="https://connectorreport.com/c/openai-docs?utm_source=badge&utm_medium=embed&utm_campaign=openai-docs"><img src="https://connectorreport.com/badge/openai-docs.svg" alt="OpenAI Docs MCP status on ConnectorReport"/></a>
The badge updates on its own after every retest. How badges work