Which integrations are available for this 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.

How do I use aria51 MCP Server?

1. Click on "Deploy Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@aria51 MCP Server scan 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 MCP Server

by justinleeirizarry

Overview Schema Source Related Servers Discussions Admin

TypeScript

Local

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.com

Runs 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-reader

Full 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 20

Discovers 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_url`	Scan a URL for accessibility violations
`scan_urls`	Batch scan multiple URLs
`get_accessibility_tree`	Get page semantic structure
`explain_violation`	Explain an axe-core rule and how to fix it
`list_wcag_criteria`	Look up WCAG 2.2 criteria by level, principle, or keyword
`test_keyboard`	Test keyboard navigation (tab order, focus traps, indicators)
`analyze_structure`	Analyze landmarks, headings, form labels
`test_screen_reader`	Simulate screen reader navigation
`discover_pages`	Find all pages on a site via sitemap + link crawling
`run_full_audit`	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.json

GitHub Actions

- name: Accessibility check
  run: npx aria51 https://your-staging-url.com --ci --threshold 0

CLI 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 --deep

Packages

Package	Description
`@aria51/core`	Scanning engine, focused audits, full audit pipeline, WCAG 2.2 checks, component attribution
`@aria51/ai-auditor`	AI-enhanced deep analysis via Stagehand
`aria51`	Terminal interface. Binary: `aria51`
`@aria51/mcp`	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 test

Requirements: 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 --deep mode
Effect: Composable error handling and resource management
element-source: Maps DOM nodes to framework component source locations

License

MIT

This server cannot be deployed

RayrunBuild, deploy, and operate MCP servers without becoming an infrastructure team.ray.runAd

Maintenance

ActivityMaintained

ResponsivenessNo issues

Resources

GitHub Repository

Need Help?

Related Servers

Related MCP Connectors

accessibility-ai A
io.github.groundlogic-ai-source
Scan URLs for WCAG 2.1 violations, generate AI fixes, and produce VPAT 2.5 compliance reports.
Testing & QA Tools Legal & Compliance AI & Machine Learning
421
Cypress Cloud MCP BOAuth
io.cypress.mcp
Direct access to Cypress tests results and accessibility reports in your AI workflow.
Testing & QA Tools CI/CD & DevOps
24
Jeikin
com.jeikin
Accessibility compliance for AI coding tools. WCAG 2.2 reviews with shared evidence.
Testing & QA Tools Developer Tools
2
ProdPoke
io.github.prodpoke
AI QA tester — real browsers scan sites for bugs, SEO, perf, and accessibility issues via chat.
Testing & QA Tools Web Scraping Monitoring
21

Related MCP Servers

Accessibility MCP Server
Testing & QA Tools Browser Automation
dallask
A
license
A
quality
C
maintenance
Provides conversational, actionable accessibility testing for AI agents, including auditing, prioritization, and code-level fixes.
Updated 5 months ago (2026-04-14 07:46 UTC)
22
8
MIT
accessibility-mcp-server
Testing & QA Tools Browser Automation
AiAgentKarl
A
license
A
quality
D
maintenance
Enables 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.
Updated 5 months ago (2026-04-09 07:44 UTC)
8
MIT
Navable MCP
Testing & QA Tools Browser Automation
web-DnA
A
license
A
quality
C
maintenance
Enables 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.
Updated 2 months ago (2026-06-29 07:37 UTC)
3
93
1
MIT
Accessibility MCP Server
Testing & QA Tools Browser Automation
alii13
A
license
A
quality
F
maintenance
Enables AI agents to perform conversational accessibility testing with actionable insights, code-level fixes, and support for authenticated sessions and batch audits.
Updated 8 months ago (2026-01-10 13:25 UTC)
22
29
1
MIT