A11y Mcp
@priyankark
An MCP (Model Context Protocol) server for performing accessibility audits on webpages using axe-core. Use the results in an agentic loop with your favorite AI assistants (Cline/Cursor/GH Copilot) and let them fix a11y issues for you!
Overview
What is A11y Mcp?
A11y Mcp is an MCP server that performs accessibility audits on webpages using axe-core. It enables AI assistants like Cline, Cursor, and GitHub Copilot to detect and fix accessibility issues in an agentic workflow.
How to use A11y Mcp?
Install globally with npm install -g a11y-mcp or run directly with npx a11y-mcp. Add it to your MCP settings configuration as a JSON object under mcpServers. Then ask your AI assistant to audit a URL using available tools like audit_webpage and get_summary.
Key features of A11y Mcp
- Perform detailed accessibility audits on any webpage
- Get a summary of accessibility issues
- Filter audits by specific WCAG criteria
- Include HTML snippets in results for debugging
- Works with Cline, Cursor, and GitHub Copilot
- Uses axe-core for reliable compliance checks
Use cases of A11y Mcp
- Audit a live website for WCAG 2.1 AA compliance
- Get a quick summary of issues on any public page
- Integrate accessibility checks into a local development server
- Let an AI agent fix detected issues in an automated loop
- Filter audits to focus on specific accessibility tags
FAQ from A11y Mcp
What tools does A11y Mcp provide?
It provides audit_webpage for full audits and get_summary for a summary of issues. Both require a url parameter; audit_webpage also accepts optional includeHtml and tags parameters.
How do I configure A11y Mcp with Cline?
Add a JSON entry under mcpServers in your MCP settings file: { "a11y": { "command": "npx", "args": ["a11y-mcp"], "disabled": false, "autoApprove": [] } }.
Can I audit a local development server?
Yes, the url parameter accepts any valid URL, such as http://localhost:3000, making it suitable for local testing.
What is the license of A11y Mcp?
A11y Mcp is licensed under the MPL 2.0 license.
Does A11y Mcp require any external dependencies?
It uses axe-core for audits and runs via Node.js, so you need Node.js installed to use it with npx or after global installation.
