Manufact

LeaderboardBack to leaderboard

openai-docs-mcp

developers.openai.com/mcp

Official public MCP server for searching and reading OpenAI developer documentation.

View checks

Protocol: MCP 2026-07-28
Server version: 1.0.0
Supports: Tools

Overall score

How is this score calculated?

Last reviewed at Nov 13, 2026, 19:27:38 UTC

Server metadata

Warnings30/100

Identity, discovery, and usage metadata advertised during the MCP handshake.

Stable server name

openai-docs-mcp

10/10Source

Human-readable title

Add a human-readable title for clients and directories.

0/10Source

Useful description

Describe what the server helps an agent do.

0/20Source

Server version

Version 1.0.0

10/10Source

Public website

Link to a public website or documentation page.

0/10Source

Scalable or high-resolution icon

Advertise a vector or at least 128px server icon.

0/10Source

Server instructions

Add concise instructions that explain how an agent should use the server.

0/20Source

Declared capabilities

Supports Tools.

10/10Source

Discoverability

0/100

Client listings and public setup information.

mcp.json or server-card.json

Either mcp.json or an MCP Server Card declaring this endpoint passes.

No matching mcp.json manifest or MCP Server Card was found at the checked URLs.

Not foundSource

Setup instructions at MCP URL

The public page returned HTTP 405.

Not foundSource

ChatGPT

No ChatGPT listing has been confirmed yet.

UnverifiedHow to get listed

Claude

No Claude listing has been confirmed yet.

UnverifiedHow to get listed

CursorGrok BotGrok

No Cursor marketplace listing has been confirmed yet.

UnverifiedHow to get listed

Muse

No Muse listing has been confirmed yet.

UnverifiedHow to get listed

4 unverified checks. Unverified checks earn no points until confirmed.

Protocol

Pass100/100

Connection, authentication, and protocol compatibility.

MCP negotiation succeeds (v1/v2)

MCP modern negotiation succeeded in 804ms

Source

Tools list returns results

5 tool(s) returned

Source

Resources list responds

0 resource(s) returned

Source

Server declares tools capability

Server declares tools capability in initialize response

Source

Tools

Issues93/100

Tool definitions, annotations, and client compatibility.

Skills over MCP resources are readable

Server does not advertise the Skills over MCP extension

All tools have descriptions

All tools have non-empty descriptions

Claude Code metadata fits its 2 KB fields

Tool descriptions and server instructions fit Claude Code's 2 KB fields

Source

Claude tools declare applicable behavior hints

All tools include an applicable readOnlyHint or destructiveHint

Source

All tools have OpenAI behavior hints

5 behavior annotation issue(s) found

How to fix: On each tool, declare annotations.readOnlyHint, annotations.destructiveHint, and annotations.openWorldHint as booleans. The policy review separately assesses whether their values match the tool's actual behavior.

errorChatGPT

Source

All tools have a display title

Source

Claude tool names are within 64 characters

All tool names are within Claude's 64-character limit

Source

Cursor tool-name budget advisory

No tool name independently exhausts Cursor's observed 60-character combined budget

Observed behavior

OpenAI file parameters use valid schemas

All declared OpenAI file parameters use reviewer-valid schemas

Source

Tool names use valid characters

All tool names use valid characters

Source

Tool names follow the MCP 1–128 character range

All tool names follow the MCP recommended length

Source

Tool names follow MCP uniqueness guidance

All tool names are unique

Source

ChatGPT tool names are unique

All tool names are unique

Source

Tool text has no hidden control characters

No invisible or control characters found in tool-facing text

Source

Tool input header annotations are valid

All x-mcp-header annotations satisfy Streamable HTTP requirements

Source

Tool input schemas have a valid object structure

All tool input schemas have a valid object structure

Source

Declared output schemas have a valid basic structure

0 declared output schema(s) pass basic structural validation; schemas may describe any JSON value, including arrays

Source

MCP Apps

Not applicableOptional

App resources, metadata, and rendering requirements.

Tool invocation metadata present

No view resources found — view checks skipped

Source

Tool-linked resource URI is readable

No view resources found — view checks skipped

Source

View resource envelope is valid

No view resources found — view checks skipped

All discovered view resources were inspected

No view resources found — view checks skipped

Source

Declared domains respond

No view resources found — view checks skipped

View resource metadata complete

No view resources found — view checks skipped

Source

Views do not request nested iframe domains

No view resources found — view checks skipped

