mcp-gatehouse
Python library that adds permission tiers, approval gates and audit logs to MCP servers
- 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-gatehouseAdd to claude_desktop_config.json
{
"mcpServers": {
"gatehouse": {
"command": "uvx",
"args": [
"mcp-gatehouse"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"gatehouse": {
"command": "uvx",
"args": [
"mcp-gatehouse"
]
}
}
}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

REA
MCP serverCLI and MCP server that lets coding agents reverse engineer apps and binaries
Runs locally- Open source
- 464K GitHub stars
- Developer tools

Codebase Memory
MCP serverLocal MCP server that builds a code knowledge graph for AI coding agents
Runs locally- Open source
- 48.7K GitHub stars
- Knowledge and memory

GitHub
MCP serverOfficial MCP server connecting AI assistants to GitHub repos, issues and workflows
Not checked yet- Remote
- Open source
- 34.5K GitHub stars
- Developer tools

Serena MCP: the IDE for your agent
MCP serverMCP toolkit giving coding agents symbol-level code retrieval and editing
Runs locally- Open source
- 31.5K GitHub stars
- Developer tools

XERJ
MCP serverLocal search engine for AI agents with cited answers over your code and docs
Runs locally- Open source
- 19.2K GitHub stars
- Knowledge and memory

Ouroboros
MCP serverSpec-first layer that pins requirements and verifies results of AI coding agent work
Runs locally- Open source
- 6.4K GitHub stars
- Developer tools