Skip to content
MCP server

A11yScope

Run WCAG 2.2 AA accessibility scans on pages and HTML in local headless Chrome

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
CLI, self-hosted
Runs
Locally
Version
0.3.0
Listing updated
2 days ago

About A11yScope

A11yScope is an open-source MCP server for developer tools. It runs locally on your machine and is started by your AI client.

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.

Install

Run in a terminal

claude mcp add a11yscope -- npx -y a11yscope-mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "a11yscope": {
      "command": "npx",
      "args": [
        "-y",
        "a11yscope-mcp"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "a11yscope": {
      "command": "npx",
      "args": [
        "-y",
        "a11yscope-mcp"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

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

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

Tools this server provides (3)

Taken from the project documentation; the running server may differ.

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.

What it does

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

Pricing

Open source

Free; runs locally

Prices change. Check perceivable.github.io before you buy.

A11yScope 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 to A11yScope

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  3. GitHub

    MCP server

    Official MCP server connecting AI assistants to GitHub repos, issues and workflows

    Not checked yet
    • Remote
    • Open source
    • 34.5K GitHub stars
    • Developer tools
  4. MCP toolkit giving coding agents symbol-level code retrieval and editing

    Runs locally
    • Open source
    • 31.5K GitHub stars
    • Developer tools
  5. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory
  6. Ouroboros

    MCP server

    Spec-first layer that pins requirements and verifies results of AI coding agent work

    Runs locally
    • Open source
    • 6.4K GitHub stars
    • Developer tools