AdrMcp

NUGET · ADRMCP · SCANNED SEP 20

MCP server for Architectural Decision Records: navigate, author, validate, link, and analyze them.

Available components

+1 this week 85 85 Trust /100

Trust breakdown (7 categories)

How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. How we score → Why this is hard to score →

Supply Chain Security100

No malware found by supply-chain analysis.Pass
No known CVEs affecting this package version or its production dependencies.Pass
No install/post-install scripts declared.Pass
No production dependencies, so there is no dependency health to assess. View diagnostics → Pass

Provenance & Transparency48

Source repository is publicly reachable at the declared URL. View diagnostics → Pass
Provenance check failed: no build-provenance attestation is published. See how to fix → View diagnostics → Fail
Clear OSI-approved license (MIT).Pass
Actively maintained (last published 72 days ago).Pass
Publishes a security disclosure policy (SECURITY.md).Pass

Schema Quality & AI Usability80

AI-judged instruction clarity (excellent).Pass
Tool/resource definitions use about 1385 tokens (~76/item across 18 items; 18 tools + 0 resources), lean.Pass
Usage-examples check failed: none of the tools include examples. See how to fix → Fail

Stability & Change Management90

Stability observed for 27 of 30 days with no destabilising changes; credit accrues until the full window elapses.Partial

Tool Coverage100

100% of tools have a non-trivial description (not blank, and not just the tool's name).Pass
100% of tool parameters carry a description.Pass

Tool Safety100

No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.Pass
We read all 18 captured tool definition(s), and no name or description among them implies an irreversible operation.Pass
An AI judge read all 18 captured unit(s) of tool text and found none that tries to manipulate the model reading it.Pass

Capabilities100

Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.Pass

Install

How do I install the AdrMcp MCP server?

AdrMcp runs locally as a NuGet package, launched with dnx AdrMcp@0.2.1 --yes. Ready-made configuration for Claude, Cursor, VS Code, Codex and 3 more is on this page, copied from each client's own documentation.

nuget · AdrMcp

Claude Cursor VS Code Codex opencode Hermes Netclaw Other

# add to Claude Code

claude mcp add atypical-consulting-adr-mcp -- dnx AdrMcp@0.2.1 --yes

// .cursor/mcp.json

{
  "mcpServers": {
    "atypical-consulting-adr-mcp": {
      "command": "dnx",
      "args": [
        "AdrMcp@0.2.1",
        "--yes"
      ]
    }
  }
}

// .vscode/mcp.json

{
  "servers": {
    "atypical-consulting-adr-mcp": {
      "command": "dnx",
      "args": [
        "AdrMcp@0.2.1",
        "--yes"
      ]
    }
  }
}

# add to Codex CLI

codex mcp add atypical-consulting-adr-mcp -- dnx AdrMcp@0.2.1 --yes

// opencode.json

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "atypical-consulting-adr-mcp": {
      "type": "local",
      "command": [
        "dnx",
        "AdrMcp@0.2.1",
        "--yes"
      ],
      "enabled": true
    }
  }
}

# ~/.hermes/config.yaml

mcp_servers:
  atypical-consulting-adr-mcp:
    command: "dnx"
    args: ["AdrMcp@0.2.1", "--yes"]

// ~/.netclaw/config/netclaw.json

{
  "McpServers": {
    "atypical-consulting-adr-mcp": {
      "Transport": "stdio",
      "Command": "dnx",
      "Arguments": [
        "AdrMcp@0.2.1",
        "--yes"
      ]
    }
  }
}

// mcp.json

{
  "mcpServers": {
    "atypical-consulting-adr-mcp": {
      "command": "dnx",
      "args": [
        "AdrMcp@0.2.1",
        "--yes"
      ]
    }
  }
}

Changelog

Every change we have recorded for this component, newest first. Security-relevant changes are always shown. ▲ marks a change for the better, ▼ a change for the worse; unmarked changes are neutral.

20 Sept 26 +1

No change was recorded against any check on this day. Stability & Change Management went from 87 to 90. That category is still filling its 30-day observation window: 26 days of observed history at the previous scan, 27 at this one. The score rises as the window fills, whether or not the server changes.
18 Sept 26 −2
- Stability: pass → 0.83 functional
17 Sept 26 0
- Stability: 0.97 → pass security
16 Sept 26 +1

