# A11yScope

> A11yScope is an open-source MCP server for developer tools. Run WCAG 2.2 AA accessibility scans on pages and HTML in local headless Chrome. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, self-hosted
- **Website:** https://perceivable.github.io
- **Repository:** https://github.com/perceivable/a11yscope/tree/HEAD/mcp
- **MCP Registry name:** io.github.perceivable/a11yscope
- **Categories:** developer tools
- **Listing updated:** 2026-11-15

## About

This is the coding-agent side of the A11yScope Chrome extension: the same 31-check engine, exposed so an agent can audit what it just built and then fix it. A typical prompt is to scan localhost:3000 and fix every violation, then scan again. Everything runs locally in headless Chrome, with no upload, account or telemetry.

scan_page loads a URL or local HTML file and scan_html checks a string the agent has generated; both return violations grouped by rule with a CSS selector, an HTML snippet and a message on what to change. list_rules gives each check's WCAG criteria, level, impact and guidance. Findings that cannot be decided automatically come back as needing review rather than pass or fail.

Results include a checked count and an excluded count per rule, so a rescan can tell a genuine fix from images that were simply deleted or hidden. A rule with nothing to test is inapplicable, not passed. Same-origin frames are scanned; cross-origin frames are counted but not entered. The site notes that automated testing finds roughly a third of accessibility barriers and that a clean scan is not a compliance certificate. It needs Node 20 and a Chromium-based browser.

## Features

- **Page and HTML scans:** scan_page and scan_html return violations with selector, snippet and fix message.
- **31 documented rules:** list_rules gives criteria, level, impact and guidance for each check.
- **Human-review items:** Undecidable findings are flagged for review rather than guessed.
- **Fix verification counts:** Checked and excluded counts reveal deleted or hidden elements.
- **Frame handling:** Same-origin frames are scanned; cross-origin ones are reported.
- **Bot-check refusal:** Refuses to scan challenge pages that would come back falsely clean.

## Good for

- Scan a local dev server and fix each violation
- Check HTML an agent just generated for missing labels and alt text
- Look for contrast failures with measured ratios
- Verify a fix by comparing checked counts before and after
- List which WCAG criteria a rule maps to

## Install

### Claude Code (Terminal)

```sh
claude mcp add a11yscope -- npx -y a11yscope-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "a11yscope": {
      "command": "npx",
      "args": [
        "-y",
        "a11yscope-mcp"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "a11yscope": {
      "command": "npx",
      "args": [
        "-y",
        "a11yscope-mcp"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "a11yscope": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "a11yscope-mcp"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "a11yscope": {
      "command": "npx",
      "args": [
        "-y",
        "a11yscope-mcp"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "a11yscope": {
      "command": "npx",
      "args": [
        "-y",
        "a11yscope-mcp"
      ]
    }
  }
}
```

## Tools

- `scan_page`: Load a URL or local HTML file in headless Chrome and return violations grouped by rule.
- `scan_html`: Scan an HTML string the agent generated.
- `list_rules`: List the 31 checks with WCAG criteria, level, impact and fix guidance.

## FAQ

### Is anything uploaded?

No; scans run locally in headless Chrome with no account or telemetry.

### What does it need?

Node 20 or newer and a Chromium-based browser; it only downloads Chrome for Testing (~150 MB) if none is found.

### Which standard does it test?

WCAG 2.2 Level AA, the automatable parts.

### Does a clean scan mean compliance?

No. The site says automated checks find roughly a third of barriers.

### Is A11yScope free?

Yes. A11yScope is open source, so you can use and self-host it for free.

### How do I add A11yScope to Claude Code?

Run this command in your terminal: claude mcp add a11yscope -- npx -y a11yscope-mcp

### What are the best alternatives to A11yScope?

The closest alternatives to A11yScope are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/a11yscope
