What it does
AdrMcp exposes a folder of Markdown ADRs, by default under docs/adr/, as tools an MCP client can call. Read tools list and filter records, fetch one record or selected sections, search lexically or semantically, and produce a decision index and relationship graph. Write tools create records from a MADR or Nygard template, replace a single section, transition status under the ADR lifecycle, and supersede a decision while linking the old and new records. Validation covers structure, status, dangling links and duplicate ids. Conflict detection flags contradictory accepted decisions, stale-record detection flags records whose code references no longer resolve, and a coverage report shows gaps by architectural area. Every write tool previews a unified diff by default.
It suits teams whose architectural reasoning lives in chat threads and pull request comments, where it is easily lost, and who want an AI agent to read or update those decisions. Records remain plain Markdown in git, with no database, so changes can be reviewed like any other file change.
Running it requires the .NET SDK. It is distributed as a dotnet tool, a NuGet package and a Docker image, and is registered with an MCP client as a stdio server. The ADR root and repository root are set through command-line arguments or environment variables. Code-reference checks use a file-system provider that is language-agnostic, and other providers can be plugged in behind the same interface. Three bundled Claude Code skills, adr-author, adr-review and adr-supersede, add workflow guidance and activate when the server is available.
Limitations and requirements
Requires the .NET SDK. Write tools change files on disk only when previewOnly is set to false. The default code-reference check tests whether a file exists and whether a given symbol's text is present; deeper symbol resolution is left to the client. The bundled skills activate in Claude Code only when the AdrMcp server is connected.
Safety
Our team has not reviewed this resource. Only automated rules checked it; resources with high-risk signals are not published. These are signals, not a guarantee that installing it is safe. Try it in a sandbox project first.
- Runs code or changes an assistant's behaviour
Sources
- Official MCP Registry first seen 13 Nov 2026 · last seen 13 Nov 2026 · its page on the source
AdrMcp
MCP server for Architectural Decision Records: navigate, author, validate, link, and analyze them.
v0.2.1As shown on registry.modelcontextprotocol.io when we last read it