No change was recorded against any check on this day. Stability & Change Management went from 93 to 97. That category is still filling its 30-day observation window: 28 days of observed history at the previous scan, 29 at this one. The score rises as the window fills, whether or not the server changes.
14 Sept 26 +1

No change was recorded against any check on this day. Stability & Change Management went from 87 to 90. That category is still filling its 30-day observation window: 26 days of observed history at the previous scan, 27 at this one. The score rises as the window fills, whether or not the server changes.
12 Sept 26 +1

No change was recorded against any check on this day. Stability & Change Management went from 80 to 83. That category is still filling its 30-day observation window: 24 days of observed history at the previous scan, 25 at this one. The score rises as the window fills, whether or not the server changes.
11 Sept 26 −3
- Stability: pass → 0.80 functional
10 Sept 26 0
- Stability: 0.97 → pass security

Show 5 earlier entries Hide earlier entries

Diagnostics

Diagnostic detail from the automated scan of this channel: what the scanner observed at each step, so you can see exactly where a check passed or failed. It is informational only and never changes the trust score.

Captured 20 Sept 2026 · Analysed nuget/AdrMcp@0.2.1

Provenance No attestation

The registry publishes no build provenance for this version, so there is nothing to verify.

Result	No attestation
Ecosystem	nuget
Reason	Signature present, unreadable

Background: How many MCP packages publish verified provenance →

Dependencies 0 packages

Packages resolved	0
Tree resolution	Complete

Background: SBOMs and build attestations, explained →

MCP tools · 18 exposed · ~1,385 tokens

The tools this component advertises to a client, with an estimated token cost for each. Expand a tool to see its parameters and schema. The per-tool counts are indicative and are not scored directly; the schema's total context footprint is one signal in Schema Quality & AI Usability. A tool's description is untrusted text the model reads on every call, which is what makes this list a security surface and not just an inventory: how tool poisoning works →

Tool Tokens

coverage_report ~69

Report ADR coverage per architectural area (mapped to tags). Areas with zero ADRs are decision gaps. Provide 'areas' to check a specific set, otherwise all tags are reported.

Input Output Examples

Name	Type	Req	Description
areas	array\|null	–	Areas (tags) to check. Omit to report every tag present in the corpus.

No output schema declared.

No examples provided.

create_adr ~182

Create a new ADR from a template (madr or nygard). Previews the file by default; set preview_only=false to write it.

Input Output Examples

Name	Type	Req	Description
consequences	string\|null	–	Resulting consequences (good and bad).
context	string\|null	–	Context and problem statement.
deciders	array\|null	–	Deciders (people/roles).
decision	string\|null	–	The decision / chosen option.
options	array\|null	–	Considered options (for the MADR template).
previewOnly	boolean	–	Preview only (default true). Set false to write to disk.
tags	array\|null	–	Tags / architectural areas.
template	string	–	Template: 'madr' (default) or 'nygard'.
title	string	yes	The decision title, e.g. 'Use PostgreSQL for persistence'.

No output schema declared.

No examples provided.

detect_conflicts ~25

Find ADR pairs that conflict: explicit conflicts-with links plus highly similar accepted decisions.

Input Output Examples

Input schema present but exposes no named parameters.

No output schema declared.

No examples provided.

diff_adr ~72

Diff two ADRs' bodies, or (when 'other' is omitted) diff an ADR's on-disk file against its canonical rendering to reveal formatting drift.

Input Output Examples

Name	Type	Req	Description
idOrSlug	string	yes	ADR id or slug.
other	string\|null	–	Optional second ADR id or slug to diff against.

No output schema declared.

No examples provided.

find_related_adrs ~42

Find ADRs related to a given ADR: incoming/outgoing links plus its supersession chain.

Input Output Examples

Name	Type	Req	Description
idOrSlug	string	yes	ADR id or slug.

No output schema declared.

No examples provided.

find_stale_adrs ~31

Find non-rejected ADRs whose code_refs no longer resolve against the repository (stale decisions).

Input Output Examples

Input schema present but exposes no named parameters.

No output schema declared.

No examples provided.

get_adr ~79

Get a single ADR by id or slug. Pass 'sections' to return only specific ## sections (token-efficient).

Input Output Examples

