A11y Mcp

by priyankark

381 downloads
Not rated
GitHub

About

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!

Details

Author
priyankark
Downloads
381
Categories
Developer Tools, Other

- 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

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name A11y Mcp
    Command (node, npx, python, etc.)

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

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.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

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

McpServers

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

Perform accessibility audits on webpages using the axe-core engine to identify and help fix a11y issues.

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!

- Perform detailed accessibility audits on any webpage
- Get a summary of accessibility issues
- Filter audits by specific WCAG criteria
- Include HTML snippets in the results for easier debugging

# Install globally npm install -g a11y-mcp # Or use directly with npx npx a11y-mcp

To use this MCP server with Cline, you need to add it to your MCP settings configuration file.

Add the following to themcpServersobject:

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

Performs a detailed accessibility audit on a webpage.

- url(required): URL of the webpage to audit
- includeHtml(optional): Whether to include HTML snippets in the results (default: false)
- tags(optional): Array of specific accessibility tags to check (e.g., wcag2a, wcag2aa, wcag21a, best-practice)

Use the a11y MCP server to audit example.com for accessibility issues

Gets a summary of accessibility issues for a webpage.

- url(required): URL of the webpage to audit

Give me an accessibility summary of example.com

Once configured, you can ask Claude to use the MCP server to perform accessibility audits:
- "Can you check example.com for accessibility issues?"
- "Audit my website athttps://mywebsite.comfor WCAG 2.1 AA compliance"
- "Give me a summary of accessibility issues on
https://example.com"
- "Check if my local development server at
http://localhost:3000has any critical accessibility problems"

To run the server locally for development:

This project includes a release script to help with versioning and publishing to npm. The script handles version bumping, running tests, git tagging, and npm publishing.

# Make sure the script is executable chmod +x release.sh # Release a patch version (default) ./release.sh # Release a minor version ./release.sh --minor # Release a major version ./release.sh --major # Release a specific version ./release.sh --version=1.2.3 # Skip git operations ./release.sh --skip-git # Dry run (no changes will be made) ./release.sh --dry-run # Force release even with uncommitted changes ./release.sh --force

This project builds atop the awesome work done byaxe-core

This is a web browser that enables your coding agent, such as Claude Code, to visit websites on your behalf and assist you in identifying bugs or creating UI test cases.

Create crafted UI components inspired by the best 21st.dev design engineers.

Bring agent evaluations, observability, and synthetic test set generation directly into your IDE for free with Galileo's new MCP server

An MCP server to help AI assistants to answer questions and generate AccelByte Extend SDK code more effectively .

MCP server for AI Diagram Maker — generate beautiful software engineering diagrams directly inside Cursor, Claude Desktop, Claude Code, or any MCP-compatible AI agent

ALAPI MCP Tools,Call hundreds of API interfaces via MCP

AI-powered SVG animation generator that transforms static files into animated SVG components using the Allyson platform

MCP server that gives AI assistants on-demand access to 1,500+ amCharts docs, ~300 code examples, and 1000+ class API references.

APIMatic MCP Server is used to validate OpenAPI specifications using APIMatic. The server processes OpenAPI files and returns validation summaries by leveraging APIMatic’s API.

One shared context layer for AI agents and humans — live API specs, DB schemas, and versioned contracts across repos so every agent and teammate works from the same source of truth.

Build and deploy full-stack Next.js apps with 98 tools for React, AWS, and MongoDB

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.