Skip to content
agentdocs
Start Free
For Windsurf users

Windsurf codes fast. AgentDoc keeps the docs alive.

Add the AgentDoc MCP server to Windsurf so Cascade can read, write, and publish docs alongside your code.

Paste in your terminal
npx -y @agentdoc/cli install windsurf
Prefer manual setup? Paste this into ~/.codeium/windsurf/mcp_config.json▾
~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "agentdoc": {
      "command": "npx",
      "args": ["-y", "@agentdoc/mcp"]
    }
  }
}

Restart Windsurf after the CLI runs so Cascade picks up the new MCP server.

Read the full guideSee a live AgentDoc

What Windsurf gains.

The MCP server adds primitives Windsurfdoesn't have on its own.

A real URL anyone can open

Publish to /@you/slug — a clean webpage that loads on any device without AgentDoc or Claude account.

Raw markdown endpoint for agents

/@you/slug.md serves the underlying markdown so every other agent can read the same doc.

Version history with attribution

Every edit is named — the agent, you, a teammate, another agent. See how a doc evolved and revert any version.

Private by default

Docs start private. Publish explicitly when ready; unpublish in one click and the URL stops working.

What Windsurf can do, once installed.

Just ask — no new tools to memorize.

  • “Publish this architecture doc as arch/event-pipeline.”
  • “Fetch the latest runbook AgentDoc and open it alongside the code.”
  • “Create an AgentDoc for the migration plan and invite the backend team.”

Frequently asked questions

Do I need an AgentDoc account before I install?
No. On first run the MCP server provisions an anonymous account via POST /v1/keys (the endpoint is public — no email, no OAuth) and caches the resulting key at ~/.agentdoc/mcp-key.json (mode 0600). Subsequent runs reuse the cached key. Claim the account with an email later when you want a username, a custom domain, or a shared workspace.
Does the person I send the link to need an AgentDoc account?
No. The published page at /@you/slug is a normal webpage. Anyone with the link can open it on any device — no Claude account, no AgentDoc account, no download.
What if I want the doc to stay private?
Every doc starts private by default. It only becomes a public webpage when the agent (or you) explicitly publishes it. You can also publish as 'unlisted' — the doc gets a URL with a secret token, but it isn't indexed or listed anywhere. Unpublish in one click and the URL stops working.
Does the agent count as a paid seat?
No. Agents are never seats. One human seat runs unlimited agents — Claude Code, Cursor, ChatGPT, Windsurf, anything MCP-capable.
I'm not technical — is there a way to install without the terminal?
Yes. Every agent has a "paste into the chat" version: copy the one-line prompt from the install block, paste it into your agent, and the agent reads https://agentdoc.com/install/<agent>.md and sets itself up. Works for Claude, ChatGPT, Cursor, and any agent that can read a URL.
What does this cost?
Free for individuals — unlimited private and public docs, 7-day version history, anonymous-key signup. $12/user/month for a shared workspace with unlimited history, custom domain, webhooks, and team collab. $24/user/month for SSO, audit log, and SLA support.

One line. Windsurf ships links.

No new app. No account ceremony. Just ask Windsurf to publish, and send the URL.

Paste in your terminal
npx -y @agentdoc/cli install windsurf
Other agentsSee pricing