Name	Type	Req	Description
idOrSlug	string	yes	ADR id (e.g. 7) or slug (e.g. use-postgres).
sections	array\|null	–	Optional list of section headings to return instead of the full body.

No output schema declared.

No examples provided.

get_adr_graph ~22

Return the full ADR relationship graph (nodes + typed edges).

Input Output Examples

Input schema present but exposes no named parameters.

No output schema declared.

No examples provided.

get_adr_index ~26

Return the decision log: every ADR as a chronological/id-ordered timeline entry.

Input Output Examples

Input schema present but exposes no named parameters.

No output schema declared.

No examples provided.

link_adrs ~141

Create a typed link between two ADRs (supersedes, superseded-by, relates-to, conflicts-with). Adds the inverse on the target unless bidirectional=false. Preview-by-default.

Input Output Examples

Name	Type	Req	Description
bidirectional	boolean	–	Also add the inverse link on the target ADR (default true).
fromIdOrSlug	string	yes	Source ADR id or slug.
previewOnly	boolean	–	Preview only (default true). Set false to write to disk.
toIdOrSlug	string	yes	Target ADR id or slug.
type	string	–	Link type: relates-to (default), supersedes, superseded-by, conflicts-with.

No output schema declared.

No examples provided.

list_adrs ~109

List ADRs, optionally filtered by status, tag, or date range. Returns compact summaries.

Input Output Examples

Name	Type	Req	Description
since	string\|null	–	Only ADRs dated on/after this ISO date (yyyy-MM-dd).
status	string\|null	–	Filter by status: proposed, accepted, rejected, deprecated, superseded.
tag	string\|null	–	Filter to ADRs carrying this tag.
until	string\|null	–	Only ADRs dated on/before this ISO date (yyyy-MM-dd).

No output schema declared.

No examples provided.

render_index ~47

Regenerate the browsable decision index (README.md in the ADR folder). Preview-by-default.

Input Output Examples

Name	Type	Req	Description
previewOnly	boolean	–	Preview only (default true). Set false to write README.md.

No output schema declared.

No examples provided.

search_adrs ~70

Search ADRs. Lexical by default; set semantic=true for term-vector similarity ranking.

Input Output Examples

Name	Type	Req	Description
query	string	yes	The search query.
semantic	boolean	–	Use semantic (term-vector) ranking instead of lexical term matching.
topK	integer	–	Maximum number of hits to return.

No output schema declared.

No examples provided.

set_status ~81

Transition an ADR's status. Enforces the lifecycle (e.g. proposed->accepted). Preview-by-default.

Input Output Examples

Name	Type	Req	Description
idOrSlug	string	yes	ADR id or slug.
previewOnly	boolean	–	Preview only (default true). Set false to write to disk.
status	string	yes	Target status: accepted, rejected, deprecated, superseded.

No output schema declared.

No examples provided.

suggest_adr_from_change ~66

Given a unified diff, draft an ADR proposal: a suggested title, code_refs for the changed files, and a ready-to-edit MADR body. Does not write anything.

Input Output Examples

Name	Type	Req	Description
diff	string	yes	A unified diff (e.g. output of `git diff`).

No output schema declared.

No examples provided.

supersede_adr ~172

Create a new ADR that supersedes an existing one: writes the new ADR (accepted), marks the old superseded, and links both — in one call. Preview-by-default.

Input Output Examples

Name	Type	Req	Description
consequences	string\|null	–	Consequences of the new decision.
context	string\|null	–	Context of the new decision.
decision	string\|null	–	The new decision.
newTitle	string	yes	Title of the new (replacement) ADR.
oldIdOrSlug	string	yes	Id or slug of the ADR being superseded.
previewOnly	boolean	–	Preview only (default true). Set false to write to disk.
tags	array\|null	–	Tags for the new ADR.
template	string	–	Template: 'madr' (default) or 'nygard'.

No output schema declared.

No examples provided.

update_adr ~95

Replace (or append) the content of a single ## section of an ADR. Preview-by-default.

Input Output Examples

Name	Type	Req	Description
content	string	yes	The new section content (markdown).
idOrSlug	string	yes	ADR id or slug.
previewOnly	boolean	–	Preview only (default true). Set false to write to disk.
section	string	yes	The ## section heading to set, e.g. 'Consequences'.

No output schema declared.

No examples provided.

validate_adr ~56

