# com.overlayqa/mcp (npm · @overlayqa/mcp)

Run accessibility, contrast, and design token audits and file QA issues from your AI coding tool.

- Trust score: 64/100 (medium)
- Change this week: +24
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-08-03

## Components

- npm · `@overlayqa/mcp`: 64/100 (this document), [markdown](https://verifymcp.io/servers/com-overlayqa-mcp/overlayqa-mcp.md), [page](https://verifymcp.io/servers/com-overlayqa-mcp/overlayqa-mcp)

## Channel facts

- Registry: `npm`
- Package: `@overlayqa/mcp`
- Version: `0.1.7`
- Transport: `stdio`

## Trust breakdown

How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. Scores are 0–100 per category. Scoring method: https://verifymcp.io/docs/scoring (what has changed: https://verifymcp.io/docs/scoring/changelog)

Scored 2026-08-03.

- **Supply Chain Security**: 87/100
  - No malware found by supply-chain analysis.
  - Only part of the dependency tree could be resolved (105 of 109), so this covers what we could see, not the whole tree.
  - No install/post-install scripts declared.
  - Only part of the dependency tree could be resolved (105 of 109), so this covers what we could see, not the whole tree.
- **Provenance & Transparency**: 19/100
  - Repository check failed: no source repository is declared.
  - Provenance check failed: no build-provenance attestation is published.
  - Clear OSI-approved license (MIT).
  - Actively maintained (last published 31 days ago).
  - Disclosure check failed: no security disclosure policy was found in the source repository.
- **Schema Quality & AI Usability**: 77/100
  - AI-judged instruction clarity (excellent).
  - Tool/resource definitions use about 690 tokens (~76/item across 9 items; 9 tools + 0 resources), lean.
  - Usage-examples check failed: none of the tools include examples.
- **Stability & Change Management**: 27/100
  - Stability observed for 8 of 30 days with no destabilising changes; credit accrues until the full window elapses.
- **Tool Coverage**: 100/100
  - 100% of tools have a non-trivial description (not blank, and not just the tool's name).
  - 100% of tool parameters carry a description.
- **Capabilities**: 100/100
  - Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.

## Install

### Claude

```bash
claude mcp add com-overlayqa-mcp -- npx -y @overlayqa/mcp
```

### Codex

```bash
codex mcp add com-overlayqa-mcp -- npx -y @overlayqa/mcp
```

### opencode

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "com-overlayqa-mcp": {
      "type": "local",
      "command": [
        "npx",
        "-y",
        "@overlayqa/mcp"
      ],
      "enabled": true
    }
  }
}
```

### OpenClaw

```bash
openclaw mcp add com-overlayqa-mcp --command npx --arg -y --arg @overlayqa/mcp
```

### Hermes

```yaml
mcp_servers:
  com-overlayqa-mcp:
    command: "npx"
    args: ["-y", "@overlayqa/mcp"]
