World Monitor
Real-time global intelligence on conflict, markets, energy, trade, shipping and cyber. 100 tools.
MCP server for Architectural Decision Records: navigate, author, validate, link, and analyze them.
Lists are ordered by a usage score (out of 100) built from these parts
| Popularity | 4/80 | GitHub stars or weekly downloads: the larger counts 60, the smaller 20 |
|---|---|---|
| Freshness | 12/12 | Full marks for a release or code change within 30 days |
| Still answering | 0/8 | The cloud endpoint answered at the last check |
| Usage score | 16/100 |
Quality: Passed 3/3 basic checks (shown, not used for ordering) · Momentum: No data yet (Used only on the Trending tab)
Pick the AI app you use, then copy the settings.
Let your AI install it with one sentence
Please install AdrMcp. Follow https://mcp.popnx.com/i/atypical-consulting-adr-mcp.md, show me the commands and wait for my OK before running them.Paste it into an AI that can work on your computer (such as Claude Code or Cursor). It reads our steps, shows you the commands and waits for your OK. No key, no sign-up. · See the full text your AI reads
Passed 3/3 checks · Runs on your computer · ✓ Commands checked Nov 13, 2026
First: which AI do you use?
Pick your app and the steps appear below.
Works with Claude, with some setup first
No key, nothing to install · Only the Claude desktop app (Windows or Mac), not the web or phone
Copy this message into a Claude chat. The AI checks your computer, tells you which file it will change, and waits for your OK every time.
Please install the MCP server AdrMcp for Claude on this computer, in this order: 1) 2) Use only this config (already checked by PopNx MCP): { "mcpServers": { "adr": { "command": "dnx", "args": [ "AdrMcp", "--yes" ] } } } 3) Tell me the full path of the file you will change, or the command you will run, and wait for my OK. 4) No key is needed. 5) Do what we agreed, then check that the AdrMcp tools really show up.This message has no key in it. If a key is needed, the AI will ask you to paste it yourself into the file or the app’s field.
SettingsDeveloperEdit Config
{
"mcpServers": {
"adr": {
"command": "dnx",
"args": [
"AdrMcp",
"--yes"
]
}
}
}Use AdrMcp and tell me what you can do for me, then show me one thing✓ If Claude says it is using AdrMcp or shows a AdrMcp tool in the answer, you are connected
Menu names checked against Anthropic’s help page on Nov 11, 2026 · your screen may differ slightly by app version
ChatGPT cannot connect AdrMcp yet
AdrMcp runs on your computer, but ChatGPT can only connect servers that run on the web
A · Use an app that can connect AdrMcp
B · Others in Other that work with ChatGPT
Picked from the most used in the same category, only ones that connect by address with no key
Works with Claude Code, with some setup first
No key, nothing to install
Copy this message into a Claude Code chat. The AI checks your computer, tells you which file it will change, and waits for your OK every time.
Please install the MCP server AdrMcp for Claude Code on this computer, in this order: 1) 2) Use only this config (already checked by PopNx MCP): claude mcp add --scope user adr -- dnx AdrMcp --yes 3) Tell me the full path of the file you will change, or the command you will run, and wait for my OK. 4) No key is needed. 5) Do what we agreed, then check that the AdrMcp tools really show up.This message has no key in it. If a key is needed, the AI will ask you to paste it yourself into the file or the app’s field.
Mac: press Command+Space and type Terminal · Windows: open PowerShell
claude mcp add --scope user adr -- dnx AdrMcp --yesYou should see AdrMcp listed as connected
Use AdrMcp and tell me what you can do for me, then show me one thing✓ If Claude Code says it is using AdrMcp or shows a AdrMcp tool in the answer, you are connected
Menu names checked against Anthropic’s help page on Nov 11, 2026 · your screen may differ slightly by app version
Works with Cursor, with some setup first
No key, nothing to install
Copy this message into a Cursor chat. The AI checks your computer, tells you which file it will change, and waits for your OK every time.
Please install the MCP server AdrMcp for Cursor on this computer, in this order: 1) 2) Use only this config (already checked by PopNx MCP): { "mcpServers": { "adr": { "command": "dnx", "args": [ "AdrMcp", "--yes" ] } } } 3) Tell me the full path of the file you will change, or the command you will run, and wait for my OK. 4) No key is needed. 5) Do what we agreed, then check that the AdrMcp tools really show up.This message has no key in it. If a key is needed, the AI will ask you to paste it yourself into the file or the app’s field.
Use AdrMcp and tell me what you can do for me, then show me one thing✓ If Cursor says it is using AdrMcp or shows a AdrMcp tool in the answer, you are connected
Menu names checked against Cursor’s help page on Nov 11, 2026 · your screen may differ slightly by app version
Works with VS Code, with some setup first
No key, nothing to install
Copy this message into a VS Code chat. The AI checks your computer, tells you which file it will change, and waits for your OK every time.
Please install the MCP server AdrMcp for VS Code on this computer, in this order: 1) 2) Use only this config (already checked by PopNx MCP): { "servers": { "adr": { "type": "stdio", "command": "dnx", "args": [ "AdrMcp", "--yes" ] } } } 3) Tell me the full path of the file you will change, or the command you will run, and wait for my OK. 4) No key is needed. 5) Do what we agreed, then check that the AdrMcp tools really show up.This message has no key in it. If a key is needed, the AI will ask you to paste it yourself into the file or the app’s field.
Use AdrMcp and tell me what you can do for me, then show me one thing✓ If VS Code says it is using AdrMcp or shows a AdrMcp tool in the answer, you are connected
Menu names checked against VS Code’s help page on Nov 11, 2026 · your screen may differ slightly by app version
Other apps that use MCP, such as Windsurf, Zed or Gemini CLI, each add servers differently. See how in the app list.
JSON settings are under “For developers” below
Claude Code
claude mcp add --scope user adr -- dnx AdrMcp --yesClaude Desktop (claude_desktop_config.json)
{
"mcpServers": {
"adr": {
"command": "dnx",
"args": [
"AdrMcp",
"--yes"
]
}
}
}Cursor (~/.cursor/mcp.json)
{
"mcpServers": {
"adr": {
"command": "dnx",
"args": [
"AdrMcp",
"--yes"
]
}
}
}VS Code (mcp.json)
{
"servers": {
"adr": {
"type": "stdio",
"command": "dnx",
"args": [
"AdrMcp",
"--yes"
]
}
}
}These settings are generated from the maker’s registry entry. If the README says otherwise, follow the README.
Based on how this server connects and on each app’s own docs, checked Nov 10, 2026.
Run on your computer in
ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast
Runs on your computer; the tool list appears in your AI app after you install it.
We check information anyone can see; we have not read the code. Checks that do not apply are left out of the count. · Checked Nov 18, 2026
The registry name was verified with the GitHub account Atypical-Consulting, which owns the repo
Code last changed 4 days ago
Uses MIT
This one runs on your computer; there is no internet endpoint
Runs on your computer and uses local settings instead
Runs on your computer; we can only read tool lists from internet endpoints
Not checked: only npm and PyPI packages with a version can be checked
If you made this, paste this code into your README. The badge links back to this page.
[](https://mcp.popnx.com/en/servers/atypical-consulting-adr-mcp)Ask, share a tip or report that it does not work. Sorted by what people marked helpful.
No posts yet. Be the first to ask or share.
Posts here are written by users, not the PopNx team.
No reviews yet
Compared with every active server in this category in the registry. Stars count only when the publisher owns the repo.
It passed 3 of 3 applicable basic checks. We have not read the code. Before adding a key or token, see what access the server asks for and use a key with only the permissions you need.
The registry does not list a required key, though some servers ask you to sign in on first use.
It runs on your computer. Your AI app starts it when needed, and data does not pass through the maker’s servers (unless it calls an online service itself).
The GitHub repo last changed 4 days ago, and the latest version (0.2.1) reached the registry 4 months ago.
Apps that support MCP, such as Claude Desktop, Claude Code, Cursor and VS Code. You also need .NET on your computer.
In the same category: World Monitor, openstatus, Oh My Posh Validator, Strata, Jitsu
Same category, other makers, commands already checked. Official ones first, then by stars.
Reading a card:↓ Downloads per weeki★ GitHub starsiThree pillars: reviews · checks · usageiUpdated = latest version published to the registryi
Real-time global intelligence on conflict, markets, energy, trade, shipping and cyber. 100 tools.
Manage monitors, status pages, incidents and maintenances in your openstatus workspace.
Validate oh-my-posh configurations and segment snippets against the official schema.
MCP server for progressive tool usage at any scale (see https://klavis.ai)
Manage Jitsu data pipelines: destinations, streams, connections, functions, live events.
| This one AdrMcp | World Monitor | openstatus | Oh My Posh Validator | Strata | Jitsu | |
|---|---|---|---|---|---|---|
| Runs where | Installs on your computer | Runs in the cloud, nothing to install | Runs in the cloud, nothing to install | Runs in the cloud, nothing to install | Runs in the cloud, nothing to install | Runs in the cloud, nothing to install |
| Needs a key | No | No | No | No | No | No |
| Add with + in Claude | No | No | No | No | No | No |
| Basic checks | 3/3 | 4/4 | 4/4 | 4/4 | 1/4 | 4/4 |
| License | MIT | AGPL-3.0 | AGPL-3.0 | MIT | Apache-2.0 | MIT |
| Price | No cost listed in the registry | No cost listed in the registry | No cost listed in the registry | No cost listed in the registry | No cost listed in the registry | No cost listed in the registry |
Copied from the maker’s repo as written. PopNx MCP has not reviewed or endorsed it. HTML, images and scripts are removed. Links lead off this site.
git clone https://github.com/Atypical-Consulting/AdrMcp.git
cd AdrMcp dotnet restore dotnet build dotnet run --project AdrMcp/AdrMcp.csproj
Every architectural decision, on the record — an MCP server that turns a folder of Markdown ADRs into live tools your AI agent can use: search, author, validate, link, and trace decisions.
🌐 [atypical-consulting.github.io/AdrMcp](https://atypical-consulting.github.io/AdrMcp/)
list_adrs, get_adr, search_adrs (lexical or semantic), and get_adr_index for the full decision timeline.create_adr drafts MADR- or Nygard-format ADRs; update_adr replaces or appends a single section.set_status enforces the ADR lifecycle; supersede_adr creates the replacement and marks/links the old one superseded in a single call.find_related_adrs / get_adr_graph expose links and supersession chains; find_stale_adrs flags ADRs whose code_refs no longer resolve in the codebase.detect_conflicts surfaces contradictory accepted decisions; coverage_report highlights ADR coverage gaps by architectural area.previewOnly: true and returns a unified diff before anything touches disk.adr-author, adr-review, adr-supersede) for the judgment layer on top of the raw tools.Architectural decisions get made in Slack threads, PR comments, and someone's head — then the reasoning evaporates. Months later a teammate asks "why is it done this way?", nobody remembers, and the decision gets silently re-litigated or accidentally reversed. ADRs fix that — *if* they're written and kept honest. But a folder of Markdown files is inert: you can't ask it what's still accepted, trace what superseded what, or notice a decision that no longer matches the code.
It's worse with AI coding agents: the one collaborator that could keep decisions current has no way to read, write, or reason about them.
AdrMcp makes that folder a live surface any MCP client can work. It gives your agent tools to list and search decisions, draft new ones from a MADR template, validate structure and links, supersede a decision while preserving its history, and flag stale or conflicting ones — all preview-by-default, so nothing is written without you seeing the diff.
The records stay plain Markdown in git; AdrMcp adds the tools. Built as a .NET 10 stdio MCP server, architecturally modeled on RoselineMCP — layered Tools → Services, [McpServerTool] attributes, shipped as a dotnet tool + Docker image.
ADRs are markdown files under an ADR root (default docs/adr/), one file per decision named NNNN-kebab-title.md, using MADR 4.0 frontmatter + sections:
---
id: 1 title: Use PostgreSQL for persistence status: accepted # proposed | accepted | rejected | deprecated | superseded date: 2026-07-08 tags: [data] links:
code_refs:
...
...
...
Everything is git-native, human-readable, and diff-able — no database.
| Tool | Kind | Description |
|---|---|---|
list_adrs | read | List/filter ADRs (status, tag, date range) |
get_adr | read | Get one ADR; optionally only selected ## sections |
search_adrs | read | Lexical (default) or semantic term-vector search |
get_adr_index | read | The decision log / timeline |
find_related_adrs | read | Incoming/outgoing links + supersession chain |
get_adr_graph | read | Full relationship graph (nodes + typed edges) |
create_adr | write | Create an ADR from a template (madr or nygard) |
update_adr | write | Replace/append a single ## section |
set_status | write | Transition status (enforces the lifecycle) |
supersede_adr | write | Create replacement + mark old superseded + link, in one call |
link_adrs | write | Typed link between two ADRs (adds inverse) |
validate_adr | read | MADR compliance: sections, status, dangling links, duplicate ids |
detect_conflicts | read | Explicit conflicts-with + highly similar accepted ADRs |
find_stale_adrs | read | ADRs whose code_refs no longer resolve |
coverage_report | read | ADR coverage per architectural area (tag); surfaces gaps |
suggest_adr_from_change | read | Draft an ADR proposal from a unified diff |
render_index | write | Regenerate the browsable README.md decision index |
diff_adr | read | Diff two ADRs, or a file vs its canonical rendering |
Writes are preview-by-default. Every mutating tool takes previewOnly (default true) and returns a unified diff of the intended change; pass previewOnly=false to write to disk.
Resolved in order: CLI arg → env var → default.
| Setting | CLI | Env | Default |
|---|---|---|---|
| ADR root | --adr-root | ADR_ROOT | /docs/adr |
Repo root (for code_refs) | --repo-root | ADR_REPO_ROOT | current directory |
find_stale_adrs resolves code_refs through an ICodeLinkProvider. The default FileSystemCodeLinkProvider is language-agnostic (a ref resolves if the file exists and, when a symbol is given, that symbol's text is present). A Roslyn (.NET) or codebase-memory provider can be plugged in behind the same interface — deep symbol resolution stays the client's job.
# from source
dotnet run --project AdrMcp -- --adr-root ./docs/adr
dotnet tool install -g AdrMcp adr-mcp --adr-root ./docs/adr
{
"mcpServers": { "adr": { "command": "adr-mcp", "args": ["--adr-root", "/path/to/repo/docs/adr", "--repo-root", "/path/to/repo"] } } }
docker build -t adr-mcp .
docker run --rm -i -v "$PWD:/workspace" adr-mcp --adr-root /workspace/docs/adr
Once adr-mcp is registered as an MCP server, an agent calls its tools directly. A typical read-then-write flow:
// "What ADRs do we have about data storage?"
list_adrs({ "tag": "data" }) // → [{ "id": 5, "title": "Use PostgreSQL for persistence", "status": "accepted", "tags": ["data"] }]
// "Draft a decision for switching to gRPC internally" — nothing is written yet create_adr({ "title": "Adopt gRPC for internal services", "template": "madr", "previewOnly": true }) // → unified diff of the new docs/adr/0006-adopt-grpc-for-internal-services.md
// Once the content looks right, write it for real create_adr({ "title": "Adopt gRPC for internal services", "template": "madr", "previewOnly": false })
// Later, retire an old decision in favor of a new one, preserving history supersede_adr({ "oldId": 2, "newTitle": "Replace REST gateway with gRPC", "previewOnly": false })
Three project skills under .claude/skills/ add the judgment/workflow layer on top of the MCP tools (the server provides the mechanics; the skills provide the craft). They activate automatically in Claude Code when the connected AdrMcp server is available:
| Skill | Triggers on | What it does |
|---|---|---|
adr-author | "write an ADR", "record this decision" | Decide if a decision warrants an ADR, frame a sharp Context/Decision/Consequences, draft via create_adr + validate_adr |
adr-review | "review this ADR", "does this decision hold up" | Structural + substantive critique against a rubric, using validate_adr / detect_conflicts |
adr-supersede | "we changed our mind", "retire this decision" | Pick the right lifecycle move and drive supersede_adr / set_status with correct linking |
dotnet build AdrMcp.slnx
dotnet test AdrMcp.slnx # unit tests + MCP-over-stdio integration tests dotnet pack AdrMcp/AdrMcp.csproj -c Release -o ./artifacts
CI/CD runs on GitHub Actions, modeled on RoselineMCP:
| Workflow | Trigger | What it does |
|---|---|---|
ci.yml | push / PR to main/dev | Build + test matrix (ubuntu/windows/macos); 80% line-coverage gate on ubuntu |
codeql.yml | push / PR / weekly | CodeQL security analysis (C#) |
pages.yml | push to site/** on dev | Publish the landing page to GitHub Pages |
release-please.yml | push to dev | Maintain a release PR (Conventional Commits); on merge, publish NuGet + MCPB + MCP Registry + GHCR image |
Releases are automated with release-please: merge the release PR it opens to ship. See PUBLISH.md.
AdrMcp/
├── Interfaces/ service contracts (IAdrRepository, ICodeLinkProvider, …) ├── Services/ repository, templates, validation, graph, search, embeddings, code-links ├── Tools/ Navigation / Authoring / Intelligence / Utility MCP tools ├── Models/ Adr, AdrStatus, AdrLink, CodeRef, response DTOs └── Program.cs DI wiring + stdio MCP host
search_adrs / detect_conflicts (beyond term-vector similarity)ICodeLinkProvider for deep C# symbol resolution in find_stale_adrsSee the open issues for details and to propose new ideas.
Part of a suite of Model Context Protocol servers by Atypical Consulting: