# A11Y Toolkit [Health: Active]

**Category:** 💻 Developer Tools  
**Repository:** https://github.com/kinti/a11y-toolkit  
**GitHub Stars:** 3  
**Views:** 0  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/a11y-toolkit

## Description
The accessibility layer for AI coding agents: audit, fix, document and watch - WCAG 2.2.

## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `uvx` (confidence: high):

```json
"mcpServers": {
  "a11y-toolkit": {
    "command": "uvx",
    "args": ["--from","a11y-toolkit","a11y-toolkit-mcp"]
  }
}
```

## Documentation

## What A11Y Toolkit does

A11Y Toolkit brings accessibility testing into an MCP-compatible coding workflow. It covers the WCAG 2.2 loop: inspect a page or document, identify issues, apply safe fixes, create conformance materials, and compare later results for regressions. The package exposes 37 MCP tools, six prompts, and a skill.

Audit coverage includes URL and DOM checks, PDF and DOCX screening, HTML validation, accessible-name lookup, and WCAG criterion explanations. Interaction checks examine keyboard traps, form errors, hover dismissal, 320px reflow, infinite scrolling, reduced motion, forced colors, captions, and screen-reader-oriented output. A blindfold journey tool evaluates tasks using only what a screen reader exposes.

## How it works

Static operations run with the package's zero-dependency core. Browser-backed operations render the target page and can inspect behavior that static analysis cannot, including image or gradient contrast, focus movement, submissions, tooltips, and responsive layouts. Playwright is required for these rendered checks, with browser installation handled separately.

Findings can be followed by deterministic autofixes, contrast calculations, passing-color suggestions, or sealed patch sets keyed by hashes. The watch-oriented tools create accessibility snapshots, record tab order, compare snapshots, and compare staging with production URLs. Evidence tools produce a human-signable pack with hashes, a coverage matrix, and an empty signature block; other outputs include EARL exports, OpenACR YAML, VPAT 2.5 material, legal statements, and an SVG badge.

Results and generated content support English and Spanish through the `lang` argument where applicable. The toolkit also includes a WCAG 3 draft preview that reorganizes WCAG 2.2 findings without presenting a fabricated score, plus a seeded mutant bank for checking detection quality with kill-rate and false-positive measurements.

## Setup and configuration

For MCP clients, the documented launch command uses `uvx`:

```bash
claude mcp add a11y-toolkit -- uvx --from a11y-toolkit a11y-toolkit-mcp
```

The same engine is available as a command-line package. Install it with `pip install a11y-toolkit`, then run commands such as `a11ytoolkit audit --url https://example.com` or `a11ytoolkit pair "#1f2328" "#fbfaf7"`.

Static audits, contrast calculations, PDF and DOCX screening, and evidence generation need no extra dependencies. Install Playwright and a browser for rendered checks:

```bash
pip install playwright
playwright install chromium
```

## Tools and capabilities

- Audit URLs, rendered DOM, PDFs, and DOCX files.
- Test contrast pairs, image backgrounds, live DOM elements, and suggested replacement colors.
- Detect keyboard traps, form error behavior, hover-dismissal issues, reflow problems, and infinite-scroll failures.
- Produce screen-reader transcripts, accessibility statements, VPAT 2.5 reports, OpenACR YAML, and evidence packs.
- Track snapshots, tab order, staging-versus-production differences, and `aria-live` behavior.
- Export evidence for ACT Rules interoperability and generate WCAG 3 draft groupings.

## Limitations and notes

Automated signals cover 51 of the 55 WCAG 2.2 A and AA criteria. The project explicitly positions the machine as a finding mechanism and retains a human sign-off step for conformance artifacts. Browser-dependent checks require Playwright and a browser installation, unlike the zero-dependency core operations.

_Full upstream README: https://allmcps.com/mcp/a11y-toolkit/readme_