# Approval Gate MCP

> Approval Gate MCP is an open-source MCP server for security. Fail-closed human approval gates for agent actions, with expiry and audit log. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, Linux, macOS, Windows
- **Repository:** https://github.com/itcustomsolution/approval-gate-mcp
- **MCP Registry name:** io.github.itcustomsolution/approval-gate-mcp
- **Categories:** [security](https://ai-powered.com/categories/security)
- **Listing updated:** 2026-11-18

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
claude mcp add approval-gate-mcp -- npx -y @itcustomsolution/approval-gate-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "approval-gate-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@itcustomsolution/approval-gate-mcp"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "approval-gate-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@itcustomsolution/approval-gate-mcp"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "approval-gate-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@itcustomsolution/approval-gate-mcp"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "approval-gate-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@itcustomsolution/approval-gate-mcp"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "approval-gate-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@itcustomsolution/approval-gate-mcp"
      ]
    }
  }
}
```

## Tools

- `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

## 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.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [AiSOC](https://ai-powered.com/mcp/aisoc): AiSOC is an open-source MCP server for ai models and llm tooling.
- [redamon](https://ai-powered.com/mcp/redamon): redamon is an open-source MCP server for ai models and llm tooling.
- [x64dbg-mcp-server](https://ai-powered.com/mcp/x64dbg-mcp-server): x64dbg-mcp-server is an open-source MCP server for ai models and llm tooling.
- [Agent Roast](https://ai-powered.com/mcp/agent-roast): Agent Roast is an open-source MCP server for developer tools.
- [Midplane](https://ai-powered.com/mcp/midplane): Midplane is an open-source MCP server for databases.
- [Leash](https://ai-powered.com/mcp/leash): Leash is a free MCP server for security.
- [Cisa Kev](https://ai-powered.com/mcp/cisa-kev): Cisa Kev is a freemium MCP server for security.

---
Source: https://ai-powered.com/mcp/approval-gate-mcp
