Package Exports

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (agentdocs-mcp) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

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.

License

MIT