Log inSubmit server
Agentdocs MCP logo

Agentdocs MCP

Connects AI agents to AgentDocs for searching, editing, discussing, sharing, and organizing Markdown documentation.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install Agentdocs MCP

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "agentdocs-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "agentdocs-mcp"
      ],
      "env": {
        "AGENTDOCS_TOKEN": "YOUR_VALUE_HERE"
      }
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Values are written into the snippet above so you can paste it as is. They never leave your browser.

Install not yet sandbox-tested— the server itself is confirmed live (we called its tools/list endpoint). The stdio install command is a separate, ongoing check.

Overview

agentdocs-mcp connects AI clients to AgentDocs, exposing tools for navigating workspaces and spaces, reading and searching Markdown pages, and managing page content. It supports local stdio execution with an API token and can also be used through AgentDocs' hosted Streamable HTTP endpoint with OAuth or token authentication. Reach for it when an agent needs to maintain collaborative documentation, import a Markdown knowledge base, work with comments, or attach screenshots and diagrams.

Use cases

  • Search internal documentation with natural-language questions
  • Import an Obsidian vault or repository docs into a page hierarchy
  • Maintain running logs and reports with appended Markdown
  • Review documentation discussions and resolve comment threads
  • Publish a page through a public or raw-Markdown link

Key features

  • AgentDocs workspace and page navigation
  • Keyword and semantic document search
  • Version-aware Markdown editing
  • Idempotent Markdown-folder imports
  • Threaded comments and page discussions
  • Image uploads and embedded image retrieval

Tools19

What Agentdocs MCP lets your agent do. Expand a tool for its parameters.

Verified live~3.4k tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked Today

Recent health check succeeded.

12/12 checks healthy over the last 57d

What it can do

From the 19 tools this server returned when we ran it; 19 declare their own safety hints.

Can delete or modify data · 4Handles credentials · 6Makes network requests · 3Read-only tools · 15
Network at startup3 connections
Files written at startupNone
Install scriptsNone
npm provenanceNot published
Package age142 days
Maintainers1

Observed 2026-10-30 in an isolated sandbox. A description of reach, not a security audit.

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 16d ago via OSV.dev · agentdocs-mcp (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars1Stargazers on the source repository.
npm downloads1.3kPackage downloads in the last 30 days.
Last commitTodayMost recent push to the default branch.
Tools exposed19Callable tools this server registers over MCP.

How Agentdocs MCP works

What agentdocs-mcp does

agentdocs-mcp gives MCP-compatible clients access to AgentDocs workspaces, spaces, pages, comments, and images. Agents can inspect their identity and credential scope, enumerate documentation structures, search page content, read Markdown, and create or revise pages.

The server supports both documentation maintenance and knowledge retrieval. Keyword search covers workspace pages, while semantic search accepts natural-language questions and ranks pages by meaning in Pro workspaces. Page reads can include threaded discussions, child-page metadata, and embedded images as viewable blocks.

Write operations cover individual pages, appended notes, bulk page creation, and Markdown-folder imports. Imports derive hierarchy from relative file paths and can be repeated without creating duplicates because pages are matched by source path.

How it works

The package runs locally over stdio and communicates with AgentDocs using an API token. An account token provides access to resources the user owns. A space token restricts the session to one space and applies the permissions selected for that token, making it suitable for sandboxed agents.

The hosted endpoint is available at https://agentdocs.eu/mcp over Streamable HTTP. Clients that support OAuth can open an AgentDocs sign-in and consent flow; token-based clients can send either Authorization: Token <token> or Authorization: Bearer <token>.

Call whoami first to determine the authenticated identity and whether the credential is space-scoped. For concurrent page editing, update_page accepts an expected version so an agent can fail rather than overwrite a newer revision. Deleting a page also removes its child pages and cannot be undone through the API.

Setup and configuration

For a local installation, launch the package with an MCP client using npx -y agentdocs-mcp and provide AGENTDOCS_TOKEN. The token may instead be read from ~/.config/agentdocs/token. Account and space tokens are supported; the local package does not provide proposed-change tools, so agents requiring that workflow should use the hosted endpoint.

AGENTDOCS_URL defaults to https://agentdocs.eu and can override the API base URL when a different endpoint has been provided. Hosted use requires no package installation: add the endpoint as a custom MCP server and authenticate through OAuth or a token.

Tools and capabilities

  • Discover accessible workspaces, spaces, and page trees.
  • Search by keyword or natural-language meaning.
  • Read Markdown with versions, comments, child pages, and embedded images.
  • Create, update, append to, and permanently delete pages.
  • Import up to 500 Markdown files per call or atomically create up to 500 explicit pages.
  • Add, edit, resolve, list, and delete threaded comments.
  • Upload PNG, JPEG, GIF, or WebP images up to 5 MB and receive Markdown for embedding.
  • Create public magic links with web and raw-Markdown URLs.

Semantic search requires a Pro workspace. Image uploads count against workspace image storage, with quotas of 50 MB for Free and 5 GB for Pro workspaces.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Agentdocs MCP

agentdocs-mcp is an MCP server that connects AI clients to AgentDocs, a collaborative Markdown documentation platform. Its main tools identify credentials, browse workspaces and spaces, search pages, read and edit Markdown, manage comments, import documentation, share pages, and upload images for embedding.

Install it by configuring your MCP client to run `npx -y agentdocs-mcp` and supplying `AGENTDOCS_TOKEN`. The package runs locally over stdio, and the token can also be read from `~/.config/agentdocs/token`.

Yes. Add `https://agentdocs.eu/mcp` as a custom Streamable HTTP MCP server and authenticate with OAuth or an AgentDocs token. This hosted option avoids a local package and supports clients that can connect to remote MCP endpoints.

Yes, `semantic_search` accepts a natural-language question and ranks relevant pages by meaning. It requires a Pro workspace; when semantic search is not configured, the response can fall back to full-text results.

Use a space-scoped AgentDocs token. The server detects the token scope and confines access to that space, which can be assigned read-only, propose-edit, or direct-edit permissions. The local package has no proposal tools.

Related MCP servers

All in Knowledge & Memory All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewAgentdocs MCP AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/agentdocs-mcp?style=directory)](https://allmcps.com/mcp/agentdocs-mcp)
HTML Embed
<a href="https://allmcps.com/mcp/agentdocs-mcp"><img src="https://allmcps.com/api/badge/agentdocs-mcp?style=directory" alt="Agentdocs MCP on AllMCPs" /></a>