OpenAI Developer Docs MCP server

Endpoint: https://developers.openai.com/mcp · Authentication: No auth

Searches and retrieves OpenAI developer documentation pages. It is public and read-only and needs no account or API key.

Test it live Run the release-readiness report

How do I authenticate?

Add the endpoint directly in your client. The catalog records no authentication requirement; no OAuth sign-in or API key is configured in this setup. The live server may change.

Authentication and connection guide

Connection specification

Remote endpoint: https://developers.openai.com/mcp
Browser access: Not yet measured
Declared MCP transport: Streamable HTTP
Live-validated MCP transport: Streamable HTTP — Observed by the latest catalog validation
Declared authentication: No authentication
Detected authentication: No authentication detected or retained from publisher evidence
Protocol lifecycle: Stateful MCP · 2025-11-25
Category: Documentation

Product documentation · Official listing documentation

More Documentation MCP servers · Browse all MCP servers · Test this endpoint in the MCP Playground

Authorization setup

No app registration needed

This catalog entry does not require authorization or provider app registration.

Connect it

Live-validated endpoint: https://developers.openai.com/mcp · Streamable HTTP. No authentication is required by the catalog listing.

Agent prompt for Claude Code or Codex

Add the OpenAI Developer Docs MCP server to my MCP client configuration and verify that it works.

What it is: Searches and retrieves OpenAI developer documentation pages. It is public and read-only and needs no account or API key.
Server URL: https://developers.openai.com/mcp
Transport: Streamable HTTP (remote MCP server, no local install).
Authentication: none. The server accepts connections without credentials.
Tools (5, as last observed by mcptest): fetch_openai_doc, get_openapi_spec, list_api_endpoints, list_openai_docs, search_openai_docs.
Reference: https://mcptest.io/servers/openai-docs/

Steps:
1. Work out which MCP client I use (Claude Code, Codex, Cursor, VS Code or another) and add the server under the name "openai-docs" in that client's MCP configuration, user scope unless I ask otherwise.
   Claude Code: claude mcp add --transport http --scope user 'openai-docs' 'https://developers.openai.com/mcp'
   Codex: codex mcp add 'openai-docs' --url 'https://developers.openai.com/mcp'
   Other clients: use the setup for that client on the reference page.
2. Never write a credential value into a file that could be committed; reference an environment variable or the client's secret store, and ask me for any value you need.
3. Verify: connect to the server and call tools/list. Confirm the tools above are listed, and report any sign-in step I still have to complete.

Claude Code setup

Run in a terminal. This user-scoped entry is available across projects.

claude mcp add --transport http --scope user 'openai-docs' 'https://developers.openai.com/mcp'

Codex CLI setup

Run in a terminal; Codex stores the entry in ~/.codex/config.toml.

codex mcp add 'openai-docs' --url 'https://developers.openai.com/mcp'

Cursor setup

Add to .cursor/mcp.json for this project, or ~/.cursor/mcp.json for all projects.

{
  "mcpServers": {
    "openai-docs": {
      "url": "https://developers.openai.com/mcp"
    }
  }
}

VS Code setup

Add to .vscode/mcp.json, or run “MCP: Open User Configuration” for a private user-level entry.

{
  "servers": {
    "openai-docs": {
      "type": "http",
      "url": "https://developers.openai.com/mcp"
    }
  }
}

Claude setup

Add the endpoint above in Claude:

Customize > Connectors > Add custom connector
Team/Enterprise: Organization settings > Connectors > Add > Custom > Web

Claude Desktop setup

Add the endpoint above in Claude Desktop:

Remote: Customize > Connectors (same as claude.ai)
Local: Settings > Developer > Edit Config, or Settings > Extensions for .mcpb files
~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows), local servers only

ChatGPT setup

Add the endpoint above in ChatGPT:

ChatGPT web: Plugins > Add custom MCP server, then configure authentication and accept the risk warning

Windsurf setup

Add the endpoint above in Windsurf:

~/.config/devin/mcp_config.json (%APPDATA%\devin\mcp_config.json on Windows), serverUrl or url
Cascade panel > ... > MCPs > Open MCP config file

Gemini CLI setup

Add the endpoint above in Gemini CLI:

gemini mcp add --transport http <name> <url>
~/.gemini/settings.json (user) or .gemini/settings.json (project), mcpServers

MCP SDK setup

Add the endpoint above in MCP SDK:

Programmatic: new Client(...).connect(new StreamableHTTPClientTransport(url))

Client compatibility