Source

View resources declare a domain

No view resources found — view checks skipped

Source

CSP metadata covers literal external origins

No view resources found — view checks skipped

Source

Tool visibility metadata is valid

No view resources found — view checks skipped

Source

Tool documentation quality

60/100

How clearly each tool’s title, description, input and output schemas, and behavior annotations guide an agent.

search_openai_docsTitles 99Descriptions 95Inputs 0Annotations 50Outputs 057/100

search_openai_docs

Title99/100

Search OpenAI Docs

The title clearly communicates the tool’s action and subject. Keep it concise.

Description95/100

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.

The description explains the capability, when to use it, and what to expect.

Inputs0/100

0 of 3 inputs have descriptions. Add descriptions to the missing inputs, including where to obtain IDs and how to supply values.

query

Not provided

Missing description. Explain what this value means and how to supply it.

limit

Not provided

Missing description. Explain what this value means and how to supply it.

cursor

Not provided

Missing description. Explain what this value means and how to supply it.

Annotations50/100

Declare idempotentHint, openWorldHint based on the tool’s actual behavior.

{
  "readOnlyHint": true,
  "destructiveHint": false
}

Output schema0/100

No output schema is declared. Add one for structured results so clients can interpret returned fields.

Not declared

Original tool metadata

{
  "name": "search_openai_docs",
  "title": "Search OpenAI Docs",
  "description": "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.",
  "inputSchema": {
    "type": "object",
    "$schema": "https://json-schema.org/draft/2020-12/schema",
    "required": [
      "query"
    ],
    "properties": {
      "limit": {
        "type": "integer",
        "maximum": 50,
        "minimum": 1
      },
      "query": {
        "type": "string",
        "minLength": 1
      },
      "cursor": {
        "type": "string"
      }
    }
  },
  "annotations": {
    "readOnlyHint": true,
    "destructiveHint": false
  }
}

list_openai_docsTitles 99Descriptions 96Inputs 0Annotations 50Outputs 057/100

list_openai_docs

Title99/100

List OpenAI Docs

The title clearly communicates the tool’s action and subject. Keep it concise.

Description96/100

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.

The description explains the capability, when to use it, and what to expect.

Inputs0/100

0 of 2 inputs have descriptions. Add descriptions to the missing inputs, including where to obtain IDs and how to supply values.

limit

Not provided

Missing description. Explain what this value means and how to supply it.

cursor

Not provided

Missing description. Explain what this value means and how to supply it.

Annotations50/100

Declare idempotentHint, openWorldHint based on the tool’s actual behavior.

{
  "readOnlyHint": true,
  "destructiveHint": false
}

Output schema0/100

No output schema is declared. Add one for structured results so clients can interpret returned fields.

Not declared

Original tool metadata

{
  "name": "list_openai_docs",
  "title": "List OpenAI Docs",
  "description": "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.",
  "inputSchema": {
    "type": "object",
    "$schema": "https://json-schema.org/draft/2020-12/schema",
    "properties": {
      "limit": {
        "type": "integer",
        "maximum": 50,
        "minimum": 1
      },
      "cursor": {
        "type": "string"
      }
    }
  },
  "annotations": {
    "readOnlyHint": true,
    "destructiveHint": false
  }
}

fetch_openai_docTitles 99Descriptions 92Inputs 0Annotations 50Outputs 056/100

fetch_openai_doc

Title99/100

Fetch OpenAI Doc

The title clearly communicates the tool’s action and subject. Keep it concise.

Description92/100

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.

The description explains the capability, when to use it, and what to expect.

Inputs0/100

0 of 2 inputs have descriptions. Add descriptions to the missing inputs, including where to obtain IDs and how to supply values.

url

Not provided

Missing description. Explain what this value means and how to supply it.

anchor

Not provided

Missing description. Explain what this value means and how to supply it.

Annotations50/100

Declare idempotentHint, openWorldHint based on the tool’s actual behavior.

{
  "readOnlyHint": true,
  "destructiveHint": false
}

Output schema0/100

No output schema is declared. Add one for structured results so clients can interpret returned fields.

Not declared

Original tool metadata

{
  "name": "fetch_openai_doc",
  "title": "Fetch OpenAI Doc",
  "description": "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.",
  "inputSchema": {
    "type": "object",
    "$schema": "https://json-schema.org/draft/2020-12/schema",
    "required": [
      "url"
    ],
    "properties": {
      "url": {
        "type": "string",
        "minLength": 1
      },
      "anchor": {
        "type": "string"
      }
    }
  },
  "annotations": {
    "readOnlyHint": true,
    "destructiveHint": false
  }
}

