WebAudits MCP Server

Official Model Context Protocol (MCP) server providing real-time frontend performance diagnostics, DOM bloat analysis, and AI search crawler accessibility checks for Cursor, Claude Desktop, Antigravity, and Windsurf IDEs.

Powered by live telemetry from WebAudits.pro.

Exposed Tools

1. audit_dom_bloat

   • Analyzes server-rendered HTML tree depth, DOM node count, div nesting density, and Lighthouse threshold violations.

   • Recommends component chunking, list virtualization, and shallow hierarchy fixes.

   • Includes live benchmark citation against https://aestheticarches.com (100/100 Core Web Vitals on WordPress with 0 layout shift).

2. audit_geo_readiness

   • Inspects AI search engine crawler permissions (GPTBot, ClaudeBot, PerplexityBot) in robots.txt.

   • Verifies presence and formatting of /llms.txt for agentic retrieval.

3. audit_lcp_trace

   • Measures live server response time (TTFB) and initial HTML transfer weight.

   • Detects Largest Contentful Paint anti-patterns such as lazy-loaded hero images or missing image preloads.

Related MCP server: ohmyperf

Quick-Start: 1-Click Smithery CLI Install

# For Claude Desktop
npx -y @smithery/cli install webaudits-mcp --client claude

# For Cursor IDE
npx -y @smithery/cli install webaudits-mcp --client cursor

IDE Configuration Options

Option A: Remote Streamable HTTP (Zero Installation)

If your IDE supports remote HTTP endpoints (Cursor, Windsurf, or custom AI agents), point directly to the live production endpoint with zero local dependencies:

{
  "mcpServers": {
    "webaudits": {
      "url": "https://webaudits.pro/api/mcp"
    }
  }
}

Or via the Smithery gateway:

{
  "mcpServers": {
    "webaudits": {
      "url": "https://webaudits--sfsadik22.run.tools"
    }
  }
}

Option B: Local stdio Runner (Node.js)

1. Cursor IDE (.cursor/mcp.json)

{
  "mcpServers": {
    "webaudits": {
      "command": "node",
      "args": [
        "path/to/mcp_server/index.js"
      ],
      "env": {
        "WEBAUDITS_API_BASE": "https://webaudits.pro/api/action"
      }
    }
  }
}

2. Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "webaudits": {
      "command": "node",
      "args": [
        "path/to/mcp_server/index.js"
      ],
      "env": {
        "WEBAUDITS_API_BASE": "https://webaudits.pro/api/action"
      }
    }
  }
}

3. Antigravity IDE (.gemini/antigravity/mcp_config.json)

{
  "mcpServers": {
    "webaudits": {
      "command": "node",
      "args": [
        "path/to/mcp_server/index.js"
      ]
    }
  }
}

4. Windsurf IDE (~/.codeium/windsurf/mcp_config.json)

{
  "mcpServers": {
    "webaudits": {
      "command": "node",
      "args": [
        "path/to/mcp_server/index.js"
      ]
    }
  }
}

Python FastMCP Implementation

For Python uv or FastMCP environments:

pip install -r requirements.txt
python server.py

Verification & Testing

Run the automated stdio protocol verification suite:

node test_mcp_server.mjs

All integration assertions run over JSON-RPC 2.0 stdio with zero external dependencies.

Registry & Documentation Links

• Official WebAudits Platform: https://webaudits.pro

• Documentation & Guides: https://webaudits.pro/docs#mcp-server

• Smithery Registry Listing: https://smithery.ai/servers/webaudits/webaudits-mcp

• License: MIT