Works with 16 coding agents
Docs that coding agents
write and read
Your coding agent writes the docs in GitHub, and each push publishes your docs site. Every public docs site has an MCP server that agents read without sign-in.
- Publishes from GitHub on every push
- Works with Mintlify repositories
- API console from your OpenAPI file
- MCP server and llms.txt for AI agents
- Ask AI and support tickets
- Analytics for people and AI agents
Choose your coding agent
Pick your coding agent for its setup steps. Each agent can write your docs, read docs sites and manage your Revdoku account.
Write the docs with any coding agent
Revdoku publishes a docs site from a GitHub repository: Markdown and MDX pages, docs.json navigation and an OpenAPI file. A Mintlify repository works as it is. A coding agent changes these files like other code, so this part needs no MCP setup.
- Create a Revdoku account and connect the GitHub repository of your docs.
- Ask your agent to change the pages,
docs.jsonor the OpenAPI file. - Push the change to a new branch. Revdoku builds a preview site of that branch for 24 hours, and the commit on GitHub links to it.
- Merge the branch into the connected branch. Revdoku publishes the site again.
Codex, Cursor and GitHub Copilot read AGENTS.md, and Claude Code reads CLAUDE.md. Put the rules for your docs in that file. The example rules show where the docs live and how to preview a change.
Set up Revdoku in your coding agent
A coding agent connects to Revdoku through MCP (a standard way for AI apps to use outside tools). There are two servers. Only the place where you add a server is different in each agent.
| Server | Address | Sign-in | What the agent can do |
|---|---|---|---|
| Docs server | The address of a public docs site with /mcp at the end, for example https://docs.example.com/mcp | None | Search the docs, read a page as Markdown and list all pages, with the tools search_docs, read_page and list_pages. |
| Account server | https://mcp.revdoku.com | In your browser | Work with your buckets: publish and preview sites, read files and read support tickets. |
A bucket holds the files of one docs site, the site and its support tickets. Add the docs server of your own site, or of an API that publishes its docs with Revdoku.
- Find your agent in the list that follows. Claude Code, Codex, Cursor and GitHub Copilot have their own setup pages.
- Add the docs server, the account server or both. Name the docs server after the docs, for example
acme-docs. - Ask your agent:
Use acme-docs. How do I authenticate to the Acme API?For the account server, ask:List my Revdoku buckets.
Amp
- To add the docs site, run this command in your terminal:
amp mcp add acme-docs https://docs.example.com/mcp - To add your account, run
amp mcp add revdoku https://mcp.revdoku.comStart Amp. It opens the Revdoku sign-in page in your browser.
Google Antigravity
- In the agent side panel of the editor, click … → MCP Servers → Manage MCP Servers → View raw config. Add the docs site:
{ "mcpServers": { "acme-docs": { "serverUrl": "https://docs.example.com/mcp" } } } - To add your account, add
"revdoku": { "serverUrl": "https://mcp.revdoku.com" }tomcpServers. Antigravity starts the OAuth sign-in. - In the Antigravity App, sign in from Customizations → Installed. Under MCP Servers, click Authenticate next to
revdoku. Paste the code from the browser into Enter authorization code and click Submit.
Augment Code
- Open the options menu in the upper right of the Augment panel and click Settings.
- In the MCP section, click + Add remote MCP. Choose HTTP, name the server
acme-docsand paste the docs URL:https://docs.example.com/mcp - To manage your account, install the Revdoku skill. With the skill, Augment can run the Revdoku CLI:
npx skills add revdoku/revdoku --skill revdoku -g --agent augment
Augment Code MCP documentation
Cline
- In the Cline panel, click the MCP Servers icon and open the Remote Servers tab.
- Enter
acme-docsas the Server Name and the docs URL as the Server URL. Choose Streamable HTTP and click Add Server. - To add the docs site from the Cline CLI, run:
cline mcp add acme-docs https://docs.example.com/mcp --transport http --yes - To add your account, add
https://mcp.revdoku.comasrevdokuin the same way. To sign in from the terminal, runcline mcpand choose Authorize OAuth.
Devin
- Open Customize → MCPs. Click Add MCP and choose Add custom MCP.
- Choose HTTP and paste the docs URL:
https://docs.example.com/mcpFor authentication, choose None. Save, then click Test tools. - To add your account, add
https://mcp.revdoku.comwith OAuth. Save, then click Connect in Customize → MCPs and sign in to Revdoku.
Goose
- Run
goose configureand choose Add Extension. Choose Remote Extension (Streamable HTTP). When Goose asks for the address, give the docs URL:https://docs.example.com/mcp - In Goose Desktop, click Extensions in the sidebar, then Add custom extension. Enter the same details.
- To add your account, add
https://mcp.revdoku.comin the same way. Goose supports OAuth for remote extensions. Finish the Revdoku sign-in in your browser.
Goose extensions documentation
Kilo Code
- Open Settings → MCP. Click Add Server and choose Remote (HTTP).
- Enter the docs URL:
https://docs.example.com/mcp - To add your account, add
https://mcp.revdoku.comin the same way. Kilo Code starts the sign-in when it connects. If it shows a notification, click it and sign in to Revdoku.
Kiro
- Add the docs site to
~/.kiro/settings/mcp.json, or to.kiro/settings/mcp.jsonfor one workspace:{ "mcpServers": { "acme-docs": { "url": "https://docs.example.com/mcp" } } } - To add your account, add
"revdoku": { "url": "https://mcp.revdoku.com" }tomcpServers. Kiro opens the Revdoku sign-in page when it connects.
OpenCode
- In your project, run this command to add the docs site:
opencode mcp add acme-docs --url https://docs.example.com/mcpAdd--globalto use it in every project. - To add your account, run
opencode mcp add revdoku --url https://mcp.revdoku.com - Run this command, then sign in to Revdoku in your browser:
opencode mcp auth revdoku
OpenHands
- Open Customize → MCP Servers and click Add custom server.
- Choose SHTTP and paste the docs URL:
https://docs.example.com/mcpFor authentication, choose None. Save, then click Test connection. - To add your account, add
https://mcp.revdoku.comwith OAuth. A browser window opens. Sign in to Revdoku there.
Pi
- Pi has MCP built in. Run this command to add the docs site:
pi mcp add acme-docs --url https://docs.example.com/mcp - To add your account, run
pi mcp add revdoku --url https://mcp.revdoku.comThen sign in:pi mcp login revdoku - You can use the Revdoku skill for your account instead. Put it in a folder that Pi reads, such as
~/.agents/skills/.
Zed
- Open Settings → AI → MCP Servers. Click Add Server, then Add Remote Server. Or add the docs site to your Zed settings:
{ "context_servers": { "acme-docs": { "url": "https://docs.example.com/mcp" } } } - To add your account, add
"revdoku": { "url": "https://mcp.revdoku.com" }tocontext_servers. Zed asks you to sign in with the standard MCP OAuth flow.
Docs for AI agents · Revdoku MCP guide · Revdoku skill · Revdoku CLI