# ADR Guard (nuget · RodriOliveira.AdrGuard.Mcp)

Read, search, validate, and analyze Architecture Decision Records.

- Trust score: 70/100 (medium)
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-10-18

## Components

- nuget · `RodriOliveira.AdrGuard.Mcp`: 70/100 (this document), [markdown](https://verifymcp.io/servers/rodri-oliveira-dev-adr-guard/rodrioliveira-adrguard-mcp.md), [page](https://verifymcp.io/servers/rodri-oliveira-dev-adr-guard/rodrioliveira-adrguard-mcp)

## Channel facts

- Registry: `nuget`
- Package: `RodriOliveira.AdrGuard.Mcp`
- Version: `1.0.0`
- Transport: `stdio`

## Trust breakdown

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. Scores are 0–100 per category. Scoring method: https://verifymcp.io/docs/scoring (what has changed: https://verifymcp.io/docs/scoring/changelog)

Scored 2026-10-18.

- **Supply Chain Security**: 100/100
  - No malware found by supply-chain analysis.
  - No known CVEs affecting this package version or its production dependencies.
  - No install/post-install scripts declared.
  - No production dependencies, so there is no dependency health to assess.
- **Provenance & Transparency**: 48/100
  - Source repository is publicly reachable at the declared URL.
  - Build provenance not yet verified.
  - Clear OSI-approved license (MIT).
  - Actively maintained (last published 0 days ago).
  - Publishes a security disclosure policy (SECURITY.md).
- **Schema Quality & AI Usability**: 71/100
  - AI-judged instruction clarity (good).
  - Tool/resource definitions use about 400 tokens (~57/item across 7 items; 7 tools + 0 resources), lean.
  - Usage-examples check failed: none of the tools include examples.
- **Stability & Change Management**: 0/100
  - Stability not yet verified: not enough scan history yet (needs a 30-day window).
- **Tool Coverage**: 100/100
  - 100% of tools have a non-trivial description (not blank, and not just the tool's name).
  - 100% of tool parameters carry a description.
  - Structured output schemas are declared (100% of tools); any adoption earns full credit.
- **Tool Safety**: 100/100
  - No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.
  - We read all 7 captured tool definition(s), and no name or description among them implies an irreversible operation.
  - An AI judge read all 7 captured unit(s) of tool text and found none that tries to manipulate the model reading it.
- **Capabilities**: 100/100
  - Implements a current MCP spec version (2026-07-28).

**Unverified: 1 category.** A category scored 0 because we could not verify it: a data source with nothing on this package, evidence we could not reach, or a check we could not run. We only credit what we can confirm.

## Install

### How do I install the ADR Guard MCP server?

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

### Claude

```bash
claude mcp add rodri-oliveira-dev-adr-guard -- dnx RodriOliveira.AdrGuard.Mcp@1.0.0 --yes
```

### Cursor

```json
{
  "mcpServers": {
    "rodri-oliveira-dev-adr-guard": {
      "command": "dnx",
      "args": [
        "RodriOliveira.AdrGuard.Mcp@1.0.0",
        "--yes"
      ]
    }
  }
}
```

### VS Code

```json
{
  "servers": {
    "rodri-oliveira-dev-adr-guard": {
      "command": "dnx",
      "args": [
        "RodriOliveira.AdrGuard.Mcp@1.0.0",
        "--yes"
      ]
    }
  }
}
```

### Codex

```bash
codex mcp add rodri-oliveira-dev-adr-guard -- dnx RodriOliveira.AdrGuard.Mcp@1.0.0 --yes
```

### opencode

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "rodri-oliveira-dev-adr-guard": {
      "type": "local",
      "command": [
        "dnx",
        "RodriOliveira.AdrGuard.Mcp@1.0.0",
        "--yes"
      ],
      "enabled": true
    }
  }
}
```

### Hermes

```yaml
mcp_servers:
  rodri-oliveira-dev-adr-guard:
    command: "dnx"
    args: ["RodriOliveira.AdrGuard.Mcp@1.0.0", "--yes"]
