Skip to content
MCP server

Approval Gate MCP

Fail-closed human approval gates for agent actions, with expiry and audit log

Runs locallyStatus and history
Install
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-mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "approval-gate-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@itcustomsolution/approval-gate-mcp"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "approval-gate-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@itcustomsolution/approval-gate-mcp"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

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.

How AIPoweredBot checks servers