A11y Mcp

Name: A11y Mcp
Author: priyankark

@priyankark

About A11y Mcp

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!

#a11y #axe-core #accessibility #tests

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "a11y": {
      "command": "npx",
      "args": [
        "a11y-mcp"
      ],
      "disabled": false,
      "autoApprove": []
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

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": [] } }.