@overlayqa/mcp

@overlayqa/mcp

Run accessibility audits, file QA issues, and manage projects from your AI coding tools. Works with Claude Code, Cursor, Windsurf, and any MCP-compatible editor.

Setup

Add this to your editor's MCP config:

Claude Code (.mcp.json in your project root):

{
  "mcpServers": {
    "overlayqa": {
      "command": "npx",
      "args": ["@overlayqa/mcp@latest"]
    }
  }
}

Cursor (~/.cursor/mcp.json):

{
  "mcpServers": {
    "overlayqa": {
      "command": "npx",
      "args": ["@overlayqa/mcp@latest"]
    }
  }
}

On first run, your browser opens to sign in to OverlayQA. The token is cached at ~/.overlayqa/auth.json for 30 days.

Tools

Tool	What it does
scan_accessibility	Run a WCAG audit on any URL. Returns violations with severity, WCAG criteria, and an overall score.
scan_contrast	Check color contrast ratios across a page. Returns failing element pairs.
scan_and_create_issues	Scan a URL and auto-create issues in a project for each violation above a severity threshold.
create_issue	File a QA issue with title, severity, type, and description.
list_issues	List issues in a project, with optional status and severity filters.
create_project	Create a new project for a site URL.
list_projects	List all projects on your team.
compare_visual	Compare a live page against a Figma frame (coming soon).
audit_tokens	Audit design tokens on a page against a Figma file (coming soon).

Example prompts

Once connected, ask your AI assistant things like:

• "Scan example.com for accessibility issues"
• "Show me all open issues in my project"
• "Create a high-severity issue: the login button has no focus ring"
• "Scan my staging site and create issues for anything critical or high"

Pricing

Free during the 14-day trial. Scan tools remain available (3/day) after the trial. Creating issues and projects requires a paid plan. See overlayqa.com/pricing.

License

MIT