About Dredd MCP
Dredd MCP is a pre-invocation security check for MCP servers, intended for agents and their operators. It checks dependency risks, tool and URL changes, and permission escalation, then returns a signed verdict with evidence or an advisory when visibility is limited.
Key features
- 01Inspect direct and transitive package risks
- 02Compare tools with an approved snapshot
- 03Detect remote URL changes
- 04Flag permission escalation
- 05Return HMAC-signed verdicts
- 06Fail open when the endpoint is unavailable
Use cases
- 01Check a server before invoking its tools
- 02Review newly added tools after a server update
- 03Assess package supply-chain risk before a session
- 04Surface uncertainty when dependency data is unavailable
MCP support
Dredd exposes the `check_mcp_server` tool through a remote MCP server. MCP clients can request a server, optional version, and optional tool check, receiving an `ALLOW`, `ADVISORY`, or `BLOCK` verdict.
Configuration
Remote servers need no local install. Pick your client, then copy the config or install in one click.
https://analytics.dugganusa.com/api/v1/dredd/mcpclaude mcp add --transport http pduggusa-dredd https://analytics.dugganusa.com/api/v1/dredd/mcp{"mcpServers":{"pduggusa-dredd":{"type":"http","url":"https://analytics.dugganusa.com/api/v1/dredd/mcp"}}}Open in Cursor{"servers":{"pduggusa-dredd":{"type":"http","url":"https://analytics.dugganusa.com/api/v1/dredd/mcp"}}}Open in VS Code{"mcpServers":{"pduggusa-dredd":{"type":"http","url":"https://analytics.dugganusa.com/api/v1/dredd/mcp"}}}{"mcpServers":{"pduggusa-dredd":{"serverUrl":"https://analytics.dugganusa.com/api/v1/dredd/mcp"}}}Run commands in a terminal; paste JSON into the client’s MCP config and restart. Servers that need sign-in will prompt on first connect.
Tools
1| Parameter | Type | Required | Description |
|---|---|---|---|
| tool | string | No | Optional name of the specific tool being invoked |
| server | string | Yes | REQUIRED. The server to judge: its exact MCP Registry name (io.github.owner/server-name, optionally @version). A bare name (server-name) is judged as typed, never mapped to a registry server, and the matching full names come back in input.did_you_mean. Also resolved, only when the identity is provable: a registry URL (https://registry.modelcontextprotocol.io/v0/servers/<name>) and a GitHub repo ("owner/repo" or https://github.com/owner/repo) published by that owner as exactly one registry server. Package names (npm/PyPI), images and Smithery ids are recorded but judged as given (usually REVIEW): their name does not prove which code runs. Refused: commands, shell metacharacters, non-ASCII, local paths, endpoint URLs. No substring or fuzzy matching: anything we cannot resolve to exactly one server returns REVIEW, never a guess. |
| version | string | No | Optional version of the MCP server (semver). A version inside `server` ([email protected]) is used when this is empty. |
Details
From the project READMEDredd MCP — Pre-Flight Security for the MCP Ecosystem
Docs: https://docs.dugganusa.com/agents/dredd/
You do you. I do me. We share contexts.
Everything is context now: data, transport, the TV in your living room. Share the context, never the core. Dredd judges what's about to cross into your agent before it runs: the server, its full dependency tree, and the CVEs published against it. Every verdict is signed, and you get an honest unknown when we couldn't see.
"Jeevesus saves. Dredd judges."
Dredd MCP is a pre-invocation security check for the Model Context Protocol ecosystem. Before your agent calls a tool on any other MCP server, Dredd renders a verdict: BLOCK, ADVISORY, or ALLOW. Every verdict is HMAC-signed and cites the IOC or behavioral signal that drove the decision.
Three PyPI ML packages were compromised in eight days during late April 2026. Twenty-plus MCP-named GitHub repositories were caught serving SmartLoader malware in the wild. The official MCP Registry was clean of those when we measured — but the typosquat surface is wide open.
Dredd is the layer that catches the next compromise before the malicious tool gets called.
What's New — Dependency-Graph Checking (Shai-Hulud class)
Dredd no longer stops at the named server. It walks the transitive dependency graph.
The Shai-Hulud worm taught the ecosystem the hard lesson: the malicious code is rarely in the package you installed — it's three levels down, in a transitive dependency that got its publish token stolen. A check that only vets the server you named is blind to exactly the attack that's been hitting npm and PyPI.
So every preflight now resolves the target server's full npm/pypi dependency graph and joins every transitive package against our continuously updated IOC corpus — including the OSV malicious-package feeds for npm and PyPI. If a known-malicious package is buried anywhere in the tree, Dredd blocks the call before the tool runs.
The verdict is signed (HMAC-SHA256) and now carries a dep_graph field telling you whether transitive supply-chain risk was actually evaluated for that target:
{
"verdict": "BLOCK",
"severity": "critical",
"dep_graph": { "evaluated": true, "packages_checked": 247, "malicious_transitive": 1 },
"signature": "sha256=..."
}
If the server doesn't expose a resolvable manifest, dep_graph.evaluated is false and Dredd drops to the advisory tier — it tells you it couldn't see the tree rather than pretending it's clean.
What Dredd Checks
Every preflight call evaluates these signals:
- Compromised dependency — including transitive (Shai-Hulud class). The target server's package manifest is parsed, its full npm/pypi dependency graph is resolved, and every package — direct and transitive — is joined against our continuously updated IOC corpus (Socket, Aikido, GitGuardian, ReversingLabs, Phylum, StepSecurity, Wiz, plus OSV malicious-package feeds for npm and PyPI). If the server, or anything it pulls in transitively, pins
lightning==2.6.2or any other known-compromised version, the call is blocked. Thedep_graphfield on the verdict reports whether the transitive tree was evaluated. - Tool surface drift. The list of tools the server exposes today versus the snapshot the user originally approved. New tools that appeared since the last review trigger an advisory. Mid-session rugpull is the threat model.
- Remote URL drift. The server's runtime endpoint compared against the URL it published in the registry. A server quietly calling out to a different host than the one you signed up for is a hijack signature.
- Permission escalation. A server requesting write or exec permissions it did not have last week.
The verdict comes back signed in under 200 ms (Cloudflare-edge cached, 5-minute TTL). The hook fails open by default — if our endpoint is ever down, Dredd does not brick your tooling.
Install — Claude Desktop
Add to your claude_desktop_config.json:
{
"mcpServers": {
"dredd": {
"url": "https://analytics.dugganusa.com/api/v1/dredd/mcp"
}
}
}
Restart Claude Desktop. You'll see Dredd available with one tool: check_mcp_server.
Install — Cursor
Add to ~/.cursor/mcp.json:
{
"mcpServers": {
"dredd": {
"url": "https://analytics.dugganusa.com/api/v1/dredd/mcp"
}
}
}
Test from terminal
curl -X POST https://analytics.dugganusa.com/api/v1/dredd/mcp \
-H "Content-Type: application/json" \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'
You should see one tool: check_mcp_server.
The Tool
check_mcp_server
| Argument | Type | Required | Description |
|---|---|---|---|
server | string | yes | MCP server name (e.g. io.github.foo/bar) or substring |
version | string | no | Optional semver of the server |
tool | string | no | Optional name of the specific tool being invoked |
Returns a JSON verdict:
{
"success": true,
"server": "io.github.foo/bar",
"version": "1.2.3",
"tool": "list_files",
"verdict": "ALLOW",
"severity": "clean",
"findings_count": 0,
"findings": [],
"dep_graph": { "evaluated": true, "packages_checked": 247, "malicious_transitive": 0 },
"checked_at": "2026-05-04T20:00:00Z",
"ttl_seconds": 300,
"signature": "sha256=..."
}
Verdict values:
| Verdict | Severity tier | What to do |
|---|---|---|
BLOCK | critical or high | Refuse the invocation. Do not call the target tool. |
ADVISORY | medium or advisory | Surface to the user; let them decide. |
ALLOW | clean | Proceed. |
The signature field is an HMAC-SHA256 of the canonical verdict body using a server-side secret. Hooks should verify this to defeat MITM-forged "all clear" responses (verification key distributed out of band on request).
The Public Watchtower
Real-time aggregate dashboard of every active finding across the registry — free, no auth, no email gate:
https://analytics.dugganusa.com/api/v1/dredd/watchtower.json
Returns counts by severity, recent findings, current verdict (CLEAN / WATCH / HIGH / CRITICAL).
Updated continuously as the daily fetcher + correlator pipeline runs against the registered MCP corpus.
How Dredd Works
┌─────────────────────────────────────────────────┐
│ Your Agent (Claude Desktop / Cursor / custom) │
│ calls check_mcp_server(server, version, tool)│
└─────────────────┬───────────────────────────────┘
│ JSON-RPC over HTTPS
▼
┌────────────────────────────────────────────────┐
│ Dredd MCP — analytics.dugganusa.com/api/v1/dredd/mcp │
│ - look up findings for (server, version, tool)│
│ - aggregate severity, render verdict │
│ - HMAC-sign canonical verdict │
└────────────────┬───────────────────────────────┘
│
▼
┌────────────────────────────────────────────────┐
│ mcp_findings index — populated by │
│ daily fetcher + correlator joining the │
│ resolved transitive dep graph × IOC corpus │
│ (Socket, Aikido, GitGuardian, ReversingLabs, │
│ + OSV malicious-package feeds: npm & PyPI) │
└────────────────────────────────────────────────┘
The correlation cadence today is 12 hours (08:30 UTC and 20:30 UTC). When a real compromise lands in the registered-MCP corpus, cadence tightens.
Trust Posture
- HMAC-signed responses. Hook implementations should verify the
signaturefield on every verdict. - Fail-open by default. If our endpoint is down, Dredd does not brick your tooling — it returns "advisory: backend unavailable" and lets the user decide. Document override (
DREDD_BYPASS=<reason>) for critical workflows. - Read-only. Dredd never modifies your environment. Verdict only.
- Sits beside what you have. Dredd adds one verdict before a tool call; your client's own permission prompts and your own review stay in place.
- No tool argument leakage. Hooks should send
(server, version, tool)only — never the contents of tool arguments. Those stay on your machine. - Validated corpus, not just a big one. The IOC corpus behind every verdict is independently checkable on four live, no-auth endpoints: novelty (
/api/v1/feed-uniqueness, overlap with ThreatFox), timeliness (/api/v1/kev-lead, a live ledger of when each exploited CVE entered our corpus next to its CISA KEV date), accuracy (/api/v1/spamhaus-validation), and liveness (/api/v1/feed-efficacy, opt-in consumer reports of when our indicators actually fire on real traffic — proof the feed is operationally live, not just large). - 95% epistemic ceiling. We cap our claims at 95% per DugganUSA's epistemic humility rule. Coverage gap: about 60-70% of MCP servers in the registry today don't expose a public source repository, which means Dredd cannot inspect their dependency tree. The advisory tier exists for those.
The Family
Dredd is the 13th member of the DugganUSA defender family — and the first MCP-native member:
dugganusa-scanner-core— Core IOC scanning enginedugganusa-vscode— VS Code extensiondugganusa-splunk— Splunk Technology Add-ondugganusa-slack— Slack botdugganusa-raycast— Raycast extensiondugganusa-sentinel— Microsoft Sentinel TAXII connectordugganusa-obsidian— Obsidian plugindugganusa-nvim— Neovim plugindugganusa-elastic— Elastic / OpenSearch integrationdugganusa-edge-shield— Cloudflare Workerdugganusa-cli— CLI scannerdugganusa-chrome— Chrome extensiondugganusa-action— GitHub Action
Companion MCP server: Jeevesus, natural-language search over the DugganUSA corpus (live counts).
License
MIT — see LICENSE.
Support
- Watchtower dashboard: analytics.dugganusa.com/api/v1/dredd/watchtower.json
- Issues: github.com/pduggusa/dredd-mcp/issues
- DugganUSA blog: www.dugganusa.com
Built in Minneapolis. Defender-grade. Read-only. Receipts do the work.
DugganUSA Defender Family
Same DugganUSA Feed, surfaced wherever you live. Open source, MIT licensed, receipts on every repo.
| Plugin | Surface |
|---|---|
| dugganusa-scanner-core | Core IOC scanning engine |
| dugganusa-vscode | VS Code extension |
| dugganusa-splunk | Splunk Technology Add-on |
| dugganusa-slack | Slack bot |
| dugganusa-raycast | Raycast extension |
| dugganusa-sentinel | Microsoft Sentinel TAXII connector |
| dugganusa-obsidian | Obsidian plugin |
| dugganusa-nvim | Neovim plugin |
| dugganusa-elastic | Elastic / OpenSearch integration |
| dugganusa-edge-shield | Cloudflare Worker |
| dugganusa-cli | CLI scanner |
| dugganusa-chrome | Chrome extension |
| dugganusa-action | GitHub Action |
| dredd-mcp (this repo) | Dredd: pre-flight MCP security |
Backed by the DugganUSA Feed. Numbers are live: /api/v1/search/stats. Pricing: analytics.dugganusa.com/stix/pricing. Contact: [email protected].
Threat intelligence you can check.
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.