Accessibility Auditor
An MCP server for accessibility auditing that provides WCAG 2.2 criteria lookup, HTML remediation guidance, and automated documentation generation for UI components. It enables users to analyze code snippets for issues and generate professional acces
What is Accessibility Auditor?
Accessibility Auditor is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to mcp server for accessibility auditing that provides wcag 2.2 criteria lookup, html remediation guidance, and automated documentation generation for ui components. it enables users to analyze code snip...
An MCP server for accessibility auditing that provides WCAG 2.2 criteria lookup, HTML remediation guidance, and automated documentation generation for UI components. It enables users to analyze code snippets for issues and generate professional acces
This server falls under the Developer Tools category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- audit_webpage
- get_summary
Use Cases
Maintainer
Works with
Installation
NPM
npx -y a11y-mcpManual Installation
npx -y a11y-mcpConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use Accessibility Auditor
The a11y MCP server integrates axe-core-based accessibility auditing directly into AI assistant workflows, allowing Claude and other MCP clients to audit live webpages for WCAG 2.2 compliance, retrieve structured violation reports with HTML snippets, and generate professional remediation guidance without any API keys or external services. It exposes two core tools — audit_webpage for detailed per-element analysis and get_summary for a quick issue count — making it practical for developers, QA engineers, and accessibility consultants who want AI-driven a11y reviews as part of their coding sessions.
Prerequisites
- Node.js 18 or higher installed
- npx available (bundled with npm 5.2+)
- No API keys or accounts required
- An MCP-compatible client such as Claude Desktop
Test the server with npx before configuring your client
Run a quick npx command to confirm the package downloads and starts correctly. The server will print its startup message to stderr.
npx -y a11y-mcpOpen your Claude Desktop configuration file
Edit the claude_desktop_config.json file. On macOS it lives at ~/Library/Application Support/Claude/claude_desktop_config.json; on Windows at %APPDATA%\Claude\claude_desktop_config.json.
Add the a11y-mcp server entry
Register the server using npx so Claude always runs the latest published version. No environment variables are needed.
{
"mcpServers": {
"a11y": {
"command": "npx",
"args": ["-y", "a11y-mcp"]
}
}
}Restart Claude Desktop
Quit and reopen Claude Desktop. The a11y server will appear in the connected tools list. You can now ask Claude to audit any publicly accessible URL.
Accessibility Auditor Examples
Client configuration
Minimal claude_desktop_config.json entry for the a11y MCP server. No authentication required.
{
"mcpServers": {
"a11y": {
"command": "npx",
"args": ["-y", "a11y-mcp"]
}
}
}Prompts to try
Example prompts that exercise the audit_webpage and get_summary tools with various WCAG tag filters.
- "Check https://example.com for accessibility issues and list any WCAG 2.1 AA violations"
- "Audit my local dev server at http://localhost:3000 for critical a11y problems and include the failing HTML"
- "Give me a summary of accessibility issues on https://mycompany.com/checkout"
- "Run a best-practice accessibility check on https://myblog.com and suggest fixes for each violation"
- "Audit https://app.example.com filtering only for wcag2aa criteria and generate a remediation report"Troubleshooting Accessibility Auditor
audit_webpage returns no results for a URL
The axe-core engine requires the page to be publicly accessible — it cannot audit pages behind login walls or localhost unless the MCP server and browser share the same network. For local pages, ensure the dev server is running and the port is open.
npx -y a11y-mcp fails with a permission error
Clear the npx cache with `npm cache clean --force` and retry. If using a corporate proxy, ensure it does not block npm registry requests. As a fallback, install globally with `npm install -g a11y-mcp` and use `a11y-mcp` as the command.
Results differ from running axe DevTools in the browser
The server uses axe-core programmatically without a full browser rendering engine, so dynamic content that loads via JavaScript after page load may not be fully evaluated. For SPAs, consider auditing specific component HTML snippets directly via the tags parameter.
Frequently Asked Questions about Accessibility Auditor
What is Accessibility Auditor?
Accessibility Auditor is a Model Context Protocol (MCP) server that mcp server for accessibility auditing that provides wcag 2.2 criteria lookup, html remediation guidance, and automated documentation generation for ui components. it enables users to analyze code snippets for issues and generate professional acces It connects AI assistants to external tools and data sources through a standardized interface.
How do I install Accessibility Auditor?
Install via npm with the command: npx -y a11y-mcp. Then add the server configuration to your AI client's JSON config file (e.g., claude_desktop_config.json or .cursor/mcp.json).
Which AI clients work with Accessibility Auditor?
Accessibility Auditor works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is Accessibility Auditor free to use?
Yes, Accessibility Auditor is open source and available under the Mozilla Public License 2.0 license. You can use it freely in both personal and commercial projects.
Accessibility Auditor Alternatives — Similar Developer Tools Servers
Looking for alternatives to Accessibility Auditor? Here are other popular developer tools servers you can use with Claude, Cursor, and VS Code.
Ecc
★ 188.2kThe agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.
Javaguide
★ 155.8kJava 面试 & 后端通用面试指南，覆盖计算机基础、数据库、分布式、高并发、系统设计与 AI 应用开发
Gemini CLI
★ 104.5kA secure MCP server that wraps the Google Gemini CLI, allowing clients to query Gemini models using local OAuth sessions without requiring an API key. It provides tools for model interaction and diagnostics with built-in protection against command in
Awesome MCP Servers
★ 87.3k⭐ Curated list of Model Context Protocol (MCP) servers - tools that extend Claude Desktop, Cursor, Windsurf, and other MCP clients with custom capabilities.
MCP Servers
★ 86.0kModel Context Protocol Servers
CC Switch
★ 77.5kA cross-platform desktop All-in-One assistant for Claude Code, Codex, OpenCode, OpenClaw, Gemini CLI & Hermes Agent. Only official website: ccswitch.io
Browse More Developer Tools MCP Servers
Explore all developer tools servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up Accessibility Auditor in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use Accessibility Auditor?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.