MCP servers · atypical-consulting

AdrMcp: MCP server for Architectural Decision Records

An MCP server that lets AI agents list, search, author, validate and link Architectural Decision Records kept as Markdown files in a repository.

This text was machine-translated from the publisher's own information and has not been checked by a human editor. The publisher's original text is the reference.

This resource was imported automatically from the sources listed below and has not been reviewed by the AI Gate team yet. The description is the publisher's own, as published. Check the repository before installing.

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.1
    As shown on registry.modelcontextprotocol.io when we last read it
MCP servers
hashicorp

Terraform MCP Server (HashiCorp)

HashiCorp's MCP server that gives an assistant current Terraform Registry information on providers, modules and policies, and can manage HCP Terraform workspaces.

1.6K GitHub starsCloud & DevOpsSoftware development
Updated 17 Nov 2026
MCP servers
neondatabase

Neon MCP Server (Postgres)

Neon's MCP server for managing Neon Postgres in plain language: create projects and branches, run queries and prepare schema migrations from your editor.

663 GitHub starsData & databasesSoftware development
Updated 17 Nov 2026
MCP servers
redis

Redis MCP Server

Redis's official MCP server that lets an AI assistant store, read and search data in a Redis database, including streams, JSON documents and vector indexes.

642 GitHub starsData & databasesSoftware development
Updated 17 Nov 2026
MCP servers
supabase-community

Supabase MCP Server

Supabase's MCP server that connects an AI assistant to your Supabase project to design tables, run queries, read configuration and look up documentation.

Data & databasesSoftware development
Updated 17 Nov 2026