# Audit Gap Auditor

> Audit Gap Auditor is an MCP server for security. Static auditor for MCP server source against OWASP MCP08 logging and audit gaps. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Platforms:** CLI
- **Repository:** https://github.com/guardbee/guardbee-mcp/tree/HEAD/packages/audit-gap-auditor
- **MCP Registry name:** io.github.GuardBee/audit-gap-auditor
- **Categories:** [security](https://ai-powered.com/categories/security), [developer tools](https://ai-powered.com/categories/developer-tools)
- **Listing updated:** 2026-11-18

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (claude_desktop_config.json)

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

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

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

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

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

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

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

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

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

## Tools

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

## 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.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Context7](https://ai-powered.com/mcp/context7): Context7 is a freemium MCP server for developer tools.
- [Chrome DevTools MCP](https://ai-powered.com/mcp/chrome-devtools-mcp-2): Chrome DevTools MCP is an open-source MCP server for browser automation.
- [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.
- [awesome-mcp-servers](https://ai-powered.com/mcp/awesome-mcp-servers-2): awesome-mcp-servers 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.

---
Source: https://ai-powered.com/mcp/audit-gap-auditor
