Skip to content
MCP server

ego-webqa

Run eight-view mobile checks on AI-generated web pages and get repair-ready evidence

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
CLI, Linux, macOS
Runs
Locally
Version
0.8.2
Listing updated
2 days ago

About ego-webqa

ego-webqa is an open-source MCP server for developer tools. It runs locally on your machine and is started by your AI client.

ego-webqa takes a URL and loads it in real Chromium across eight combinations of 360 and 390 px width, 1.0x and 1.5x text scaling, and 0 or 34 px simulated bottom safe area. It also safely probes the primary call to action, and writes screenshots plus machine-readable evidence.

Output lands in an output folder as agent_summary.json (one repair-ready item per root cause), report.json, junit.xml and a SARIF file. The exit code is 0 for pass or warnings, 1 for blocking delivery defects and 2 for an audit or browser failure, so it fits a CI gate. Firefox and Playwright WebKit can be chosen one engine at a time.

The author is explicit about scope: it is not a business-flow test, visual-regression baseline, cross-browser guarantee, security audit or WCAG certification. In a disclosed dogfood run over 20 of the author's own pages, ten were clean and ten had structural findings.

Install

Run in a terminal

claude mcp add qa -- uvx ego-webqa

Add to claude_desktop_config.json

{
  "mcpServers": {
    "qa": {
      "command": "uvx",
      "args": [
        "ego-webqa"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "qa": {
      "command": "uvx",
      "args": [
        "ego-webqa"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "qa": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "ego-webqa"
      ]
    }
  }
}

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

{
  "mcpServers": {
    "qa": {
      "command": "uvx",
      "args": [
        "ego-webqa"
      ]
    }
  }
}

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

{
  "mcpServers": {
    "qa": {
      "command": "uvx",
      "args": [
        "ego-webqa"
      ]
    }
  }
}

What it does

Eight-view matrix
Checks two widths, two text scales and two safe-area settings by default.
Real browser audit
Runs headless Chromium, with Firefox or WebKit selectable one at a time.
Agent-ready summary
One item per root cause, with a selector and a reproduce command.
CI-friendly reports
Writes JUnit XML and SARIF alongside JSON, with distinct exit codes.
Setup command
Checks the browser launches and installs a pinned headless shell if not.

Good for

  • Gate AI-generated pages before delivery
  • Catch text-enlargement overflow on narrow phones
  • Feed repair lists back to a coding agent
  • Add a mobile layout check to CI

Pricing

Open source

Open-source Python package on PyPI

Prices change. Check roy32172310.github.io before you buy.

ego-webqa FAQ

How do I install it?

Install the Python package with pip, run ego-webqa setup, then audit a URL.

What do the exit codes mean?

0 for pass or warnings, 1 for blocking delivery defects, 2 for an audit or browser failure.

Does it replace accessibility testing?

No. The author says it is not a WCAG certification or a security audit.

Does it download a browser automatically?

Only the setup command does; ordinary audit and doctor commands never download one implicitly.

Is ego-webqa free?

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

How do I add ego-webqa to Claude Code?

Run this command in your terminal: claude mcp add qa -- uvx ego-webqa

What are the best alternatives to ego-webqa?

The closest alternatives to ego-webqa are REA, Browser Use, Scrapling MCP Server, Codebase Memory and GitHub.

Alternatives to ego-webqa

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Browser Use

    MCP server

    Browser agents and cloud browsers for AI, with an MCP server for web tasks

    • 7 tools
    • Remote
    • Freemium
    • 121K GitHub stars
    • Browser automation
  3. MCP server for AI clients to scrape sites with HTTP and stealth browser sessions

    Runs locally
    • 17 tools
    • Open source
    • 104K GitHub stars
    • Web search and scraping
  4. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  5. GitHub

    MCP server

    Official MCP server connecting AI assistants to GitHub repos, issues and workflows

    Not checked yet
    • Remote
    • Open source
    • 34.5K GitHub stars
    • Developer tools
  6. MCP toolkit giving coding agents symbol-level code retrieval and editing

    Runs locally
    • Open source
    • 31.5K GitHub stars
    • Developer tools