OverlayQA/mcp

**OverlayQA MCP is a Model Context Protocol server that gives your AI coding agent accessibility and design-QA superpowers.** Ask Claude Code, Cursor, or Windsurf to audit any URL for WCAG and color-contrast issues, then read, assign, discuss, label and resolve issues in your OverlayQA projects without leaving your editor.
Install
One click:
- Install in Cursor
- Install in VS Code
Or add it to your editor's MCP config manually:
**Claude Code** (.mcp.json in your project root) / **Cursor** (~/.cursor/mcp.json) / **Windsurf** (~/.codeium/windsurf/mcp_config.json):
Any MCP-compatible client works the same way. On first run a browser tab opens to connect your OverlayQA account (free, no card). The token caches at ~/.overlayqa/auth.json for 30 days.
Tools
Tools your agent can call. Each is written so the model picks the right one from natural language.
**Audit**
| Tool | What it does |
|------|-------------|
| scan_accessibility | Run a WCAG audit (axe-core) on any URL. Returns violations with severity, WCAG success criteria, and an overall score. |
| scan_contrast | Check color-contrast ratios across a page. Returns the failing foreground/background element pairs. |
| audit_tokens | Audit a live URL's design-system tokens. Returns a 0-100 token-health score and findings (inconsistent font sizes, text colors, spacing, font families, border radii) with severity. Audits the live page only. |
**File and manage issues**
| Tool | What it does |
|------|-------------|
| scan_and_create_issues | Scan a URL and auto-create an issue for every violation above a severity threshold. |
| create_issue | File a QA issue with title, severity, type, description and optional assignee. |
| list_issues | Page through issues filtered by status, severity, type, labels, assignee, creator, page, creation time, or active/finished/ignored state. Each issue says who filed it and whether it still needs a reply. |
| update_issue | Edit supplied issue fields, assignment, ignored state or status. Takes a UUID or display id such as OQ-12. |
| create_project | Create a project for a site URL. |
| list_projects | List all projects on your team. |
| list_labels | Read the workspace label library, assigned labels, and your permissions. |
| create_label | Create a reusable workspace label. |
| set_issue_label | Apply or remove one label without changing issue text or other labels. |
| rename_label | Rename a workspace label (owner/admin). |
| delete_label | Delete a workspace label and its assignments; keep the issues (owner/admin). |
**Coming soon**
| Tool | What it does |
|------|-------------|
| compare_visual | Compare a live page against a Figma frame. |
What the server records
Every tool also accepts an optional context argument: one sentence on why the agent is calling it. OverlayQA records that sentence, the tool name, your account, project and issue ids, counts and scores, the URL a scan runs on, and your editor's name and version (from the MCP handshake) as product analytics. The sentence is capped and stripped of email addresses and credential-like strings before it is stored. Nothing else travels: not your conversation, not your code, not the tool's replies. Full detail: overlayqa.com/privacy.
Example prompts
- "Scan example.com for accessibility issues."
- "Check the contrast on our pricing page and tell me what's failing."
- "Scan staging.acme.com and create issues for anything critical or high."
- "Create a high-severity accessibility issue: the login button has no focus ring."
- "List the open critical issues in the Acme Web project."
- "Create a project for shop.acme.com, then scan it."
Pricing
| | Scans | Create issues & projects |
|---|---|---|
| **Free** | 3 / day, forever | no |
| **14-day trial** | 30 / day | yes |
| **Paid** | 10-30 / day by plan, unlimited on Pro | yes, with export to Linear / Jira / Asana / Notion |
See overlayqa.com/pricing.
FAQ
**Which editors does it work with?** Claude Code, Cursor, Windsurf, and any MCP-compatible client (it speaks standard stdio MCP).