# agent-audit MCP server

> Converts Google Lighthouse audits into structured, actionable fix packs for AI coding agents to improve web performance, SEO, and accessibility.

- Repository: https://github.com/fullstackdegen/agent-audit
- Page: https://hostedmcp.org/servers/fullstackdegen/agent-audit
- Transport: stdio
- Stars: 4
- License: MIT
- Latest version: 0.3.1

## Install

### Claude Code

```sh
claude mcp add agent-audit -- npx -y @fullstackdegen/agent-audit
```

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

```json
{
  "mcpServers": {
    "agent-audit": {
      "command": "npx",
      "args": [
        "-y",
        "@fullstackdegen/agent-audit"
      ]
    }
  }
}
```

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

```json
{
  "servers": {
    "agent-audit": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@fullstackdegen/agent-audit"
      ]
    }
  }
}
```

### VS Code CLI

```sh
code --add-mcp '{"name":"agent-audit","type":"stdio","command":"npx","args":["-y","@fullstackdegen/agent-audit"]}'
```

### Claude Desktop (`claude_desktop_config.json`)

```json
{
  "mcpServers": {
    "agent-audit": {
      "command": "npx",
      "args": [
        "-y",
        "@fullstackdegen/agent-audit"
      ]
    }
  }
}
```

### Codex

```sh
codex mcp add agent-audit -- npx -y @fullstackdegen/agent-audit
```

### Codex config.toml (`~/.codex/config.toml`)

```toml
[mcp_servers.agent-audit]
command = "npx"
args = ["-y", "@fullstackdegen/agent-audit"]
```

### Gemini CLI

```sh
gemini mcp add -s user agent-audit npx -- -y @fullstackdegen/agent-audit
```

### Gemini settings.json (`~/.gemini/settings.json`)

```json
{
  "mcpServers": {
    "agent-audit": {
      "command": "npx",
      "args": [
        "-y",
        "@fullstackdegen/agent-audit"
      ]
    }
  }
}
```

## Environment variables

| Name | Required | Secret | Description |
|---|---|---|---|
| `LIGHTHOUSE_CHROME_NO_SANDBOX` | no | no |  |
| `LIGHTHOUSE_MCP_ALLOW_LOCALHOST` | no | no |  |

## Tools (2)

- `fast`
- `reliable`

## FAQ

### What does Agent Audit do with Lighthouse reports?

It transforms raw Lighthouse data into structured 'fix packs' containing repository search hints, implementation steps, and acceptance criteria that coding agents can execute.

### What kind of web metrics and audits are included?

It covers Core Web Vitals (FCP, LCP, CLS, etc.), technical SEO, accessibility, broken links, metadata, and AI discovery signals like llms.txt readiness.

### Does this tool crawl my entire website?

No, the tool is designed to audit one requested URL at a time and is not a whole-site crawler.