AdrMcp
NUGET · ADRMCP
MCP server for Architectural Decision Records: navigate, author, validate, link, and analyze them.
Available components
Last scanned (19 hours ago)
Scores higher than 92% of NuGet servers
Category Developer Tools
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
- Build provenance not yet verified. View diagnostics → Unverified
- Clear OSI-approved license (MIT).Pass
- Actively maintained (last published 117 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 Management100
- No destabilizing schema changes in the last 30 days.Pass
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
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.
- 4 Nov 26 0
- Stability: 0.97 → pass security
- 3 Nov 26 0
- Stability: pass → 0.97 functional
- 28 Oct 26 0
- Stability: 0.97 → pass security
- 27 Oct 26 0
- Stability: pass → 0.97 functional
- 23 Oct 26 +1
- Security disclosure: unverified → pass ▲ functional
- 21 Oct 26 −1
- Stability: 0.97 → pass security
- Security disclosure: pass → unverified ▼ functional
- 20 Oct 26 0
- Stability: pass → 0.97 functional
- 17 Oct 26 +2
- Stability: 0.83 → pass security
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 4 Nov 2026 · Analysed nuget/AdrMcp@0.2.1
Provenance Inconclusive
We could not complete the check, so nothing is claimed either way. This is a gap on our side, not a finding about the package.
| Result | Inconclusive |
|---|---|
| Ecosystem | nuget |
| Reason | Signature present, unverified |
Signer
| Signed as | Repository signature, names nuget.org |
|---|---|
| Subject | CN=NuGet.org Repository by Microsoft,O=NuGet.org Repository by Microsoft,L=Redmond,ST=Washington,C=US |
| Issuer | CN=DigiCert Trusted G4 Code Signing RSA4096 SHA384 2021 CA1,O=DigiCert\, Inc.,C=US |
| Valid from | 23 Feb 2024 |
| Valid until | 18 May 2027 |
| Service index | https://api.nuget.org/v3/index.json |
| Owners | atypical |
Background: How many MCP packages publish verified provenance →
Dependencies 0 packages
| Packages resolved | 0 |
|---|---|
| Tree resolution | Complete |
Background: SBOMs and build attestations, explained →
Registry declarations For information only
What the registry and the package's own manifest say about this version. The publisher or the registry writes these, nothing here is verified, and none of it affects the score.
| Repository | https://github.com/Atypical-Consulting/AdrMcp |
|---|---|
| Repository type | git |
| Commit | cdb76e6ce18d56b6332a5e60915f6b18d4d6b4cc |
| Project URL | https://github.com/Atypical-Consulting/AdrMcp |
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 →
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.
| 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.
| 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 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.
| 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.
| 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 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).
| 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 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 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.
| 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.
| 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.
| 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.
| 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.
| 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.
| 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.
| 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.
| 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.
| Name | Type | Req | Description |
|---|---|---|---|
| idOrSlug | string|null | – | ADR id or slug. Omit to validate every ADR. |
No output schema declared.
No examples provided.
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 mcp add atypical-consulting-adr-mcp -- dnx AdrMcp@0.2.1 --yes
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 86 out of 100 on VerifyMCP. We found no known CVEs affecting it as of 4 November 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 4 November 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.