Validate one ADR (by id/slug) or the whole corpus: required sections, valid status, dangling links, duplicate ids.

Input Output Examples

Name	Type	Req	Description
idOrSlug	string\|null	–	ADR id or slug. Omit to validate every ADR.

No output schema declared.

No examples provided.

Common questions

What is the AdrMcp MCP server?

AdrMcp is an MCP server listed in the public MCP registry as io.github.Atypical-Consulting/adr-mcp. MCP server for Architectural Decision Records: navigate, author, validate, link, and analyze them. This page covers its NuGet package (AdrMcp).

Is the AdrMcp MCP server safe to use?

AdrMcp scores 85 out of 100 on VerifyMCP. We found no known CVEs affecting it as of 20 September 2026. It declares no install or post-install scripts. That is a record of what we were able to check automatically, not an endorsement. The category breakdown on this page shows every signal behind the number, including the ones we could not confirm.

What tools does the AdrMcp MCP server expose?

AdrMcp exposes 18 tools: detect_conflicts, search_adrs, diff_adr, render_index, coverage_report, and 13 more. Their descriptions and schemas cost roughly 1,385 tokens of context every time the server is loaded.

Is the AdrMcp MCP server still maintained?

AdrMcp is still listed as active in the MCP registry. We last reached this channel on 20 September 2026. Those dates come from our own scans of the registry and the channel itself, not from anything the publisher announced.

What licence is the AdrMcp MCP server under?

AdrMcp declares the MIT licence, which is OSI-approved. That covers the source only, and says nothing about the cost of any service it calls.

On this page

Handy links

Scoring key

80+ high trust
60–79 medium
below 60 low

How we score

Badge

Put this score in your README. The image is served from a stable URL, updates when the score does, and links back to the evidence on this page. It shows nothing that is not already published here.

Score Verified Plain

The two-cell badge: our name, and this channel's current score out of 100.

Markdown

 [![VerifyMCP trust score for AdrMcp](https://verifymcp.io/badge/atypical-consulting-adr-mcp/adrmcp.svg)](https://verifymcp.io/servers/atypical-consulting-adr-mcp/adrmcp)

HTML

 <a href="https://verifymcp.io/servers/atypical-consulting-adr-mcp/adrmcp"><img src="https://verifymcp.io/badge/atypical-consulting-adr-mcp/adrmcp.svg" alt="VerifyMCP trust score for AdrMcp" height="20"></a>

A single cell stating that the server is listed here. Carries no number.

Markdown

 [![VerifyMCP trust score for AdrMcp](https://verifymcp.io/badge/atypical-consulting-adr-mcp/adrmcp.svg?variant=verified)](https://verifymcp.io/servers/atypical-consulting-adr-mcp/adrmcp)

HTML

 <a href="https://verifymcp.io/servers/atypical-consulting-adr-mcp/adrmcp"><img src="https://verifymcp.io/badge/atypical-consulting-adr-mcp/adrmcp.svg?variant=verified" alt="VerifyMCP trust score for AdrMcp" height="20"></a>

The score alone, tier-coloured, for a badge row that is already crowded.

Markdown

 [![VerifyMCP trust score for AdrMcp](https://verifymcp.io/badge/atypical-consulting-adr-mcp/adrmcp.svg?variant=plain)](https://verifymcp.io/servers/atypical-consulting-adr-mcp/adrmcp)

HTML

 <a href="https://verifymcp.io/servers/atypical-consulting-adr-mcp/adrmcp"><img src="https://verifymcp.io/badge/atypical-consulting-adr-mcp/adrmcp.svg?variant=plain" alt="VerifyMCP trust score for AdrMcp" height="20"></a>

Score history · last 30 days

23 Aug 20 Sept

Trust score by day, last 30 days
Day	Score
23 Aug	80
24 Aug	81
25 Aug	81
26 Aug	82
27 Aug	83
28 Aug	83
29 Aug	84
30 Aug	84
31 Aug	85
1 Sept	85
2 Sept	86
3 Sept	86
4 Sept	83
5 Sept	84
6 Sept	84
7 Sept	85
8 Sept	85
9 Sept	86
10 Sept	86
11 Sept	83
12 Sept	84
13 Sept	84
14 Sept	85
15 Sept	85
16 Sept	86
17 Sept	86
18 Sept	84
19 Sept	84
20 Sept	85