Redocly MCP server
Commit Nov 14, 2026Allows AI agents to search and read Redocly documentation, execute Redocly CLI commands, and report documentation errors.
Also known as Redocly/redocly-plugin, redocly-plugin
- Stars
- 1
- Tools
- —
- Downloads, 30 days
- —
- Latest version
- 1.0.1
- Last commit
- Nov 14, 2026
- License
- MIT
What is Redocly MCP?
Redocly allows AI agents to search and read Redocly documentation, execute Redocly CLI commands, and report documentation errors.
Summary generated from the project's README
About Redocly MCP server
Developers using Claude Code, Codex, or Cursor can give their AI agents direct access to Redocly documentation and command-line tools. By adding the Redocly MCP server via Streamable HTTP or the MCP Registry, your agent gains the ability to search documentation, read specific pages, and report errors back to the Redocly team. This setup allows an AI to act as a specialized assistant for managing API documentation and configuration.
The plugin provides specific skills that trigger when an agent identifies a relevant task. These include executing Redocly CLI commands, managing redocly.yaml configurations, creating custom lint rules, and performing Markdown linting with the redocly recheck command. It also assists with setting up Redocly docs projects, including pages and API reference documentation. The plugin itself does not run code on your machine; instead, it instructs the agent to run the necessary CLI commands locally.
What you can do with it
- 1Lint OpenAPI descriptionsAsk the agent to use the Redocly CLI to check an OpenAPI description for errors and explain the findings.
- 2Create custom linting rulesInstruct the agent to write a specific Redocly lint rule, such as requiring an operationId for every operation.
- 3Initialize documentation sitesHave the agent configure a new Redocly docs site based on an existing OpenAPI description.
- 4Report documentation inaccuraciesUse the agent to notify the Redocly team when it encounters a wrong or incomplete documentation page.
Written from the project's README. Every use case is checked against a quote from it.
How to install Redocly MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall Redocly MCP in Claude Code
$ claude mcp add --transport http redocly-plugin https://redocly.com/mcpInstall Redocly MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"redocly-plugin": {
"url": "https://redocly.com/mcp"
}
}
}Install Redocly MCP in VS Code
.vscode/mcp.json
{
"servers": {
"redocly-plugin": {
"type": "http",
"url": "https://redocly.com/mcp"
}
}
}Install Redocly MCP in VS Code CLI
$ code --add-mcp '{"name":"redocly-plugin","type":"http","url":"https://redocly.com/mcp"}'Install Redocly MCP in Codex
$ codex mcp add redocly-plugin --url https://redocly.com/mcpInstall Redocly MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.redocly-plugin] url = "https://redocly.com/mcp"
Install Redocly MCP in Gemini CLI
$ gemini mcp add -s user --transport http redocly-plugin https://redocly.com/mcpInstall Redocly MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"redocly-plugin": {
"url": "https://redocly.com/mcp",
"type": "http"
}
}
}Automated checks
Ran Nov 14, 2026Full report →Not verified yet. A server needs a score of 80, no serious finding, and enough data for us to check. How checks work · What to fix for more points
- Source repository linked and reachableredocly/redocly-plugin is public and reachablegithub.com/redocly/redocly-plugin ↗Pass
- Package names this repository as its sourceNot checked
- Build provenance (Sigstore attestation)Not checked
- Open source license (OSI)MITspdx.org/licenses/MIT.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-11-13github.com/redocly/redocly-plugin ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNot checked
- No critical advisory in the package or its dependenciesNot checked
- No hidden instructions to the model0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNot checked
- Remote endpoint answers the MCP handshakeinitialize answered with protocol 2025-06-18 in 240 msPass
README
View on GitHubRedocly plugin
The Redocly plugin gives your AI coding agent the Redocly skills and live access to the Redocly documentation through the Redocly MCP server. It works in Claude Code, Codex and Cursor.
Install
Claude Code:
claude plugin marketplace add Redocly/redocly-plugin
claude plugin install redocly@redocly
Codex:
codex plugin marketplace add Redocly/redocly-plugin
codex plugin add redocly@redocly
Cursor: import this repository as a team marketplace (Teams and Enterprise plans), or copy plugins/redocly into ~/.cursor/plugins/local.
Skills only, in any client that reads Agent Skills:
npx skills add Redocly/redocly-plugin
MCP server only, in any MCP client: add https://redocly.com/mcp as a remote server over Streamable HTTP, or install com.redocly/mcp from the MCP Registry. The Redocly MCP server docs have the steps for each client.
What you get
- Skills that the agent loads when your request matches one: Redocly CLI commands,
redocly.yamlconfiguration, custom lint rules, Markdown linting withredocly recheck, and Redocly docs projects (setup, pages, and API reference docs). The Redocly skills index lists them. - The Redocly MCP server at
https://redocly.com/mcp. It searches and reads the current Redocly documentation, and it reports a wrong or incomplete page to the Redocly documentation team.
Example prompts:
- "Lint my OpenAPI description with Redocly CLI and explain each problem."
- "Write a Redocly lint rule that requires an operationId on every operation."
- "Set up a Redocly docs site for my OpenAPI description."
Data and privacy
The plugin itself runs no code on your machine: the skills are Markdown files, and the plugin adds only the Redocly MCP server. Some skills tell the agent to run Redocly CLI commands, which the agent runs like any other command. Redocly receives the tool calls that your agent sends, not your conversation, and keeps usage statistics such as the tool name, the duration, the name of your client and the plugin version. No tool changes your Redocly account or your projects. The Redocly Privacy Notice covers requests to the server.
Support
Open an issue for a problem with the plugin. We do not accept pull requests from outside Redocly. To report a security vulnerability, follow SECURITY.md. For anything else, contact Redocly.
License
Redocly MCP questions
How do I add Redocly MCP to Claude Code?
Run claude mcp add --transport http redocly-plugin https://redocly.com/mcp in your terminal. Add --scope user to make it available in every project.
How do I add Redocly MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
What can the Redocly MCP server do?
It searches and reads the current Redocly documentation and allows users to report wrong or incomplete pages to the documentation team.
Does the plugin run code on my machine?
No, the plugin itself runs no code on your machine; it only adds the Redocly MCP server and provides skills as Markdown files.
Does the server access my private conversations?
No, Redocly receives tool calls sent by your agent rather than your conversation content.
Can the tool change my Redocly account settings?
No, none of the tools have the ability to change your Redocly account or your projects.