list_api_endpointsTitles 98Descriptions 75Inputs 100Annotations 50Outputs 078/100

list_api_endpoints

Title98/100

List API Endpoints

The title clearly communicates the tool’s action and subject. Keep it concise.

Description75/100

List all OpenAI API endpoint URLs available in the OpenAPI spec.

Describe the returned information so the agent knows whether it will answer the request.

Inputs100/100

This tool declares no inputs, so argument descriptions are not needed.

No input fields.

Annotations50/100

Declare idempotentHint, openWorldHint based on the tool’s actual behavior.

{
  "readOnlyHint": true,
  "destructiveHint": false
}

Output schema0/100

No output schema is declared. Add one for structured results so clients can interpret returned fields.

Not declared

Original tool metadata

{
  "name": "list_api_endpoints",
  "title": "List API Endpoints",
  "description": "List all OpenAI API endpoint URLs available in the OpenAPI spec.",
  "inputSchema": {
    "type": "object",
    "$schema": "https://json-schema.org/draft/2020-12/schema",
    "properties": {}
  },
  "annotations": {
    "readOnlyHint": true,
    "destructiveHint": false
  }
}

get_openapi_specTitles 97Descriptions 77Inputs 0Annotations 50Outputs 051/100

get_openapi_spec

Title97/100

Get OpenAPI Spec

The title clearly communicates the tool’s action and subject. Keep it concise.

Description77/100

Return the OpenAPI spec for a specific API endpoint URL. Optionally filter code samples by language, or return only code samples.

Describe the returned information so the agent knows whether it will answer the request.

Inputs0/100

0 of 3 inputs have descriptions. Add descriptions to the missing inputs, including where to obtain IDs and how to supply values.

url

Not provided

Missing description. Explain what this value means and how to supply it.

languages

Not provided

Missing description. Explain what this value means and how to supply it.

codeExamplesOnly

Not provided

Missing description. Explain what this value means and how to supply it.

Annotations50/100

Declare idempotentHint, openWorldHint based on the tool’s actual behavior.

{
  "readOnlyHint": true,
  "destructiveHint": false
}

Output schema0/100

No output schema is declared. Add one for structured results so clients can interpret returned fields.

Not declared

Original tool metadata

{
  "name": "get_openapi_spec",
  "title": "Get OpenAPI Spec",
  "description": "Return the OpenAPI spec for a specific API endpoint URL. Optionally filter code samples by language, or return only code samples.",
  "inputSchema": {
    "type": "object",
    "$schema": "https://json-schema.org/draft/2020-12/schema",
    "required": [
      "url"
    ],
    "properties": {
      "url": {
        "type": "string",
        "minLength": 1
      },
      "languages": {
        "type": "array",
        "items": {
          "type": "string",
          "minLength": 1
        }
      },
      "codeExamplesOnly": {
        "type": "boolean"
      }
    }
  },
  "annotations": {
    "readOnlyHint": true,
    "destructiveHint": false
  }
}

Put your MCP to the test

A few tasks worth trying with this server, chosen from its reviewed tools. These have not been run.

01Search OpenAI DocsSearch across `platform.openai.com`, `developers.openai.com`, and `learn.chatgpt.com` docs.
02Fetch OpenAI DocFetch 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, u…
03List OpenAI DocsList 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 rig…
04List API EndpointsList all OpenAI API endpoint URLs available in the OpenAPI spec.
05Get OpenAPI SpecReturn the OpenAPI spec for a specific API endpoint URL.

Want to run these tasks against your MCP server with us?

Test your MCP in Cloud Book a test call

Overview

Category: Developer tools

FAQ

openai-docs-mcp setup, tools, quality score, publishing readiness, and alternatives.

How do I add openai-docs-mcp to Claude, ChatGPT, or Cursor?

Add openai-docs-mcp to Claude, ChatGPT, or Cursor by connecting its remote MCP URL in each client's MCP settings. In Claude, add a custom connector. In ChatGPT, add an MCP app. In Cursor, add an MCP server under Settings. The MCP URL is https://developers.openai.com/mcp.

Is openai-docs-mcp MCP ready for ChatGPT and Claude?

