aria51 MCP Server
Allows integrating accessibility checks into GitHub Actions CI pipelines with configurable violation thresholds and JSON output for automated reporting.
Leverages OpenAI's models to provide AI-enhanced deep analysis of keyboard, structure, and screen-reader audits, requiring an OPENAI_API_KEY.
Click on "Deploy 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., "@aria51 MCP Serverscan https://example.com for accessibility violations"
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.
aria51
Accessibility testing for keyboard navigation, focus management, screen reader compatibility, and WCAG 2.2 checks that require real browser interaction.
Quick Start
npx aria51 https://your-site.comRuns instantly with zero config, no API key, and no setup.
Focused Audits
Test specific accessibility dimensions through real browser interaction:
# Keyboard: tab order, focus traps, skip links, focus indicators
npx aria51 https://your-site.com --audit-keyboard
# Structure: landmarks, heading hierarchy, form labels
npx aria51 https://your-site.com --audit-structure
# Screen reader: alt text, ARIA roles, page language, labels, live regions
npx aria51 https://your-site.com --audit-screen-readerFull WCAG Compliance Audit
Run a complete multi-page audit with one command, no API key needed:
npx aria51 https://your-site.com --full-audit
npx aria51 https://your-site.com --full-audit --max-pages 20Discovers pages via sitemap and link crawling, scans every page with axe-core, runs keyboard/structure/screen-reader audits on key pages, and generates a prioritized remediation plan.
What aria51 Catches
Combining axe-core with focused browser audits surfaces issues across real interaction paths:
Site | axe-core alone | + aria51 focused audits |
Hacker News | 4 violations | + only 3 of 229 interactive elements reachable via keyboard |
GitHub | 4 violations | + 72 tab-order, 104 focus-indicator, 15 widget keyboard issues |
Wikipedia | 0 violations | + 699 keyboard navigation issues |
Stripe | 0 violations | + 215 keyboard navigation issues |
Related MCP server: accessibility-mcp-server
MCP Server
aria51 ships as an MCP server so AI coding assistants can test accessibility directly. The workflow becomes: scan a URL, see violations, fix the code, re-scan to verify, all within the assistant's loop.
Claude Code
Add to your project's .mcp.json:
{
"mcpServers": {
"aria51": {
"command": "npx",
"args": ["-y", "@aria51/mcp"]
}
}
}Cursor / Windsurf
Add aria51-mcp as an MCP command in your editor's MCP settings.
Available Tools
Tool | Description |
| Scan a URL for accessibility violations |
| Batch scan multiple URLs |
| Get page semantic structure |
| Explain an axe-core rule and how to fix it |
| Look up WCAG 2.2 criteria by level, principle, or keyword |
| Test keyboard navigation (tab order, focus traps, indicators) |
| Analyze landmarks, headings, form labels |
| Simulate screen reader navigation |
| Find all pages on a site via sitemap + link crawling |
| Complete WCAG compliance audit with remediation plan |
CI Integration
# Exit code 1 if any violations found
npx aria51 https://your-site.com --ci --threshold 0
# Allow up to 5 violations
npx aria51 https://your-site.com --ci --threshold 5
# JSON output for automation
npx aria51 https://your-site.com --output report.jsonGitHub Actions
- name: Accessibility check
run: npx aria51 https://your-staging-url.com --ci --threshold 0CLI Reference
# Multiple URLs
npx aria51 https://your-site.com https://your-site.com/about
# Browser options
npx aria51 https://your-site.com --browser firefox
npx aria51 https://your-site.com --mobile
npx aria51 https://your-site.com --headless=false
# Filtering
npx aria51 https://your-site.com --tags wcag2aa
npx aria51 https://your-site.com --disable-rules color-contrast
npx aria51 https://your-site.com --exclude ".cookie-banner,.modal"
# Component attribution (auto-detected for React, Vue, Svelte, Solid)
npx aria51 https://your-site.com --no-components # disable
# AI-enhanced deep analysis (requires OPENAI_API_KEY)
npx aria51 https://your-site.com --audit-keyboard --deepPackages
Package | Description |
Scanning engine, focused audits, full audit pipeline, WCAG 2.2 checks, component attribution | |
AI-enhanced deep analysis via Stagehand | |
Terminal interface. Binary: | |
MCP server with 10 tools for AI assistant integration |
Documentation
Introduction: Architecture and how the pieces fit together
CI Integration: CI/CD setup and configuration
WCAG 2.2 Reference: All 86 success criteria
Effect Architecture: Core scanning engine internals
Development
# Install dependencies and build
pnpm install && pnpm build
# Watch mode (all packages)
pnpm dev
# Run tests
pnpm test
# Build/test a specific package
pnpm --filter @aria51/core build
pnpm --filter @aria51/core testRequirements: Node.js 18+, pnpm 8+, Playwright browsers (npx playwright install chromium)
Built With
axe-core: Automated WCAG violation detection
Playwright: Browser automation for keyboard and screen reader testing
Stagehand: AI-powered browser interaction for
--deepmodeEffect: Composable error handling and resource management
element-source: Maps DOM nodes to framework component source locations
License
This server cannot be deployed
Maintenance
Related MCP Connectors
Free WCAG 2.2/ADA/508 accessibility MCP: scan, AI fixes, verify, vision audit, localhost tunnel
Scan URLs for WCAG 2.1 violations, generate AI fixes, and produce VPAT 2.5 compliance reports.
Scan URLs or HTML for WCAG 2.2 violations. 75-rule manifest, weighted score, shareable reports.
Direct access to Cypress tests results and accessibility reports in your AI workflow.
Related MCP Servers
- AlicenseAqualityCmaintenanceProvides conversational, actionable accessibility testing for AI agents, including auditing, prioritization, and code-level fixes.229 npmMIT
- AlicenseAqualityDmaintenanceEnables AI agents to perform comprehensive web accessibility checks (WCAG 2.1/2.2) including color contrast analysis, ARIA validation, and full accessibility report generation without requiring any API key.8MIT
- AlicenseAqualityDmaintenanceEnables AI coding agents to perform real-browser accessibility scanning of localhost pages using Playwright and axe-core, returning WCAG 2.1 violations with structured fix plans.349 npm1MIT
- AlicenseAqualityFmaintenanceEnables AI agents to perform conversational accessibility testing with actionable insights, code-level fixes, and support for authenticated sessions and batch audits.2211 npm1MIT