Skip to main content
Glama
justinleeirizarry

aria51 MCP Server

by justinleeirizarry
OverviewSchemaRelated ServersScoreDiscussions
TypeScript
Local

aria51

Accessibility testing that catches what axe-core misses — 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

No config, no API key, no setup.

Focused Audits

Test specific accessibility dimensions that static analysis tools can't reach:

# 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 It Finds That Other Tools Miss

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

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

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 installed

A
license - permissive license
-
quality - not tested
B
maintenance

How are these scores calculated?

Maintenance

–Maintainers
–Response time
1dRelease cycle
4Releases (12mo)

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Latest Blog Posts

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/justinleeirizarry/aria51'

If you have feedback or need assistance with the MCP directory API, please join our Discord server