Client	Status	Why
Claude Code	Supported	Claude Code supports Streamable HTTP servers and servers without authentication.
Codex	Partial	Codex's documentation does not state support for servers without authentication.
Cursor	Supported	Cursor supports Streamable HTTP servers and servers without authentication.
VS Code	Supported	VS Code supports Streamable HTTP servers and servers without authentication.
Claude	Supported	Claude supports Streamable HTTP servers and servers without authentication.
Claude Desktop	Supported	Claude Desktop supports Streamable HTTP servers and servers without authentication.
ChatGPT	Partial	Stateful routing needs operational care: ChatGPT can preserve MCP sessions, but the deployment must route a session consistently and retain its state.
Windsurf	Partial	Windsurf's documentation does not state support for servers without authentication.
Gemini CLI	Supported	Gemini CLI supports Streamable HTTP servers and servers without authentication.
MCP SDK	Supported	MCP SDK supports Streamable HTTP servers and servers without authentication.

Computed from this server's validated transport, protocol and authentication against documented client support. Checks the catalog has not observed are not counted.

Similar servers

Context7 — Context7 provides up-to-date, version-specific library documentation and code examples directly from the source. No authentication
DeepWiki — DeepWiki provides conversational, up-to-date documentation for public GitHub repositories. No authentication
MDN — Open remote MCP server for MDN web documentation, search, and browser compatibility data. No authentication
Cloudflare Docs — Searches Cloudflare's developer documentation for reference material on Workers, R2, D1, DNS, Zero Trust, and other Cloudflare products. No authentication is required. No authentication
AWS Knowledge — Searches and reads AWS documentation, API references, What's New posts, and regional service availability. No authentication is required. No authentication
Microsoft Learn — Searches and fetches Microsoft Learn documentation and official code samples for Azure, .NET, Microsoft 365, and other Microsoft products. No authentication is required. No authentication

Guides for this server

Watch this server for breaking changes

Share and embed

Maintain OpenAI Developer Docs? Embed this badge in your README. It follows the latest catalog validation result and links to this server profile.

Markdown

[![Tested on mcptest.io](https://mcptest.io/badge/server/openai-docs.svg)](https://mcptest.io/servers/openai-docs/)

HTML

<a href="https://mcptest.io/servers/openai-docs/"><img src="https://mcptest.io/badge/server/openai-docs.svg" alt="Tested on mcptest.io"></a>

reStructuredText

.. image:: https://mcptest.io/badge/server/openai-docs.svg
   :alt: Tested on mcptest.io
   :target: https://mcptest.io/servers/openai-docs/

Latest validation evidence

Validation status: Online when last tested
Validation checked at: Oct 26, 2026 at 11:07 AM
Validation detail: Negotiated stateful MCP 2025-11-25 at https://developers.openai.com/mcp; detected transport streamable-http; authentication none

Tool inventory

What the catalog validator observed on Oct 26, 2026 at https://developers.openai.com/mcp without credentials. The live server may have changed since; connect in the Playground for the current list.

Tools provided by OpenAI Developer Docs 5

fetch_openai_docNo outputSchema
Fetch the markdown for a specific doc page from `developers.openai.com`, `platform.openai.com`, or `learn.chatgpt.com` so you can quote or summarize exact, up-to-date guidance (schemas, examples, limits, and 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` (for example, `#streaming`) to fetch just that section.
Input anchor?: string, url: string
- anchor?: stringoptional
- url: stringrequired
get_openapi_specNo outputSchema
Return the OpenAPI spec for a specific API endpoint URL. Optionally filter code samples by language, or return only code samples.
Input codeExamplesOnly?: boolean, languages?: array, url: string
- codeExamplesOnly?: booleanoptional
- languages?: arrayoptional
- url: stringrequired
list_api_endpointsNo outputSchema
List all OpenAI API endpoint URLs available in the OpenAPI spec.
Input No parameters
list_openai_docsNo outputSchema
List or browse pages from `platform.openai.com`, `developers.openai.com`, and `learn.chatgpt.com` that this server crawls (useful when you don’t know the right query yet or you’re paging through results). Use this whenever you are working with the OpenAI API (including the Responses API), OpenAI API SDKs, plugins, ChatGPT, or Codex. Results include URLs—**after `list`, use `fetch_openai_doc`** on a result URL to get the full markdown.
Input cursor?: string, limit?: integer
- cursor?: stringoptional
- limit?: integeroptional
search_openai_docsNo outputSchema
Search across `platform.openai.com`, `developers.openai.com`, and `learn.chatgpt.com` docs. Use this whenever you are working with the OpenAI API (including the Responses API), OpenAI API SDKs, plugins, ChatGPT, or Codex. Results include URLs—**after `search`, use `fetch_openai_doc`** to read/quote the exact markdown.
Input cursor?: string, limit?: integer, query: string
- cursor?: stringoptional
- limit?: integeroptional
- query: stringrequired