# mcpgawk

> mcpgawk is a freemium MCP server for security. A local gateway that holds agent calls to MCP tools that changed after you approved them. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Platforms:** CLI, self-hosted
- **Website:** https://mcp.gawk.dev
- **Repository:** https://github.com/gawk-dev/mcpgawk
- **MCP Registry name:** io.github.gawk-dev/mcpgawk
- **Categories:** security, developer tools
- **Listing updated:** 2026-11-14

## About

mcpgawk is aimed at a specific risk: an MCP server you approved later ships an update that adds or rewrites a tool, and your agent calls it without noticing. mcpgawk records a baseline of what each server offered when you said yes, checks every call against it, and stops calls to tools that changed. The refusal names no override, so the agent's only move is to tell you; only the person at the keyboard can approve the change.

It runs on your machine and uploads nothing, keeping two files and a local page. The site says a hook covers six agents including Claude Code, Codex, Cursor and Gemini CLI, while fifteen others have no hook point and need the paid gateway. The README also describes verify, which drives tools in a sandbox, and shows what each server could reach and what its tools cost in context.

The guard is free and Apache-2.0; the Platform, per person for up to 3 machines with a 7-day trial, adds a gateway with per-agent keys, policy and an audit log.

## Features

- **Baseline pinning:** Records the tools each server offered when you approved it.
- **Blocks changed tools:** Calls to tools that changed since approval are held.
- **Human-only approval:** Only the person at the keyboard can approve a change.
- **Local-first:** Nothing about servers, tools or calls is uploaded.
- **Sandbox verification:** verify drives tools in a sandbox and reports what they did.
- **Context cost view:** See what each server costs in context.

## Good for

- Catch a tool added by a server update
- Audit which MCP servers your agents can reach
- Keep a log of every approved call
- Put one gateway in front of a team's agents
- Gate MCP changes in CI

## Install

### Claude Code (Terminal)

```sh
claude mcp add mcpgawk -- uvx mcpgawk
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "mcpgawk": {
      "command": "uvx",
      "args": [
        "mcpgawk"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "mcpgawk": {
      "command": "uvx",
      "args": [
        "mcpgawk"
      ]
    }
  }
}
```

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

```json
{
  "servers": {
    "mcpgawk": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "mcpgawk"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "mcpgawk": {
      "command": "uvx",
      "args": [
        "mcpgawk"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "mcpgawk": {
      "command": "uvx",
      "args": [
        "mcpgawk"
      ]
    }
  }
}
```

## FAQ

### Is it free?

The guard is free and open source under Apache-2.0; the gateway is a paid per-person subscription with a 7-day trial.

### Does it send my data anywhere?

The site says nothing about your servers, tools or calls is uploaded.

### Which agents does the free hook cover?

The site says six agents that can take a hook; the other fifteen need the gateway.

### What happens when a tool changes?

The call is stopped, the agent tells you why, and you decide.

### Is mcpgawk free?

mcpgawk has a free plan, with paid plans for more usage or features.

### How do I add mcpgawk to Claude Code?

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

### What are the best alternatives to mcpgawk?

The closest alternatives to mcpgawk 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/mcpgawk
