Skip to content
MCP server

mcp-gatehouse

Python library that adds permission tiers, approval gates and audit logs to MCP servers

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
self-hosted, CLI
Runs
Locally
Version
0.6.1
Listing updated
3 days ago

About mcp-gatehouse

mcp-gatehouse is an open-source MCP server for security. It runs locally on your machine and is started by your AI client.

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.

Install

Run in a terminal

claude mcp add gatehouse -- uvx mcp-gatehouse

Add to claude_desktop_config.json

{
  "mcpServers": {
    "gatehouse": {
      "command": "uvx",
      "args": [
        "mcp-gatehouse"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "gatehouse": {
      "command": "uvx",
      "args": [
        "mcp-gatehouse"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

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

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

What it does

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

Pricing

Open source

MIT licence, free

Prices change. Check nickgeorgeai.com before you buy.

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 to mcp-gatehouse

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  3. GitHub

    MCP server

    Official MCP server connecting AI assistants to GitHub repos, issues and workflows

    Not checked yet
    • Remote
    • Open source
    • 34.5K GitHub stars
    • Developer tools
  4. MCP toolkit giving coding agents symbol-level code retrieval and editing

    Runs locally
    • Open source
    • 31.5K GitHub stars
    • Developer tools
  5. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory
  6. Ouroboros

    MCP server

    Spec-first layer that pins requirements and verifies results of AI coding agent work

    Runs locally
    • Open source
    • 6.4K GitHub stars
    • Developer tools