A
licenseB
qualityA
maintenanceEnables automated web accessibility scans for WCAG compliance using Playwright and Axe-core, providing visual and JSON reports with remediation guidance.
25
1,730
56
MIT
a11y-mcp
by antonio-rmrz
This server provides automated web accessibility auditing using axe-core, with built-in Cloudflare/bot protection bypass via an anti-detect browser (Camoufox).
Scan entire pages (
scan_page): Navigate to any URL and run a full WCAG accessibility audit, with automatic Cloudflare bypass and configurable conformance level.Scan specific elements (
scan_element): Target a CSS selector on the current page to audit just that element and its descendants.Retrieve violation details (
get_violations): Get a detailed list of accessibility violations from the most recent scan, including affected HTML elements, WCAG references, and remediation guidance.Get full reports (
get_full_report): Access a comprehensive report covering violations, passes, incomplete checks, and inapplicable rules.Export reports (
export_report): Export scan results in JSON (machine-readable), HTML (stakeholder-friendly), or CSV (spreadsheet/tracking) formats.Set WCAG conformance level (
set_wcag_level): Configure the WCAG standard to test against — supports WCAG 2.0 (A, AA, AAA), 2.1 (21A, 21AA), and 2.2 (22AA).Configure rules (
configure_rules): Enable or disable specific axe-core rules (e.g., color-contrast, image-alt) to customize subsequent scans.
Allows scanning of Cloudflare-protected websites by bypassing bot protection mechanisms like JavaScript challenges and Turnstile using Camoufox.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@a11y-mcpcheck accessibility of https://example.com"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
a11y-mcp
MCP server for running axe-core accessibility audits. Uses Camoufox to bypass Cloudflare and other bot protection.
Install
# Claude Code
claude mcp add a11y -- uvx a11y-mcp
# Or with pip
pip install a11y-mcpRelated MCP server: Accessibility MCP Server
Configuration
For Claude Desktop, add to your config (~/Library/Application Support/Claude/claude_desktop_config.json on macOS):
{
"mcpServers": {
"a11y": {
"command": "uvx",
"args": ["a11y-mcp"]
}
}
}Most editors use the same format. Add to your MCP config:
{
"mcpServers": {
"a11y": {
"command": "uvx",
"args": ["a11y-mcp"]
}
}
}Config locations:
Cursor:
~/.cursor/mcp.jsonVS Code (Continue):
.continue/config.jsonunderexperimental.modelContextProtocolServersVS Code (Cline): Cline MCP settings
Zed:
~/.config/zed/settings.jsonundercontext_servers
Tools
Tool | Description |
| Scan a URL for WCAG violations |
| Scan a specific CSS selector |
| Get detailed violation info from last scan |
| Full axe results (violations, passes, incomplete) |
| Export as JSON, HTML, or CSV |
| Set WCAG level (A, AA, AAA, 21A, 21AA, 22AA) |
| Enable/disable specific axe rules |
Usage
> Scan https://example.com for accessibility issues
> Export an HTML report for the last scan
> Check WCAG 2.2 AA compliance for https://adobe.comWCAG Levels
Level | Standard |
| WCAG 2.0 |
| WCAG 2.1 |
| WCAG 2.2 |
Default is AA.
Cloudflare Bypass
This uses Camoufox, an anti-detect browser with fingerprint spoofing at the C++ level. It handles JavaScript challenges, Turnstile, and most bot detection automatically.
On first run, Camoufox downloads a browser binary (~300MB).
Requirements
Python 3.10+
macOS, Linux, or Windows
Troubleshooting
Browser won't launch: Run python -c "import camoufox; camoufox.install()"
Cloudflare still blocking: Some sites have aggressive detection. The first visit may require manual verification.
axe-core won't inject: Likely a strict CSP. Try a different page on the same domain.
Development
git clone https://github.com/antonio-rmrz/a11y-mcp && cd a11y-mcp
uv venv && source .venv/bin/activate
uv pip install -e ".[dev]"
python -m camoufox fetch
pytestDebug with the MCP inspector:
npx @modelcontextprotocol/inspector uvx a11y-mcpLicense
MIT License - see LICENSE for details.
Credits
axe-core - Accessibility testing engine by Deque
Camoufox - Anti-detect browser
MCP - Model Context Protocol by Anthropic
Related Projects
mcp-server-fetch - Web content fetching
mcp-server-puppeteer - Browser automation
mcp-server-playwright - Playwright browser control
Maintenance
–Maintainers
–Response time
0dRelease cycle
2Releases (12mo)
Commit activity
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Related MCP Servers
- FlicenseBqualityDmaintenanceEnables AI agents to perform comprehensive accessibility audits on websites using Playwright and axe-core against WCAG standards. Provides detailed compliance reports with violation summaries and remediation guidance across multiple browsers.3
- FlicenseAqualityDmaintenanceEnables accessibility testing of websites and HTML content using axe-core and IBM Equal Access engines. Supports WCAG compliance checking, multi-viewport testing, and provides detailed violation reports with remediation guidance.51
- Alicense-qualityBmaintenanceEnables AI coding assistants to test web accessibility by scanning URLs, detecting violations, and running focused audits on keyboard navigation, screen reader compatibility, and WCAG criteria — all within the assistant's loop.MIT
Related MCP Connectors
Scan URLs for WCAG 2.1 violations, generate AI fixes, and produce VPAT 2.5 compliance reports.
Deterministic axe-core accessibility scans (WCAG 2.1 AA, EN 301 549, PDF/UA) via your account.
AI QA tester — real browsers scan sites for bugs, SEO, perf, and accessibility issues via chat.
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/antonio-rmrz/a11y-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server