```

### Netclaw

```json
{
  "McpServers": {
    "rodri-oliveira-dev-adr-guard": {
      "Transport": "stdio",
      "Command": "dnx",
      "Arguments": [
        "RodriOliveira.AdrGuard.Mcp@1.0.0",
        "--yes"
      ]
    }
  }
}
```

### Other

```json
{
  "mcpServers": {
    "rodri-oliveira-dev-adr-guard": {
      "command": "dnx",
      "args": [
        "RodriOliveira.AdrGuard.Mcp@1.0.0",
        "--yes"
      ]
    }
  }
}
```

## Changelog

Every change recorded for this component, newest first. Days that predate change tracking, or that we cannot explain, say so: "we were watching and nothing happened" and "we were not watching" are different claims.

### 2026-10-18 (score 70, +15)

- [security improvement] Malware scan: unverified → pass

### 2026-10-17 (score 55)

First indexed and scored.

## MCP tools (7)

### `search_adrs` (~62 tokens)

Performs deterministic case-insensitive text search over ADR IDs, titles, and bounded content.

Input parameters:

- `limit` (integer): Maximum result count from 1 through 100.
- `query` (string, required): One or more textual terms. Every term must match the selected ADR.

Output parameters:

- `excerptsAreUntrusted` (boolean)
- `matches` (array)
- `query` (string)
- `schemaVersion` (string)
- `total` (integer)

### `verify_architecture` (~105 tokens)

Verifies declared architecture rules from bounded local evidence without running tests, builds, or scripts.

Input parameters:

- `baselinePath` (string|null): Optional repository-relative existing drift baseline path, read only.
- `evidencePaths` (array|null): Optional repository-relative bounded evidence JSON paths already produced by trusted tools.
- `policy` (string): Advisory or enforce. Enforcement reports policy failure but does not mutate the repository.
- `rulesPath` (string, required): Forward-slash repository-relative fitness rules JSON path.

Output parameters:

- `coverage` (object)
- `findings` (array)
- `inconclusive` (boolean)
- `policy` (string)
- `policyFailed` (boolean)
- `repository` (object)
- `schemaVersion` (string)

### `validate_adrs` (~45 tokens)

Runs ADR Guard deterministic validation and returns diagnostics as a successful analysis result.

Input parameters:

- `validationProfile` (string|null): Optional validation profile override: legacy, advisory, standard, or strict.

Output parameters:

- `diagnostics` (array)
- `files` (integer)
- `policy` (object)
- `schemaVersion` (string)
- `valid` (boolean)

### `analyze_impact` (~68 tokens)

Analyzes architecture impact from an explicit local mapping and Git base reference; never fetches or changes Git state.

Input parameters:

- `baseReference` (string, required): Explicit local Git base reference used by ADR Guard impact analysis.
- `manifestPath` (string, required): Forward-slash repository-relative impact mapping JSON path.

Output parameters:

- `advisory` (boolean)
- `changedFiles` (array)
- `coverage` (object)
- `decisions` (array)
- `repository` (object)
- `schemaVersion` (string)
- `summary` (object)
- `uncertainty` (object)

### `list_adrs` (~22 tokens)

Lists ADRs in the server's configured repository and ADR directory.

Output parameters:

- `adrs` (array)
- `schemaVersion` (string)
- `total` (integer)

### `get_adr_relationships` (~52 tokens)

Returns declared ADR supersession and dependency relationships without inferring missing edges.

Input parameters:

- `identifier` (string|null): Optional stable ID, numeric ID, or safe ADR path. Omit to inspect all ADRs.

Output parameters:

- `issues` (array)
- `relationships` (array)
- `schemaVersion` (string)

### `get_adr` (~46 tokens)

Reads one ADR by stable ID, numeric ID, or safe repository-relative path.

Input parameters:

- `identifier` (string, required): Stable ADR ID, numeric ID, or path within the configured ADR directory.

Output parameters:

- `adr` (object)
- `content` (string)
- `contentIsUntrusted` (boolean)
- `schemaVersion` (string)

## Diagnostics

Captured diagnostic sections: Provenance, Dependencies. The full working is on the page: https://verifymcp.io/servers/rodri-oliveira-dev-adr-guard/rodrioliveira-adrguard-mcp#diagnostics

## Score history

- 2026-10-18: 70
- 2026-10-17: 55

## Common questions

### What is the ADR Guard MCP server?

ADR Guard is an MCP server listed in the public MCP registry as io.github.rodri-oliveira-dev/adr-guard. Read, search, validate, and analyze Architecture Decision Records. This page covers its NuGet package (RodriOliveira.AdrGuard.Mcp).

### Is the ADR Guard MCP server safe to use?

ADR Guard scores 70 out of 100 on VerifyMCP. We found no known CVEs affecting it as of 18 October 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 ADR Guard MCP server expose?

ADR Guard exposes 7 tools: search_adrs, verify_architecture, validate_adrs, analyze_impact, list_adrs, and 2 more. Their descriptions and schemas cost roughly 400 tokens of context every time the server is loaded.

### Is the ADR Guard MCP server still maintained?

ADR Guard is still listed as active in the MCP registry. We last reached this channel on 18 October 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 ADR Guard MCP server under?

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

## Links

- NuGet package: https://www.nuget.org/packages/RodriOliveira.AdrGuard.Mcp
- Socket report: https://socket.dev/nuget/package/RodriOliveira.AdrGuard.Mcp
- Repository: https://github.com/rodri-oliveira-dev/adr-guard
- Changelog RSS feed: https://verifymcp.io/servers/rodri-oliveira-dev-adr-guard/rodrioliveira-adrguard-mcp.xml
- Changelog JSON feed: https://verifymcp.io/servers/rodri-oliveira-dev-adr-guard/rodrioliveira-adrguard-mcp.json
- HTML version of this page: https://verifymcp.io/servers/rodri-oliveira-dev-adr-guard/rodrioliveira-adrguard-mcp