mcp-warden
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
mcp-warden
A security gateway for the Model Context Protocol.
An AI agent that can call tools can be talked into calling the wrong ones. A poisoned tool
description, an instruction hidden in a file the agent reads, a server that quietly changes a
tool after you approved it: each of these turns the model into the attacker's hands. mcp-warden
sits between MCP clients (Claude Desktop, Cursor, the MCP Inspector, your own agent) and the MCP
servers they use. To a client it is one MCP server; to the servers it is one MCP client. Every
tools/list and tools/call crosses a fixed security pipeline, and anything it cannot check -
because Redis is down, the audit log is unwritable, a scanner crashed - is denied, not waved
through.
No paid LLM API anywhere. The gateway never calls a model; the one ML component is an optional local prompt-injection classifier.
How a call flows
flowchart LR
C[MCP client] -->|HTTPS + Bearer| E[size, batch &<br/>host checks]
E --> A[authenticate]
A --> R[resolve<br/>server__tool]
R --> I[definition integrity<br/>pinned? quarantined?]
I --> P[policy<br/>allow/deny + argument constraints]
P --> L[rate limit<br/>+ daily budget]
L --> D[argument DLP]
D --> H{risky?}
H -->|destructive| AP[human approval]
H -->|no| F
AP --> F[forward to upstream<br/>with timeout]
F --> O[output scan<br/>rules + optional classifier]
O --> RES[result]
subgraph always
AU[(hash-chained<br/>audit log)]
end
A -.-> AU
P -.-> AU
F -.-> AU
O -.-> AU
F --- U1[notes_db]
F --- U2[files]
F --- U3[any MCP server]Every denial is an ordinary MCP tool result with isError: true and a machine-readable reason:
WARDEN_DENIED:policy, WARDEN_DENIED:rate_limit, WARDEN_DENIED:dlp,
WARDEN_DENIED:injection, WARDEN_DENIED:quarantined, WARDEN_PENDING:approval, ... -
together with the rule that decided it and a request id you can look up in the audit log.
Related MCP server: border-patrol-mcp
Features
Authentication - API keys (stored as hashes) and ES256 JWTs with rotation, revocation and a published JWKS. The caller's credential is never forwarded to an upstream.
Deny-by-default policy - per-role allow/deny rules on namespaced tools, with argument constraints (normalised path prefixes, lengths, ranges, regexes, enumerations). An omitted argument is filled from the pinned schema's default and checked like any other, so what is checked is what is forwarded.
tools/listonly shows what you may call. Hot reload that keeps the old policy if the new one is broken.Tool-definition integrity - every definition is hashed and pinned. A poisoned description or a later change (a rug pull) quarantines the tool; untrusted servers start fully quarantined until an admin approves.
Injection and exfiltration scanning - definitions, arguments and results, including zero-width, bidi, base64 and non-English tricks. Secrets in arguments are refused before they leave (
WARDEN_DENIED:dlp).Human approval - destructive calls wait for a person, through a CSRF-protected, strict-CSP web UI. Approvals are bound to the exact arguments, single-use, and cannot be self-granted.
Rate limits and budgets - atomic Redis token buckets per caller and per tool, plus daily and destructive-call budgets.
Audit log - insert-only, SHA-256 hash-chained, written before a call is forwarded; if it cannot be written the call does not happen.
warden audit verifyfinds any edited, deleted, reordered or forged row.Observability - OpenTelemetry traces per pipeline stage, Prometheus metrics, a Grafana dashboard. No arguments or credentials in spans or labels.
Hardened by default - request body and JSON-RPC batch limits, DNS-rebinding protection, bounded I/O on every dependency, a non-root read-only container.
Quickstart
Needs Docker and Node.js. On a fresh Mac:
git clone https://github.com/tarun0648/mcp-warden.git && cd mcp-wardencp .env.example .envmake up-alldocker compose exec gateway warden keys create --user you --roles editornpx -y @modelcontextprotocol/inspector --cli http://localhost:8080/mcp --transport http --method tools/list --header "Authorization: Bearer <the key printed above>"make up-all builds the gateway image and starts it with its upstreams, Postgres, Redis,
Jaeger, Prometheus and Grafana; it prints where each one is. Then try a call the policy refuses,
and look it up:
npx -y @modelcontextprotocol/inspector --cli http://localhost:8080/mcp --transport http --method tools/call --tool-name files__read_file --tool-arg 'path=../../etc/passwd' --header "Authorization: Bearer <key>"docker compose exec gateway warden audit tail --limit 5Connecting Cursor, Claude Desktop or the Inspector's web UI - including what does not work - is in docs/clients.md.
Demo video: not recorded yet. Until it is, the transcripts in results/demo-*.md show the
five attack scenarios end to end.
Results
Every number here is generated from results/ by make readme-results, which reads the files
the red-team runner, the benchmark, the soak test and the demo scenarios wrote. None of it is
typed by hand, and a test fails if it goes stale.
Red team - results/redteam-2026-11-14.md
Configuration | Attacks blocked | Attack categories | Benign allowed | False positives |
rules only | 67/67 (100.0%) | 12 | 62/62 | 0.0% |
rules + classifier | 67/67 (100.0%) | 12 | 61/62 | 1.6% |
Latency added by the gateway - results/bench-2026-11-14.md - 1000 calls of notes_db__get_note per measurement on Apple M4
Direct to the upstream, one call at a time: p50 0.93 ms. Added on top of that:
Configuration | Concurrency | p50 added (ms) | p95 added (ms) | p99 added (ms) |
auth+policy | 1 | 2.11 | 2.15 | 2.26 |
auth+policy | 10 | 17.50 | 20.38 | 62.82 |
auth+policy | 50 | 96.64 | 138.38 | 201.74 |
full (rules) | 1 | 3.53 | 3.65 | 4.11 |
full (rules) | 10 | 31.56 | 36.25 | 78.98 |
full (rules) | 50 | 163.75 | 216.58 | 228.49 |
full (classifier) | 1 | 34.36 | 34.89 | 35.77 |
full (classifier) | 10 | 334.24 | 439.46 | 533.45 |
full (classifier) | 50 | 2052.81 | 2201.49 | 2238.32 |
Soak - results/soak-2026-11-14.md - 30 min at 20 calls/s
Calls | Errors | Unexpected | p50 ms | p95 ms | p99 ms | RSS start -> end (MiB) | RSS trend | Audit chain |
36000 | 0 | 0 | 22.01 | 28.06 | 29.66 | 202.47 -> 251.42 | 116.57 MiB/h whole run; 3.46 MiB/h second half | verified, 68408 rows |
Attack scenarios - scripted model, so every run actually attempts the attack - results/demo-*.md
Scenario | Runs as required | Forbidden calls attempted | Refused | Gateway decision |
5/5 | 0 | 0 | allowed, as it should be | |
5/5 | 5 | 5 |
| |
5/5 | 5 | 5 |
| |
5/5 | 5 | 5 |
| |
5/5 | 5 | 5 |
|
Container images - results/images-2026-11-14.json - rules-only 103.9 MiB compressed (483MB unpacked); with-ml 3269.2 MiB compressed (9.77GB unpacked)
Development
brew install uv
make setup # venv with every dependency group, pre-commit hooks
make up # postgres, redis, jaeger for a gateway run on the host
make run # the gateway on http://localhost:8080/mcp
make test # unit + integrationTarget | What it does |
| ruff, ruff format --check, mypy --strict |
| unit + integration / every layer including e2e, ml, redteam, perf |
| bandit, and pip-audit over the locked dependencies |
| every attack and benign case in |
| latency overhead / 30 minutes under load, to |
| the five attack scenarios; |
| regenerate the table above |
| the whole stack in containers / stop it |
Optional: uv sync --extra ml for the local classifier, brew install ollama and
ollama pull qwen2.5:7b for the real-model demo.
Limitations
The full list, with the reasoning, is in docs/threat-model.md. The ones that matter most:
The classifier is weak. On this project's own measurements it adds no detection over the rules and costs false positives, so it ships off and can never block on its own.
Rules catch the attacks they were written for. A novel phrasing that matches no rule gets through the scanners; policy, approvals and the audit log are the layers that assume so.
Approval fatigue is a human problem. The gateway can require an approval; it cannot make someone read it.
No OAuth authorization server. Clients need a pre-issued key or token in a header.
Single node. Approval sessions are in memory.
Stdio upstreams run as the gateway's user. Put an untrusted server behind HTTP in its own container.
Roadmap
Delegate token issuance to an external OAuth 2.1 server; drop the development issuer.
Pin the audit head hash somewhere the gateway cannot write.
Shared approval sessions for more than one gateway node.
A CPU-only torch build for a smaller classifier image.
Documentation
components, protocol version, the pipeline in detail | |
assets, boundaries, STRIDE per component with the test behind every mitigation, known gaps | |
every non-obvious choice and every finding, phase by phase | |
connecting real clients, and what was verified | |
release notes | |
how to change this safely |
License
MIT. See LICENSE.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
MCP gateway with runtime security policy, tool-call-level control, and audit of agent actions.
Safety gateway for MCP tools: checks every call, holds risky ones for approval, hides personal data
1Security & DLP proxy for MCP: tool-poisoning scans, PII redaction on tool args/results. Beta.
Find, vet, and run MCP tools through a secure audited gateway with prompt-injection risk scoring
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceA security gateway for MCP servers that enforces policy checks including role-based access, argument constraints, injection scanning, and PII redaction on both tool arguments and results, with tamper-evident audit logging.MIT
- AlicenseNot gradedqualityDmaintenanceA policy-enforcing MCP gateway that intercepts all tool calls to downstream MCP servers, applying allow/deny/ask rules with human approval and audit logging for safe access to dangerous tools.7 npmMIT
- AlicenseNot gradedqualityDmaintenanceA least-privilege enforcement proxy for MCP servers. It sits between MCP clients and upstream servers, enforcing tool policies, hiding denied tools, requiring human approval for risky actions, and providing a structured audit trail.MIT
- AlicenseAqualityCmaintenanceProvides a security governance layer for AI agents to safely access upstream MCP servers, enforcing tool-level RBAC, parameter constraints, authentication via static tokens or OIDC, and tamper-evident audit logging.21Apache 2.0