MCP server for testing web content and HTML snippets for WCAG 2.0/2.1/2.2 accessibility compliance using axe-core.
Quick Install
Automated & IDE SetupCopy the AI prompt to install this server into Claude Code, Cursor, or another agent — or use 1-click editor setup below.
Not yet automatically verified
We haven't yet run this listing's install command through our automated sandbox check. This isn't a red flag — we're steadily working through the catalog.
Manual Client & Custom JSON ConfigExpand JSON ▾
Client Config & Setup
Choose your client or environment
Target File:
💡 Paste the JSON block into your client's configuration file under mcpServers, then restart the application.
Overview
Use cases
Test public URLs for WCAG accessibility compliance
Analyze raw HTML snippets for accessibility issues
Validate color contrast ratios against WCAG standards
Check proper usage of ARIA attributes
Detect content enforcing specific screen orientations
Key features
Accessibility testing of URLs and HTML strings
Supports WCAG 2.0, 2.1, and 2.2 compliance levels
Customizable viewport dimensions for testing
Rule exploration with detailed accessibility rule info
Color contrast analysis per WCAG guidelines
ARIA attribute validation and orientation lock detection
Capabilities & Tool Schemas
Inspect callable tools, capabilities, and parameters exposed to AI agents by A11ymcp.
Extracted Tool Capabilities
Accessibility testing of URLs and HTML strings
Supports WCAG 2.0, 2.1, and 2.2 compliance levels
Customizable viewport dimensions for testing
Rule exploration with detailed accessibility rule info
Color contrast analysis per WCAG guidelines
ARIA attribute validation and orientation lock detection
Documentation Overview
Web Accessibility-Testing MCP Server (A11y MCP)
https://github.com/user-attachments/assets/316c6d44-e677-433e-b4d5-63630b4bab2b
A11y MCP is an MCP (Model Context Protocol) server that gives LLMs access to web accessibility testing APIs.
This server uses the Deque Axe-core API and Puppeteer to allow LLMs to analyze web content for WCAG compliance and identify accessibility issues.
Note: This is not an official MCP server from Deque Labs.
Features
- Test web pages: Test any public URL for accessibility issues with customizable viewport dimensions
- Test HTML snippets: Test raw HTML strings for accessibility issues
- WCAG compliance testing: Check content against various WCAG standards (2.0, 2.1, 2.2)
- Customizable tests: Specify which accessibility tags/standards to test against
- Rule exploration: Get information about available accessibility rules
- Color contrast analysis: Check color combinations for WCAG compliance
- ARIA validation: Test proper usage of ARIA attributes
- Orientation lock detection: Identify content that forces specific screen orientations
Installation
Prerequisites
- Node.js 18 or later
- An MCP-compatible client (Claude Desktop, Claude Code, VS Code, Cursor, etc.)
Claude Desktop
Edit your MCP configuration file:
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - Windows:
%APPDATA%\Claude\claude_desktop_config.json - Linux:
~/.config/Claude/claude_desktop_config.json
Add the server to the mcpServers object:
Claude Code (CLI)
This registers the server for the current project. To make it available across all projects:
Verify the server is registered:
Note: MCP tools become available after restarting your Claude Code session.
VS Code (Copilot)
Add to your VS Code settings.json or .vscode/settings.json:
Cursor
Add to your Cursor MCP configuration (.cursor/mcp.json):
Windsurf
Add to your Windsurf MCP configuration (~/.codeium/windsurf/mcp_config.json):
Available Tools
test_accessibility
Tests a URL for accessibility issues.
Parameters:
| Parameter | Required | Description |
|---|---|---|
url | Yes | The URL of the web page to test |
tags | No | Array of WCAG tags to test against (e.g., ["wcag2aa"]) |
width | No | Viewport width in pixels (default: 1280) |
height | No | Viewport height in pixels (default: 800) |
Example — desktop viewport (default):
Example — mobile viewport (iPhone 12/13):
test_html_string
Tests an HTML string for accessibility issues.
Parameters:
| Parameter | Required | Description |
|---|---|---|
html | Yes | The HTML content to test |
tags | No | Array of WCAG tags to test against (e.g., ["wcag2aa"]) |
width | No | Viewport width in pixels (default: 1280) |
height | No | Viewport height in pixels (default: 800) |
Example — default viewport:
Example — mobile viewport:
get_rules
Get information about available accessibility rules with optional filtering. Returns an array of rule objects, each containing ruleId, description, help, helpUrl, and tags.
Parameters:
| Parameter | Required | Description |
|---|---|---|
tags | No | Filter rules by tags (e.g., ["wcag2a", "wcag2aa", "best-practice"]) |
Example — filter rules by WCAG 2.1 AA:
Example — get all rules (no filter):
check_color_contrast
Check if a foreground and background color combination meets WCAG contrast requirements.
Parameters:
| Parameter | Required | Description |
|---|---|---|
foreground | Yes | Foreground color (e.g., "#000000", "rgb(0,0,0)") |
background | Yes | Background color (e.g., "#FFFFFF", "rgb(255,255,255)") |
fontSize | No | Font size in pixels (default: 16) |
isBold | No | Whether the text is bold (default: false) |
Example:
check_aria_attributes
Check if ARIA attributes are used correctly in HTML.
Parameters:
| Parameter | Required | Description |
|---|---|---|
html | Yes | HTML content to test for ARIA attribute usage |
Example:
check_orientation_lock
Check if content forces a specific orientation.
Parameters:
| Parameter | Required | Description |
|---|---|---|
html | Yes | HTML content to test for orientation lock issues |
Example:
Response Format
The server returns accessibility test results in structured JSON:
WCAG Tags Reference
Common tags you can use with the tags parameter:
| Tag | Description |
|---|---|
wcag2a | WCAG 2.0 Level A |
wcag2aa | WCAG 2.0 Level AA |
wcag2aaa | WCAG 2.0 Level AAA |
wcag21a | WCAG 2.1 Level A |
wcag21aa | WCAG 2.1 Level AA |
wcag22aa | WCAG 2.2 Level AA |
best-practice | Best practices (not strictly WCAG) |
Dependencies
License
MIT
Related MCP Servers
Adoption & maintenance
Factual signals from GitHub, npm, and our automated checks — not a rating.
GitHub stars
91
Stargazers on the source repository.
npm downloads
892
Package downloads in the last 30 days.
Last commit
6mo ago
Most recent push to the default branch.
Directory activity
1 views
Config copies, upvotes, and views on AllMCPs.
Reviews
No reviews yet — be the first to share how this listing worked for you.
Frequently Asked Questions about A11ymcp
AllMCPs Directory Badge
Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.
Badge Style:
Live Dynamic SVG Preview
Markdown (GitHub README)
[](https://allmcps.com/mcp/ronantakizawa-a11ymcp)HTML Embed
<a href="https://allmcps.com/mcp/ronantakizawa-a11ymcp"><img src="https://allmcps.com/api/badge/ronantakizawa-a11ymcp?style=directory" alt="A11ymcp on AllMCPs" /></a>Technical Specs & Signals
CategoryBrowser Automation
10/11 checks healthy over the last 33d
52Quality signal: Good · 52/100How this signal is calculated ▾
Server availabilityNot measured
Not scored for repo-hosted servers — we can't reach the running server, only its GitHub page. Hosted MCP endpoints are health-checked live.
Verified ownership10/20
Documentation & tools22/30
Adoption & activity7/15
Community engagement0/10
A guidance signal from public completeness & health data — not a user rating. New listings start lower and rise as they add docs, get verified, and grow adoption. Signals we can't observe for a listing are skipped, not counted against it.
Supply-chain signal
No high-severity advisories surfaced by our automated scan.
Critical 0High 0Medium 0Low 0
Scanned 27d ago via OSV.dev · a11y-mcp-server (npm)
Own this project?
This directory is pre-filled from public sources. Claim via GitHub README, site badge, or DNS TXT to unlock edit access and the Official badge — proof is checked automatically, then reviewed by our team.
Free dofollow backlink: add your website and place the AllMCPs badge on it — no claim needed. We detect it automatically and keep it verified as long as the badge stays live.
Claim & get free dofollowShare & Embed
Add our SVG badge (dark/light directory styles) or embeddable widget to your site.