@buildbench/accessibility-scanner-mcp
v1.0.0
Published
Static WCAG 2.1 / ADA / AODA accessibility scanner for any web page. Detects missing alt text, unlabeled form fields, missing page language, heading-structure problems, non-descriptive links, unnamed buttons, disabled zoom, and more. MCP server + CLI for
Downloads
58
Maintainers
Readme
Accessibility Scanner
Static WCAG 2.1 accessibility scanner for any web page. Relevant to ADA Title III, Section 508, and Ontario AODA. Detects the accessibility defects you can catch from markup, missing alt text, unlabeled form fields, missing page language, heading-structure problems, non-descriptive links, unnamed buttons, disabled zoom, and more, and returns a severity-ranked report with a 0-100 risk score.
Built by Build Bench. Free, MIT-licensed. Sibling of the SEO Defect Scanner and MCP Security Scanner.
Why this exists
In 2025 there were tens of thousands of ADA web-accessibility demand letters and 3,000-plus federal lawsuits, with no small-business exemption. In Ontario, AODA requires private and non-profit organizations with 20-plus employees to meet WCAG and file compliance reports, with penalties up to $100,000 per day. Most small-business sites have never been checked. This catches the common, high-impact defects in seconds.
Install / use as an MCP tool
{
"mcpServers": {
"accessibility-scanner": {
"command": "npx",
"args": ["-y", "@buildbench/accessibility-scanner-mcp"]
}
}
}The tool is scan_accessibility({ url }) or scan_accessibility({ html }).
Install / use as a CLI
npx @buildbench/accessibility-scanner-mcp # MCP server (stdio)
npx -p @buildbench/accessibility-scanner-mcp accessibility-scan example.com
npx -p @buildbench/accessibility-scanner-mcp accessibility-scan example.com --json
accessibility-scan --html ./page.html # scan local HTMLExits non-zero on serious or critical results, so you can gate CI.
What it detects
| Code | Severity | WCAG | What it flags |
|---|---|---|---|
| A11Y-IMG-ALT | high | 1.1.1 | Images with no alt attribute |
| A11Y-INPUT-LABEL | high | 1.3.1 / 3.3.2 | Form fields with no associated label |
| A11Y-HTML-LANG | high | 3.1.1 | <html> missing a lang attribute |
| A11Y-TITLE | high | 2.4.2 | Missing or empty page title |
| A11Y-BUTTON-NAME | high | 4.1.2 | Buttons with no accessible name |
| A11Y-H1 | medium | 1.3.1 / 2.4.6 | No H1, or multiple H1s |
| A11Y-HEADING-ORDER | medium | 1.3.1 | Skipped heading levels |
| A11Y-LINK-TEXT | medium | 2.4.4 | Links with empty or generic text |
| A11Y-VIEWPORT-ZOOM | medium | 1.4.4 | Viewport disables pinch-zoom |
| A11Y-TABINDEX | low | 2.4.3 | Positive tabindex (broken tab order) |
| A11Y-DUP-ID | low | 4.1.1 | Duplicate id values |
| A11Y-MAIN-LANDMARK | low | 1.3.1 | No <main> landmark |
Static analysis cannot test color contrast, keyboard focus order, or dynamic behavior. A clean scan is necessary, not sufficient.
Try it on the included sample:
accessibility-scan --html examples/inaccessible-page.htmlNeed a full audit?
A full Build Bench Accessibility Audit adds a rendered audit (contrast, keyboard, screen-reader), hands-on remediation to WCAG 2.1 AA, and a documented accessibility statement for your legal file. Details: buildbench.ca/accessibility-audit.
License
MIT
