# Doc Bridge

> Doc Bridge is an open-source MCP server for developer tools. Citation-backed documentation answers and drift checks for coding agents. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, self-hosted
- **Website:** https://doc-bridge.agentskit.io
- **Repository:** https://github.com/agentskit-io/doc-bridge
- **MCP Registry name:** io.github.AgentsKit-io/doc-bridge
- **Categories:** developer tools
- **Listing updated:** 2026-11-15

## About

Before an agent edits code, doc-bridge tells it where to start reading, which files or packages it may edit, which checks prove the change, and which human guide explains the feature. That routing contract is returned as a small handoff object rather than a pile of loose files.

It indexes Fumadocs, Docusaurus and plain Markdown, and answers questions from the command line (`ak-docs`) or over MCP with path:line citations. It also records what each doc references, so when the referenced code changes it reports the exact doc line that went stale. An opt-in gate can hold back the index and llms.txt until those findings are fixed.

The README says the core runs without any LLM or API key. It also reads agent memory files and drafts a human-reviewed promotion into project docs. Its published numbers are labelled as historical or directional, such as 88.3% hit@3 on a retrieval benchmark.

## Features

- **Cited answers:** Each answer names the file and line it came from.
- **Agent handoffs:** Returns start-here doc, edit roots, checks and the human doc.
- **Drift findings:** Flags the doc line when the code it references changes.
- **Publication gate:** Optionally blocks index and llms.txt output until findings are fixed.
- **Memory promotion:** Classifies agent memory notes and drafts a reviewed docs change.
- **No LLM required:** The deterministic core needs no model or API key.

## Good for

- Stop coding agents editing the wrong package
- Catch stale guides after an API signature changes
- Give agents path:line citations from repo docs
- Fail CI when cited documentation is out of date
- Turn agent memory notes into reviewed docs

## Install

### Claude Code (Terminal)

```sh
claude mcp add doc-bridge -- npx -y @agentskit/doc-bridge
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "doc-bridge": {
      "command": "npx",
      "args": [
        "-y",
        "@agentskit/doc-bridge"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "doc-bridge": {
      "command": "npx",
      "args": [
        "-y",
        "@agentskit/doc-bridge"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "doc-bridge": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@agentskit/doc-bridge"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "doc-bridge": {
      "command": "npx",
      "args": [
        "-y",
        "@agentskit/doc-bridge"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "doc-bridge": {
      "command": "npx",
      "args": [
        "-y",
        "@agentskit/doc-bridge"
      ]
    }
  }
}
```

## FAQ

### How do I run it?

It is an npm package, @agentskit/doc-bridge, with the CLI ak-docs and an MCP server over stdio.

### Does it need an LLM key?

No. The README says the core works without any LLM or API key.

### Which doc formats does it read?

Fumadocs, Docusaurus and plain Markdown, plus ownership docs.

### Does the gate always block publishing?

No. It is opt-in; with it off, findings stay advisory.

### Is Doc Bridge free?

Yes. Doc Bridge is open source, so you can use and self-host it for free.

### How do I add Doc Bridge to Claude Code?

Run this command in your terminal: claude mcp add doc-bridge -- npx -y @agentskit/doc-bridge

### What are the best alternatives to Doc Bridge?

The closest alternatives to Doc Bridge are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/doc-bridge
