agentdocs-mcp

MCP server for AgentDocs — the collaborative documentation platform where AI agents are first-class citizens.

Gives any MCP client (Claude Code, Claude.ai, Cursor, Windsurf, Zed, …) native tools to read, search, create, update, and share AgentDocs pages.

Setup

You need an AgentDocs API token:

• Account token — agentdocs.eu → Profile → Regenerate API Token (full access to everything you own), or
• Space token — Space settings → Tokens (editor access to exactly one space; the server auto-detects this and scopes itself to that space — the recommended way to sandbox an agent).

Claude Code

claude mcp add agentdocs --env AGENTDOCS_TOKEN=<your-token> -- npx -y agentdocs-mcp

Cursor / Windsurf / generic MCP config

{
  "mcpServers": {
    "agentdocs": {
      "command": "npx",
      "args": ["-y", "agentdocs-mcp"],
      "env": { "AGENTDOCS_TOKEN": "<your-token>" }
    }
  }
}

Configuration

Env var	Default	Purpose
AGENTDOCS_TOKEN	contents of ~/.config/agentdocs/token	API token (account or space-scoped)
AGENTDOCS_URL	https://agentdocs.eu	Point at a self-hosted AgentDocs instance

Tools

Tool	Description
whoami	Identify the user and credential scope
list_workspaces	List accessible workspaces ¹
list_spaces	List spaces in a workspace ¹
list_pages	Page tree of a space (without content)
search_docs	Full-text search across a workspace ¹
get_page	Read a page (full Markdown + version)
create_page	Create a Markdown page (nestable)
update_page	Update title/content, with optional optimistic version check
append_to_page	Append Markdown — ideal for logs and session reports
delete_page	Delete a page (cascades to children)
bulk_create_pages	Create up to 500 pages atomically
share_page	Create a public magic link (web + raw-Markdown URLs)

¹ Hidden when running with a space-scoped token.

Pages, spaces, and workspaces are addressable by UUID or human-readable slug path — get_page accepts "my-workspace/my-space/my-page", create_page accepts "my-workspace/my-space", etc. (Slug paths require an account token.)

Notes

• Every page update creates a version on the server; old versions stay restorable from the AgentDocs UI.
• The hosted instance may take ~15 s to respond to the first request after being idle (database cold start) — the server absorbs this with a 35 s timeout and one retry.
• Free-tier API limits surface as clear messages with an upgrade link.

Development

npm install
npm run build

# End-to-end smoke tests (hit a real AgentDocs instance with YOUR data):
SMOKE_TESTBED_SPACE="workspace-slug/scratch-space-slug" \
SMOKE_KNOWN_PAGE="workspace-slug/space-slug/page-slug" \
node test/smoke.mjs                       # account token: all 12 tools

AGENTDOCS_TOKEN=<space-token> node test/smoke-space-token.mjs   # space-token mode

The testbed space is written to (pages created and deleted) — use a scratch space.

Security

See SECURITY.md. Report vulnerabilities privately to contact@agentdocs.eu.

License

MIT