Skip to content
MCP server

mcpgawk

A local gateway that holds agent calls to MCP tools that changed after you approved them

Runs locallyStatus and history
Install
Pricing
Freemium
Platforms
CLI, self-hosted
Runs
Locally
Version
0.1.92
Listing updated
3 days ago

About mcpgawk

mcpgawk is a freemium MCP server for security. It runs locally on your machine and is started by your AI client.

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.

Install

Run in a terminal

claude mcp add mcpgawk -- uvx mcpgawk

Add to claude_desktop_config.json

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

Add to ~/.cursor/mcp.json

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

Add to .vscode/mcp.json

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

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

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

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

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

What it does

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

Pricing

Freemium

Free local guard; paid gateway per person with a 7-day trial

Prices change. Check mcp.gawk.dev before you buy.

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 to mcpgawk

  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