Skip to content
MCP server

Audit Gap Auditor

Static auditor for MCP server source against OWASP MCP08 logging and audit gaps

Runs locallyStatus and history
Install
Platforms
CLI
Runs
Locally
Version
0.4.1
Listing updated
today

Similar MCP servers

About Audit Gap Auditor

Audit Gap Auditor is an MCP server for security. It runs locally on your machine and is started by your AI client.

Where GuardBee's gateway proxy writes a hash-chained audit log, this package turns the question around and asks whether an MCP server itself leaves a usable, non-leaky trail when a tool runs. It scans source code for four patterns: missing telemetry, unsafe logging, audit disabled in code, and tool errors swallowed by an empty catch.

The README lists six checks. Registering tools with McpServer or FastMCP without any audit mention is rated high, logging a full args or params object is critical, logging whole results is high, audit: false style switches are high, and empty catch blocks and audit rows with no session or request ID are medium. Logging checks only run in files that look like MCP tool servers, so ordinary helper logs are ignored.

Use it from an MCP client through scan_text, scan_file and scan_directory, or as a CLI that writes SARIF and fails on a chosen severity. A guardbee.yml file sets fail-on, max-files and excludes. Telemetry is off by default.

Install

Run in a terminal

claude mcp add audit-gap-auditor -- npx -y @guardbee/mcp-audit-gap-auditor

Add to claude_desktop_config.json

{
  "mcpServers": {
    "audit-gap-auditor": {
      "command": "npx",
      "args": [
        "-y",
        "@guardbee/mcp-audit-gap-auditor"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "audit-gap-auditor": {
      "command": "npx",
      "args": [
        "-y",
        "@guardbee/mcp-audit-gap-auditor"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "audit-gap-auditor": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@guardbee/mcp-audit-gap-auditor"
      ]
    }
  }
}

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

{
  "mcpServers": {
    "audit-gap-auditor": {
      "command": "npx",
      "args": [
        "-y",
        "@guardbee/mcp-audit-gap-auditor"
      ]
    }
  }
}

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

{
  "mcpServers": {
    "audit-gap-auditor": {
      "command": "npx",
      "args": [
        "-y",
        "@guardbee/mcp-audit-gap-auditor"
      ]
    }
  }
}

Using several servers? Build one config file with the MCP config generator.

Tools this server provides (4)

Taken from the project documentation; the running server may differ.

scan_text
Scans a source string
scan_file
Scans one file
scan_directory
Scans a directory recursively
list_patterns
Lists the MCP08 checks

What it does

Six MCP08 checks
Missing tool audit, raw args or results in logs, disabled audit, swallowed errors and missing correlation IDs.
Severity ratings
Each pattern is rated critical, high or medium.
Scoped logging checks
Only runs log checks on files that look like MCP tool servers.
Four scan tools
`scan_text`, `scan_file`, `scan_directory` and `list_patterns`.
CI output
CLI supports `--fail-on` and SARIF output.
Config file
`guardbee.yml` sets thresholds, file caps and excluded paths.

Good for

  • Review an MCP server's source before publishing it
  • Catch tool handlers that log raw arguments or secrets
  • Fail a CI build when an MCP server has no audit trail
  • Find tool errors that are silently swallowed

Audit Gap Auditor FAQ

What standard does it check?

OWASP MCP08:2025, lack of audit and telemetry.

What does it flag as critical?

Logging the full args, params or input object of a tool call.

How do I run it in CI?

`npx @guardbee/mcp-audit-gap-auditor scan ./src --fail-on=high --format=sarif`.

Is telemetry sent?

Telemetry is off by default and only enabled with `GUARDBEE_TELEMETRY=1`.

How do I add Audit Gap Auditor to Claude Code?

Run this command in your terminal: claude mcp add audit-gap-auditor -- npx -y @guardbee/mcp-audit-gap-auditor

What are the best alternatives to Audit Gap Auditor?

The closest alternatives to Audit Gap Auditor are REA, Context7, Chrome DevTools MCP, Codebase Memory and GitHub.

Where this comes from

  • Description: written from the project's README.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers