MCP Guard
MCP proxy that enforces YAML policies on agent tool calls and signs decisions.
Tested on Linux
Use it
Linux x86_64
Install mcp-guard globally via npm
npm install -g @permission-protocol/mcp-guard
Check that it works
mcp-guard --helpThe output should contain “mcp-guard — MCP policy proxy”.
First thing to try
mcp-guard demoAdd it to your agent
claude mcp add mcp-guard -- mcp-guard --config pp.config.yaml -- node my-mcp-server.jsJSON for Claude Desktop, Cursor and other clients
{
"mcpServers": {
"mcp-guard": {
"command": "mcp-guard",
"args": [
"--config",
"pp.config.yaml",
"--",
"node",
"my-mcp-server.js"
]
}
}
}Run mcp-guard demo to see the proxy in action with sample tools.
What it does
- Block unsafe tool calls before they runNot shown working
- Hold sensitive actions for human approvalNot shown working
- Sign decisions as Ed25519 receiptsNot shown working
- Audit policies in observe modeNot shown working
How far pickfit got
Linux x86_64
- Installs
- Connects
- 0 of 4 features work
- Works offline
Good for
- block deletion of user data
- require approval for production deploys
- audit what would be blocked in observe mode
An alternative to API gateway and RBAC / IAM.
How pickfit tested it
Each run starts from a clean machine and follows the steps above. How pickfit verifies
Linux x86_64
An MCP client called one of its tools
- Replayed from scratch
- Works offline
- Checked on 30 Oct 2026
An MCP client handshake over stdio listed 3 tools, and a call to safe_tool returned a result.
Differences the test machine hit
- README: npm install @permission-protocol/mcp-guard
In the test: npm install -g @permission-protocol/mcp-guard so mcp-guard is on PATH (~/.local/bin) - README: mcp-guard --config pp.config.yaml -- node my-mcp-server.js
In the test: mcp-guard keys init before first run; guard refuses to start with SIGNING_KEY_MISSING - README: enforce blocks/holds per rules
In the test: use mode: observe (or --mode observe) so blocked/held tools still forward and probe reports tools/call: ok; in enforce blocked returns -32001 and held returns -32002