ego-webqa
Run eight-view mobile checks on AI-generated web pages and get repair-ready evidence
- 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-webqaAdd to claude_desktop_config.json
{
"mcpServers": {
"qa": {
"command": "uvx",
"args": [
"ego-webqa"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"qa": {
"command": "uvx",
"args": [
"ego-webqa"
]
}
}
}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

REA
MCP serverCLI and MCP server that lets coding agents reverse engineer apps and binaries
Runs locally- Open source
- 464K GitHub stars
- Developer tools

Browser Use
MCP serverBrowser agents and cloud browsers for AI, with an MCP server for web tasks
- 7 tools
- Remote
- Freemium
- 121K GitHub stars
- Browser automation

Scrapling MCP Server
MCP serverMCP 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

Codebase Memory
MCP serverLocal MCP server that builds a code knowledge graph for AI coding agents
Runs locally- Open source
- 48.7K GitHub stars
- Knowledge and memory

GitHub
MCP serverOfficial MCP server connecting AI assistants to GitHub repos, issues and workflows
Not checked yet- Remote
- Open source
- 34.5K GitHub stars
- Developer tools

Serena MCP: the IDE for your agent
MCP serverMCP toolkit giving coding agents symbol-level code retrieval and editing
Runs locally- Open source
- 31.5K GitHub stars
- Developer tools