# gomddoc

> gomddoc is a freemium MCP server for developer tools. Serve a Markdown folder as a docs site and a read-only MCP server for AI agents. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Platforms:** CLI, Linux, macOS, self-hosted
- **Website:** https://gomddoc.com
- **Repository:** https://github.com/monolithiclab/gomddoc
- **MCP Registry name:** io.github.monolithiclab/gomddoc
- **Categories:** developer tools, files and documents
- **Listing updated:** 2026-11-14

## About

Point the binary at a folder or a Git URL and it renders a themed, searchable site for readers. Ask the same URL with an Accept: text/markdown header and you get the page source back with generated frontmatter listing its metadata, related pages and navigation neighbours, so a model needs no HTML stripping. The MCP side is read-only and gives agents six capabilities: search the docs, read a page, read a single section, list pages, walk the table of contents and find related pages.

Over stdio it runs as `gomddoc mcp ./docs`, and the registry entry runs it from a container image. A running `gomddoc serve` exposes the same tools over HTTP at /_mcp/, behind the same authentication as the site. Git URLs can pin a branch and subdirectory, so an agent can be handed the docs of a project you never cloned.

The README describes a pre-1.0 Go server and static-site generator with llms.txt, a sitemap, Atom feed, Prometheus metrics and a path jail. It is released under the PolyForm Noncommercial License: free for open source, personal, non-profit and education use, with a commercial licence at 490 euros a year per production deployment.

## Features

- **Markdown content negotiation:** Requesting text/markdown returns the page source with generated frontmatter.
- **Six read-only tools:** Agents can search, read pages and sections, list pages, browse the table of contents and find related pages.
- **Serve any Git repository:** Git URLs can pin a branch and subdirectory and are cloned shallowly into memory.
- **Folder-driven navigation:** The sidebar is built from the directory tree with no routing table.
- **Static build option:** gomddoc build writes a site with sitemap, feed, tag pages and a 404 page.
- **Review annotations:** Notes on selected passages are collected as Markdown that names the source file.
- **Operations basics:** Includes Prometheus metrics, health probes, gzip, ETags and graceful shutdown.

## Good for

- Give a coding agent searchable access to a project's docs
- Publish a folder of Markdown as a readable docs site
- Hand an agent the docs of a repo you have not cloned
- Feed an llms.txt-indexed site to AI crawlers
- Review an agent-written draft by pasting back margin notes

## Install

### Claude Code (Terminal)

```sh
claude mcp add gomddoc -- docker run -i --rm ghcr.io/monolithiclab/gomddoc:0.5.1
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "gomddoc": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/monolithiclab/gomddoc:0.5.1"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "gomddoc": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/monolithiclab/gomddoc:0.5.1"
      ]
    }
  }
}
```

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

```json
{
  "servers": {
    "gomddoc": {
      "type": "stdio",
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/monolithiclab/gomddoc:0.5.1"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "gomddoc": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/monolithiclab/gomddoc:0.5.1"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "gomddoc": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/monolithiclab/gomddoc:0.5.1"
      ]
    }
  }
}
```

## FAQ

### Can the agent edit my docs?

No. The MCP tools are read-only.

### How is it installed?

Through Homebrew, an install script, go install or a Docker image on GitHub Container Registry.

### Is it free?

It is free for open-source, personal, non-profit and education use. Company use, including internal documentation, needs a commercial licence at 490 euros a year per production deployment.

### Does it work over HTTP as well as stdio?

Yes. gomddoc serve exposes the same tools at /_mcp/, behind the site's own authentication.

### Is gomddoc free?

gomddoc has a free plan, with paid plans for more usage or features.

### How do I add gomddoc to Claude Code?

Run this command in your terminal: claude mcp add gomddoc -- docker run -i --rm ghcr.io/monolithiclab/gomddoc:0.5.1

### What are the best alternatives to gomddoc?

The closest alternatives to gomddoc 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/gomddoc
