# mcp-gatehouse

> mcp-gatehouse is an open-source MCP server for security. Python library that adds permission tiers, approval gates and audit logs to MCP servers. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** self-hosted, CLI
- **Website:** https://nickgeorgeai.com/open-source/mcp-gatehouse
- **Repository:** https://github.com/nickgeorgeseo/mcp-gatehouse
- **MCP Registry name:** io.github.nickgeorgeseo/gatehouse
- **Categories:** security, developer tools
- **Listing updated:** 2026-11-14

## About

Gatehouse is a library you drop into your own MCP server rather than a server of its own. You register each tool through it and label the tool READ, WRITE or DESTRUCTIVE. By default only destructive tools need a person's yes, and one line adds WRITE. The tier also sets honest tool annotations such as readOnlyHint and destructiveHint, which the wrapper will not let you override to mislead a client.

Approvals can come from a form in the MCP client itself (Claude Code, Cursor, VS Code), a terminal prompt, or any function you write, such as a Slack message or a ticket. It fails closed: a gated tool with no approver, a broken approver or an unanswered request is refused, and the model is told why. A denylist blocks named tools outright.

Every call, whether allowed, denied, failed or cancelled, adds a line to an append-only JSONL audit log with UTC timestamps and durations. Argument keys such as api_key or password are masked before reaching the log or the approver. It needs Python 3.10 or newer, depends only on the official MCP SDK and is MIT licensed.

## Features

- **Permission tiers:** Declare each tool READ, WRITE or DESTRUCTIVE, with matching MCP annotations.
- **Approval gates:** Ask in the client, in a terminal or through your own Slack or ticket function.
- **Fails closed:** Missing, broken or slow approvers lead to a refused call, not a waved-through one.
- **Audit log:** Append-only JSONL with one line per call and its outcome.
- **Secret redaction:** Named argument keys are masked in the log and in approval prompts.
- **Denylist:** Block specific tools regardless of tier.

## Good for

- Require sign-off before an agent cancels or deletes records
- Keep a record of what an AI did in business systems
- Mask API keys in logs and approval forms
- Route approvals to Slack or a ticketing system
- Mark read-only lookups so they run unattended

## Install

### Claude Code (Terminal)

```sh
claude mcp add gatehouse -- uvx mcp-gatehouse
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "gatehouse": {
      "command": "uvx",
      "args": [
        "mcp-gatehouse"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "gatehouse": {
      "command": "uvx",
      "args": [
        "mcp-gatehouse"
      ]
    }
  }
}
```

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

```json
{
  "servers": {
    "gatehouse": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "mcp-gatehouse"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "gatehouse": {
      "command": "uvx",
      "args": [
        "mcp-gatehouse"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "gatehouse": {
      "command": "uvx",
      "args": [
        "mcp-gatehouse"
      ]
    }
  }
}
```

## FAQ

### Does it need a proxy or policy service?

No. The gate is enforced inside your server and depends only on the official MCP SDK.

### What happens if nobody approves?

The call is refused, as it is when no approver is set up or the approver fails.

### How do I install it?

Run pip install mcp-gatehouse; it needs Python 3.10 or newer.

### What licence is it under?

MIT.

### Is mcp-gatehouse free?

Yes. mcp-gatehouse is open source, so you can use and self-host it for free.

### How do I add mcp-gatehouse to Claude Code?

Run this command in your terminal: claude mcp add gatehouse -- uvx mcp-gatehouse

### What are the best alternatives to mcp-gatehouse?

The closest alternatives to mcp-gatehouse are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/mcp-gatehouse
