# mcp-audit

> mcp-audit is an open-source MCP server for security. Scan, list and risk-score the MCP servers configured on your machine. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, macOS, Windows, Linux
- **Repository:** https://github.com/saagpatel/mcpaudit
- **MCP Registry name:** io.github.saagpatel/mcp-audit
- **Categories:** [security](https://ai-powered.com/categories/security)
- **Listing updated:** 2026-11-18

## About

MCPAudit reviews the MCP server configuration your AI tools already use and shows what each server can reach. The default check is static: it reads configs without connecting. Optional connected checks can start configured local programs or contact configured endpoints, and package verification, downloads and LLM analysis are separate opt-ins. It never edits configs and reports environment variable names, never their values.

Findings highlight declared capabilities, text that looks like instructions to a model, and changes against a saved pin. The README stresses that a high score means broader capability exposure, not that a server is malicious, and that a clean report is not a safety certificate. Each rule has an offline explanation reachable with the explain command.

It installs as the mcp-audits package for Python 3.11 or newer and can write SARIF and evaluate local policy files, with a GitHub Action for code scanning. A checkup command creates a local counts-only share card.

## Features

- **Static config review:** Reviews MCP configs without connecting by default.
- **Connected listing:** Optionally lists a server's tools after you opt in.
- **Risk scoring:** Scores declared capability exposure and flags instruction-like text.
- **Pinned baselines:** Detects changes from a saved pin.
- **CI output:** Writes SARIF and evaluates policy files.
- **Offline explanations:** Explains each finding rule without reading configs.

## Good for

- Audit which servers your assistants can reach
- Add MCP checks to a CI pipeline
- Spot a server whose tools changed since last review
- Generate a counts-only checkup card

## Install

### Claude Code (Terminal)

```sh
claude mcp add mcp-audit -- uvx mcp-audits
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "mcp-audit": {
      "command": "uvx",
      "args": [
        "mcp-audits"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "mcp-audit": {
      "command": "uvx",
      "args": [
        "mcp-audits"
      ]
    }
  }
}
```

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

```json
{
  "servers": {
    "mcp-audit": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "mcp-audits"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "mcp-audit": {
      "command": "uvx",
      "args": [
        "mcp-audits"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "mcp-audit": {
      "command": "uvx",
      "args": [
        "mcp-audits"
      ]
    }
  }
}
```

## FAQ

### Does it connect to my servers?

Not by default. Connecting needs the check --connect or --connect-all options.

### Does it expose my secrets?

It reports environment variable key names, never values, though redaction in reports is best-effort.

### What does a high score mean?

Broader capability exposure, not that a server is unsafe.

### How do I install it?

With uv tool install mcp-audits; the command is mcp-audit.

### Is mcp-audit free?

Yes. mcp-audit is open source, so you can use and self-host it for free.

### How do I add mcp-audit to Claude Code?

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

### What are the best alternatives to mcp-audit?

The closest alternatives to mcp-audit are REA, AiSOC, redamon, x64dbg-mcp-server and Agent Roast.

## 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.
- [AiSOC](https://ai-powered.com/mcp/aisoc): AiSOC is an open-source MCP server for ai models and llm tooling.
- [redamon](https://ai-powered.com/mcp/redamon): redamon is an open-source MCP server for ai models and llm tooling.
- [x64dbg-mcp-server](https://ai-powered.com/mcp/x64dbg-mcp-server): x64dbg-mcp-server is an open-source MCP server for ai models and llm tooling.
- [Agent Roast](https://ai-powered.com/mcp/agent-roast): Agent Roast is an open-source MCP server for developer tools.
- [Midplane](https://ai-powered.com/mcp/midplane): Midplane is an open-source MCP server for databases.
- [Leash](https://ai-powered.com/mcp/leash): Leash is a free MCP server for security.
- [Cisa Kev](https://ai-powered.com/mcp/cisa-kev): Cisa Kev is a freemium MCP server for security.

---
Source: https://ai-powered.com/mcp/mcp-audit-2