```

### Other

```json
{
  "mcpServers": {
    "com-overlayqa-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@overlayqa/mcp"
      ]
    }
  }
}
```

## Changelog

Every change recorded for this component, newest first. Days that predate change tracking, or that we cannot explain, say so: "we were watching and nothing happened" and "we were not watching" are different claims.

### 2026-08-03 (score 64, +4)

- [functional improvement] Stability: unverified → 0.27

### 2026-08-02 (score 60, +44)

- [security regression] Provenance: unverified → fail
- [security improvement] Known CVEs: unverified → partial
- [security improvement] Install scripts: unverified → pass
- [security improvement] Malware scan: unverified → pass
- [security] Stability: Stability not yet verified: not enough scan history yet (needs a 30-day window).
- [functional regression] Security disclosure: unverified → fail
- [functional regression] Tool coverage: 100 → unverified
- [functional improvement] Schema quality: unverified → excellent
- [functional improvement] License: unverified → pass
- [functional improvement] MCP protocol: unverified → pass
- [functional improvement] Maintenance: unverified → pass
- [functional improvement] Dependency health: unverified → partial
- [functional] First check of Schema quality: unverified
- [functional] Licence: MIT

### 2026-07-31 (score 16, −24)

- [functional] We updated how we score, so this day's move reflects our rubric, not a change to the server

### 2026-07-27 (score 40)

First indexed and scored.

## MCP tools (9)

### `scan_accessibility` (~80 tokens)

Run an accessibility audit on a URL. Returns WCAG violations with severity, descriptions, and an overall score. Scans one page per call. Free plans include 3 scans per day; Pro is unlimited.

Input parameters:

- `projectId` (string): Optional project ID to associate results with
- `url` (string, required): The URL to scan for accessibility issues

### `scan_contrast` (~65 tokens)

Run a color contrast audit on a URL. Returns elements failing WCAG contrast ratios with severity and details. Scans one page per call. Free plans include 3 scans per day; Pro is unlimited.

Input parameters:

- `url` (string, required): The URL to scan for color contrast issues

### `scan_and_create_issues` (~106 tokens)

Run an accessibility scan on a URL and automatically create issues in the given project for each violation at or above the minimum severity. Returns scan summary + issue IDs created. Scans one page per call. Free plans include 3 scans per day; Pro is unlimited.

Input parameters:

- `minSeverity` (string): Minimum severity to create issues for (default: medium)
- `projectId` (string, required): Project to create issues in
- `url` (string, required): The URL to scan

### `compare_visual` (~106 tokens)

Coming soon — not yet implemented; the server returns a not-implemented notice (use the OverlayQA browser extension for visual comparison today). Will compare a live URL against a Figma frame and return visual differences and a match score.

Input parameters:

- `figmaFileKey` (string, required): Figma file key (from the Figma URL)
- `figmaNodeId` (string, required): Figma node ID of the frame to compare against
- `url` (string, required): The live URL to compare

### `audit_tokens` (~111 tokens)

Audit a live URL's design-system token usage. Returns a 0-100 token-health score plus findings (inconsistent font sizes, text colors, spacing, font families, border radii) with severity and evidence. Audits the live page only; the figmaFileKey argument is accepted but Figma comparison is not yet available via MCP.

Input parameters:

- `figmaFileKey` (string): Optional Figma file key for token comparison
- `url` (string, required): The URL to audit for design token usage

### `create_issue` (~97 tokens)

Create an issue in an OverlayQA project. Title is required; severity, type, and description default to medium / design-bug / empty.

Input parameters:

- `description` (string): Issue description
- `projectId` (string, required): Project to create the issue in
- `severity` (string): Issue severity (default: medium)
- `title` (string, required): Issue title
- `type` (string): Issue type (default: design-bug)

### `list_issues` (~55 tokens)

List issues in a project, optionally filtered by status and severity.

Input parameters:

- `projectId` (string, required): Project to list issues from
- `severity` (string): Filter by severity
- `status` (string): Filter by status

### `list_projects` (~19 tokens)

List all OverlayQA projects in the authenticated user's team.

### `create_project` (~51 tokens)

Create a new OverlayQA project. Returns the project id, name, slug, displayPrefix, and url.

Input parameters:

- `name` (string, required): Project name
- `url` (string): Primary URL for this project

## Diagnostics

Captured diagnostic sections: Provenance, Dependencies. The full working is on the page: https://verifymcp.io/servers/com-overlayqa-mcp/overlayqa-mcp#diagnostics

## Score history

- 2026-08-03: 64
- 2026-08-02: 60
- 2026-08-01: 16
- 2026-07-31: 16
- 2026-07-30: 40
- 2026-07-28: 40
- 2026-07-27: 40

## Links

- npm package: https://www.npmjs.com/package/@overlayqa/mcp
- Socket report: https://socket.dev/npm/package/@overlayqa/mcp
- Changelog RSS feed: https://verifymcp.io/servers/com-overlayqa-mcp/overlayqa-mcp/changelog.xml
- Changelog JSON feed: https://verifymcp.io/servers/com-overlayqa-mcp/overlayqa-mcp/changelog.json
- HTML version of this page: https://verifymcp.io/servers/com-overlayqa-mcp/overlayqa-mcp