Approval Gate MCP
Fail-closed human approval gates for agent actions, with expiry and audit log
- Pricing
- Open source
- Platforms
- CLI, Linux, macOS
- Runs
- Locally
- Version
- 0.4.1
- Listing updated
- today
Similar MCP servers
About Approval Gate MCP
Approval Gate MCP is an open-source MCP server for security. It runs locally on your machine and is started by your AI client.
This server records a request for a consequential action, such as sending an email, deleting or deploying, and waits for a human to decide. The decision is made out of band: approvals come from a CLI in your own terminal, not through MCP, so an agent cannot approve its own request unless an operator opts in with APPROVAL_GATE_ALLOW_MCP_APPROVE=1.
Approvals expire (default one hour), are single-use and can bind an exact action text plus an operation name and canonical JSON payload. Only a successful consume authorizes anything; an approved status alone does not. Every request, decision, expiry and consumption is appended to ~/.approval-gate/audit.jsonl, which the README describes as an append-only convention rather than a tamper-proof log.
The README is blunt about limits: the gate never executes anything, and trusted executor code must enforce it, for instance with executeApproved around the send function. An agent that can use a shell or another tool can bypass it. It needs Node.js 22 or later and is MIT licensed.
Install
Run in a terminal
claude mcp add approval-gate-mcp -- npx -y @itcustomsolution/approval-gate-mcpAdd to claude_desktop_config.json
{
"mcpServers": {
"approval-gate-mcp": {
"command": "npx",
"args": [
"-y",
"@itcustomsolution/approval-gate-mcp"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"approval-gate-mcp": {
"command": "npx",
"args": [
"-y",
"@itcustomsolution/approval-gate-mcp"
]
}
}
}Add to .vscode/mcp.json
{
"servers": {
"approval-gate-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@itcustomsolution/approval-gate-mcp"
]
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"approval-gate-mcp": {
"command": "npx",
"args": [
"-y",
"@itcustomsolution/approval-gate-mcp"
]
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"approval-gate-mcp": {
"command": "npx",
"args": [
"-y",
"@itcustomsolution/approval-gate-mcp"
]
}
}
}Using several servers? Build one config file with the MCP config generator.
Tools this server provides (6)
Taken from the project documentation; the running server may differ.
- request_approval
- Register an intended action with optional operation and payload
- check_approval
- Poll a request's status
- wait_for_approval
- Block until a decision or timeout
- list_pending
- List requests awaiting a human
- consume_approval
- Single-use consume right before acting
- decide_approval
- Deny a pending request or revoke an unconsumed approval
What it does
- Default-deny approvals
- Pending, denied, expired, timed-out and errored states all mean no.
- Single-use consume
- consume_approval succeeds once, only for the exact approved action.
- Payload binding
- Requests can bind an operation name and canonical JSON payload with a digest.
- Out-of-band decisions
- Humans approve or deny from a terminal CLI, not inside the agent.
- TTL expiry
- Requests expire after one hour by default.
- Audit trail
- Each step is appended to a JSONL log in the home folder.
Good for
- Require sign-off before an agent sends customer email
- Gate deployments or deletions behind a human decision
- Keep a log of who approved which agent action
- Tie an approval to an exact payload
Pricing
Open source
MIT licence
Approval Gate MCP FAQ
Can an agent approve its own request?
No by default. Approving through MCP is refused unless an operator sets APPROVAL_GATE_ALLOW_MCP_APPROVE=1, which the README does not recommend.
Is it a security boundary?
No. The README says it is not one against processes with the same OS-user privileges, and trusted code must enforce the consume step.
What does it need to run?
Node.js 22 or later.
Where is the audit log?
In ~/.approval-gate/audit.jsonl.
Is Approval Gate MCP free?
Yes. Approval Gate MCP is open source, so you can use and self-host it for free.
How do I add Approval Gate MCP to Claude Code?
Run this command in your terminal: claude mcp add approval-gate-mcp -- npx -y @itcustomsolution/approval-gate-mcp
What are the best alternatives to Approval Gate MCP?
The closest alternatives to Approval Gate MCP are REA, AiSOC, redamon, x64dbg-mcp-server and Agent Roast.
Where this comes from
- Description: written from the project's README.
- Install steps: from the official MCP Registry entry.



