gomddoc
Serve a Markdown folder as a docs site and a read-only MCP server for AI agents
- Pricing
- Freemium
- Platforms
- CLI, Linux, macOS
- Runs
- Locally
- Version
- 0.5.1
- Listing updated
- 3 days ago
About gomddoc
gomddoc is a freemium MCP server for developer tools. It runs locally on your machine and is started by your AI client.
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.
Install
Run in a terminal
claude mcp add gomddoc -- docker run -i --rm ghcr.io/monolithiclab/gomddoc:0.5.1Add to claude_desktop_config.json
{
"mcpServers": {
"gomddoc": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/monolithiclab/gomddoc:0.5.1"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"gomddoc": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/monolithiclab/gomddoc:0.5.1"
]
}
}
}Add to .vscode/mcp.json
{
"servers": {
"gomddoc": {
"type": "stdio",
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/monolithiclab/gomddoc:0.5.1"
]
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"gomddoc": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/monolithiclab/gomddoc:0.5.1"
]
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"gomddoc": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/monolithiclab/gomddoc:0.5.1"
]
}
}
}What it does
- 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
Pricing
Freemium
Free for open source, personal, non-profit and education; commercial licence 490 euros a year per production deployment, excluding VAT
Prices change. Check gomddoc.com before you buy.
gomddoc 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 to gomddoc

REA
MCP serverCLI and MCP server that lets coding agents reverse engineer apps and binaries
Runs locally- Open source
- 464K GitHub stars
- Developer tools

Codebase Memory
MCP serverLocal MCP server that builds a code knowledge graph for AI coding agents
Runs locally- Open source
- 48.7K GitHub stars
- Knowledge and memory

GitHub
MCP serverOfficial MCP server connecting AI assistants to GitHub repos, issues and workflows
Not checked yet- Remote
- Open source
- 34.5K GitHub stars
- Developer tools

Serena MCP: the IDE for your agent
MCP serverMCP toolkit giving coding agents symbol-level code retrieval and editing
Runs locally- Open source
- 31.5K GitHub stars
- Developer tools

XERJ
MCP serverLocal search engine for AI agents with cited answers over your code and docs
Runs locally- Open source
- 19.2K GitHub stars
- Knowledge and memory

Ouroboros
MCP serverSpec-first layer that pins requirements and verifies results of AI coding agent work
Runs locally- Open source
- 6.4K GitHub stars
- Developer tools