# OverlayQA

Audit public pages for accessibility, contrast, and design-token issues, then manage QA tickets from your coding editor. Useful when a review needs to lead straight to tracked issues.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI
- Author: OverlayQA
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/OverlayQA/mcp
- Updated: 2026-10-23
- HTML: https://affpapa.org/en/nevibecode/mcp/overlayqa

## What it does

OverlayQA lets an agent check a URL for WCAG violations, color-contrast failures, and inconsistent design tokens. It can turn scan findings into issues, assign them, change their status, and manage workspace labels. Visual comparison can use a Figma frame, a saved design, or an uploaded image.

Auto Review and visual comparison need a `projectId`, a public `url`, and a fresh UUID `requestId`. The tools return a `jobId`; call `get_review_result` to read progress and findings. These reviews use the scan allowance and do not file issues automatically. Visual comparison provides AI findings rather than a deterministic pixel-diff result for CI. On first connection, a browser opens for OverlayQA account authorization, and the connection lasts 30 days.

Tool calls can record the supplied context, account and project details, scan URL, results, and editor information. Conversation text and source code are not sent, but the URL and project metadata are still recorded. Claude Code can connect to the hosted MCP endpoint with one command.

## Requirements
- Needs: Node.js (commands run via npx)
- Remote server: `https://api.overlayqa.com/mcp`

## Install

### Claude Code (native platform)

1. **Platform CLI: remote server**
```bash
claude mcp add --transport http mcp https://api.overlayqa.com/mcp
```

2. **Platform CLI**
```bash
claude mcp add overlayqa -- npx -y @overlayqa/mcp
```

### Codex

1. **Platform CLI: remote server**
```bash
codex mcp add overlayqa --url https://api.overlayqa.com/mcp
```

2. **Platform CLI**
```bash
codex mcp add overlayqa -- npx -y @overlayqa/mcp
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "overlayqa": {
            "url": "https://api.overlayqa.com/mcp"
        }
    }
}
```
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "overlayqa": {
            "command": "npx",
            "args": [
                "-y",
                "@overlayqa/mcp"
            ]
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "overlayqa": {
            "type": "http",
            "url": "https://api.overlayqa.com/mcp"
        }
    }
}
```
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "overlayqa": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@overlayqa/mcp"
            ]
        }
    }
}
```

### Gemini CLI

1. **Platform CLI: remote server**
```bash
gemini mcp add -t http overlayqa https://api.overlayqa.com/mcp
```

2. **Platform CLI**
```bash
gemini mcp add overlayqa npx -y @overlayqa/mcp
```

## When to use it
- check a page for WCAG violations
- find text and background pairs with failing contrast
- create QA issues from severe scan findings
- filter issues by status and severity
- compare a page with a Figma frame

## Example prompts
- Check `https://example.com` for accessibility and contrast problems.
- Scan the site and open issues for severe findings.
- Show open critical issues in the Acme Web project.

## Similar
- [REA](https://affpapa.org/en/nevibecode/mcp/rea.md) — MCP server · ★ 397855
- [GitHub](https://affpapa.org/en/nevibecode/mcp/github.md) — MCP server · ★ 34011
- [World Monitor](https://affpapa.org/en/nevibecode/mcp/world-monitor.md) — MCP server · ★ 89674
- [Netdata](https://affpapa.org/en/nevibecode/mcp/netdata.md) — MCP server · ★ 81191
- [Front-End Checklist](https://affpapa.org/en/nevibecode/mcp/front-end-checklist.md) — MCP server · ★ 74577
- [Scrapling MCP Server](https://affpapa.org/en/nevibecode/mcp/scrapling-mcp-server.md) — MCP server · ★ 90077

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md