1. Conduid
  2. Cloud
  3. A11y MCP
MCP server · Cloud

A11y MCP

by · github.com/antonio-rmrz/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 (Amp/Cline/Cursor/GH Copilot) and let them fix a11y issues for you!

Unclaimed MIT a11ya11y-aia11y-mcpa11y-testingaxe-aiaxe-mcp
InstallView source
49Fair

Scored 7 days ago · breakdown

About A11y MCP

A11y MCP is an MCP server published by antonio-rmrz in the Cloud category: 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 (Amp/Cline/Cursor/GH Copilot) and let them fix a11y issues for you!.

Recent commit activity is the strongest signal that reported issues will get attention.

Install

From source
git clone https://github.com/antonio-rmrz/a11y-mcp

This server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.

Tools (7)

configure_rulesEnable/disable specific axe rules

Parameters not published.

export_reportExport as JSON, HTML, or CSV

Parameters not published.

get_full_reportFull axe results (violations, passes, incomplete)

Parameters not published.

get_violationsGet detailed violation info from last scan

Parameters not published.

scan_elementScan a specific CSS selector

Parameters not published.

scan_pageScan a URL for WCAG violations

Parameters not published.

set_wcag_levelSet WCAG level (A, AA, AAA, 21A, 21AA, 22AA)

Parameters not published.

Ask AI

✦

Ask AI about A11y MCP

Powered by Claude · Grounded in docs

I know everything about A11y MCP. Ask me about installation, configuration, usage, or troubleshooting.

Security checks

  • ✓README presentThe repository ships documentation.
  • ✓License declaredUsable under a stated license.
  • !Scoped permissionsDoesn't declare a permission scope. Assume it can do anything its process can.

3 checks have not been run yet.

Releases

0.1.10.1.1 · 18 Dec 2025[0.1.1] - 2025-12-18 Fixed CSV export now handles shadow DOM and iframe elements correctly HTML report selector display for nested element contexts Changed Renamed internal module from `a11y_agent` to `a11y_mcp` for consistency
v0.1.0v0.1.0 · 18 Dec 2025

README

a11y-mcp

PyPI

MCP server for running axe-core accessibility audits. Uses Camoufox to bypass Cloudflare and other bot protection.

Install

# Claude Code
claude mcp add a11y -- uvx a11y-mcp

# Or with pip
pip install a11y-mcp

Configuration

For Claude Desktop, add to your config (~/Library/Application Support/Claude/claude_desktop_config.json on macOS):

{
  "mcpServers": {
    "a11y": {
      "command": "uvx",
      "args": ["a11y-mcp"]
    }
  }
}

Most editors use the same format. Add to your MCP config:

{
  "mcpServers": {
    "a11y": {
      "command": "uvx",
      "args": ["a11y-mcp"]
    }
  }
}

Config locations:

  • Cursor: ~/.cursor/mcp.json
  • VS Code (Continue): .continue/config.json under experimental.modelContextProtocolServers
  • VS Code (Cline): Cline MCP settings
  • Zed: ~/.config/zed/settings.json under context_servers

Tools

Tool Description
scan_page Scan a URL for WCAG violations
scan_element Scan a specific CSS selector
get_violations Get detailed violation info from last scan
get_full_report Full axe results (violations, passes, incomplete)
export_report Export as JSON, HTML, or CSV
set_wcag_level Set WCAG level (A, AA, AAA, 21A, 21AA, 22AA)
configure_rules Enable/disable specific axe rules

Usage

> Scan https://example.com for accessibility issues

> Export an HTML report for the last scan

> Check WCAG 2.2 AA compliance for https://adobe.com

WCAG Levels

Level Standard
A, AA, AAA WCAG 2.0
21A, 21AA WCAG 2.1
22AA WCAG 2.2

Default is AA.

Cloudflare Bypass

This uses Camoufox, an anti-detect browser with fingerprint spoofing at the C++ level. It handles JavaScript challenges, Turnstile, and most bot detection automatically.

On first run, Camoufox downloads a browser binary (~300MB).

Requirements

  • Python 3.10+
  • macOS, Linux, or Windows

Troubleshooting

Browser won't launch: Run python -c "import camoufox; camoufox.install()"

Cloudflare still blocking: Some sites have aggressive detection. The first visit may require manual verification.

axe-core won't inject: Likely a strict CSP. Try a different page on the same domain.

Development

git clone https://github.com/anthropics/a11y-mcp && cd a11y-mcp
uv venv && source .venv/bin/activate
uv pip install -e ".[dev]"
python -m camoufox fetch
pytest

Debug with the MCP inspector:

npx @modelcontextprotocol/inspector uvx a11y-mcp

License

MIT License - see LICENSE for details.

Credits

  • axe-core - Accessibility testing engine by Deque
  • Camoufox - Anti-detect browser
  • MCP - Model Context Protocol by Anthropic

Related Projects

README copy captured when this server was indexed; it may lag the repository. The original is authoritative.

Questions

About A11y MCP

How do I install A11y MCP?

No package has been published for this server, so install it from source: clone the repository and follow its README.

Is A11y MCP safe to use with an AI agent?

Its trust score is 49 out of 100 (fair). It passes 2 of the 3 static security checks run so far; the failures are listed above. It has no ConduID identity yet, so agent calls to it are not receipted.

Is A11y MCP still maintained?

Yes — the last commit was 2 months ago. The repository has 0 stars and 0 forks.