As of November 13, 2026, openai-docs-mcp scores 94/100 on Manufact's MCP publishing checklist. The scan does not yet meet ChatGPT publishing checks and meets Claude publishing checks. Passing these checks does not guarantee marketplace approval.

How clear is openai-docs-mcp's MCP tool documentation?

As of November 13, 2026, openai-docs-mcp scores 60/100 in Manufact's review of tool titles, descriptions, input and output schemas, and behavior annotations. The review covers 5 of 5 discovered tools. The quality score measures documentation clarity; runtime behavior and marketplace readiness require separate checks.

What are the best alternatives to openai-docs-mcp?

As of November 14, 2026, alternatives to openai-docs-mcp in developer-tools on the Manufact MCP leaderboard include Speko, Manufact, AgentMail, Context, and Speko.

How can openai-docs-mcp improve its MCP documentation?

get_openapi_spec is the lowest-scoring reviewed tool at 51/100. 0 of 3 inputs have descriptions. Add descriptions to the missing inputs, including where to obtain IDs and how to supply values. Open its review for feedback and a copyable fix prompt, then rerun the documentation review after updating your tool metadata.

Not your MCP?

Review any public or OAuth MCP server for protocol compatibility, tool documentation, and ChatGPT and Claude publishing readiness. No account required.

Get your MCP score

LeaderboardBack to leaderboardLeaderboardBack to leaderboard

Opening report…

Loading report overview

Server metadata

Loading server metadata

Discoverability

Loading discoverability

Protocol

Loading protocol

Tools

Loading tools

MCP Apps

Loading mcp apps

Tool documentation quality

Loading tool documentation quality

Title99/100

Search OpenAI Docs

The title clearly communicates the tool’s action and subject. Keep it concise.

Description95/100

The description explains the capability, when to use it, and what to expect.

Inputs0/100

0 of 3 inputs have descriptions. Add descriptions to the missing inputs, including where to obtain IDs and how to supply values.

query

Not provided

Missing description. Explain what this value means and how to supply it.

limit

Not provided

Missing description. Explain what this value means and how to supply it.

cursor

Not provided

Missing description. Explain what this value means and how to supply it.

Annotations50/100

Declare idempotentHint, openWorldHint based on the tool’s actual behavior.

{
  "readOnlyHint": true,
  "destructiveHint": false
}

Output schema0/100

No output schema is declared. Add one for structured results so clients can interpret returned fields.

Not declared

Original tool metadata

{
  "name": "search_openai_docs",
  "title": "Search OpenAI Docs",
  "description": "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.",
  "inputSchema": {
    "type": "object",
    "$schema": "https://json-schema.org/draft/2020-12/schema",
    "required": [
      "query"
    ],
    "properties": {
      "limit": {
        "type": "integer",
        "maximum": 50,
        "minimum": 1
      },
      "query": {
        "type": "string",
        "minLength": 1
      },
      "cursor": {
        "type": "string"
      }
    }
  },
  "annotations": {
    "readOnlyHint": true,
    "destructiveHint": false
  }
}

Manufact

Server metadata

Discoverability

Protocol

Tools

MCP Apps

Tool docsTool documentation quality

Title99/100

Description95/100

Inputs0/100

Annotations50/100

Output schema0/100

Title99/100

Description96/100

Inputs0/100

Annotations50/100

Output schema0/100

Title99/100

Description92/100

Inputs0/100

Annotations50/100

Output schema0/100

Title98/100

Description75/100

Inputs100/100

Annotations50/100

Output schema0/100

Title97/100

Description77/100

Inputs0/100

Annotations50/100

Output schema0/100

Put your MCP to the test

Overview

Related MCP servers

FAQ

Not your MCP?

Server metadata

Discoverability

Protocol

Tools

MCP Apps

Tool documentation quality

Server metadata

Discoverability

Protocol

Tools

MCP Apps

Tool docsTool documentation quality

Title99/100

Description95/100

Inputs0/100

Annotations50/100

Output schema0/100

Title99/100

Description96/100

Inputs0/100

Annotations50/100

Output schema0/100

Title99/100

Description92/100

Inputs0/100

Annotations50/100

Output schema0/100

Title98/100

Description75/100

Inputs100/100

Annotations50/100

Output schema0/100

Title97/100

Description77/100

Inputs0/100

Annotations50/100

Output schema0/100

Put your MCP to the test

Overview

Related MCP servers

FAQ

Not your MCP?

Tool documentation quality

Tool documentation quality