Web Accessibility Testing MCP

Web Accessibility Testing MCP

Ronan Takizawa · Coding

Web Accessibility Testing MCP is an open-source Model Context Protocol server that hands an AI client the ability to check web pages for accessibility problems. It pairs Deque's Axe-core engine with Puppeteer, so an assistant like Claude Desktop or Cursor can test a live URL or a raw HTML snippet and report back on WCAG 2.0, 2.1, and 2.2 compliance. You give it a page. It gives you a list of what's broken and where.

Interface preview of Web Accessibility Testing MCP

About Web Accessibility Testing MCP

What Is Web Accessibility Testing MCP

Web Accessibility Testing MCP, often shortened to a11y MCP, is a small MCP accessibility testing server that connects an AI coding assistant to the same engine many professional audit teams already use. It wraps the Axe-core library from Deque Labs and drives a real headless browser through Puppeteer, so the checks run against rendered pages rather than static markup.

The point is placement. No separate dashboard. No copying results between tabs. Instead, you ask your assistant to look at a URL, and the results come back as a normal chat response. That matters when you're shipping a component and want a quick WCAG compliance testing pass before a pull request.

The biggest limits are worth stating plainly. It's a community project, not an official Deque product. Support comes from the GitHub repo, not a vendor help desk. It also only tests what Axe-core can detect automatically, which covers many real issues but never catches everything a human reviewer would.

Getting Started

  1. Make sure Node.js 18 or later is on your machine and pick an MCP-compatible client such as Claude Desktop, Claude Code, VS Code, or Cursor.
  2. Open your client's MCP configuration file, which lives at a different path on macOS, Windows, and Linux.
  3. Add an entry named a11y-accessibility under mcpServers with the command npx and the argument -y a11y-mcp-server.
  4. Restart the client session so the new tools register, then confirm the server shows up in your tool list.
  5. Ask the assistant to test a URL against a tag like wcag2aa, and optionally set the viewport width and height for a mobile or desktop check.

Product Information

A quick look at Web Accessibility Testing MCP's pricing, supported platforms, and performance.

Free PlanYes
Paid Plans$0
PlatformNode.js 18+ with MCP clients (Claude Desktop, Claude Code, VS Code, Cursor, Windsurf)
DeveloperRonan Takizawa
CategoryCoding
Release DateMar 2025
Latest UpdatedSep 2025
Website Visits649.3M
Website Global Rank50
API AvailabilityYes

Best for

The users, tasks, and scenarios where this tool fits best.

Users

  • Front-end developers
  • QA and accessibility testers
  • Small teams without a dedicated auditor

Tasks

  • Testing a live page
  • Testing an HTML snippet
  • Color contrast analysis
  • ARIA validation

Scenarios

  • Pre-commit checks
  • Responsive review
  • Regression tracking

Key features

URL and HTML Snippet Testing

The server tests any public URL or a raw HTML string. That covers both a live page you can't easily inspect by hand and a fragment still sitting in your editor. Each run returns a structured report. No screenshots. The assistant can summarize the violations directly.

Axe-core and Puppeteer Integration

Checks run through Deque's Axe-core engine inside a real headless browser driven by Puppeteer. These are Axe-core accessibility checks, the same kind a professional audit team runs. Because the page is fully rendered, the results reflect what users actually load, not just the source HTML. It's the same detection logic a lot of professional tooling relies on.

WCAG 2.0, 2.1, and 2.2 Compliance Testing

You choose which standards to test against with tags like wcag2aa. The server checks content against 2.0, 2.1, and 2.2 rules, so you can match the level your project actually targets instead of running everything.

Customizable Viewport Dimensions

Width and height are configurable, with defaults of 1280 by 800. Setting a phone-sized viewport surfaces issues that only show up on small screens. Cramped tap targets, for instance. Or content that breaks at narrow widths.

Color Contrast and ARIA Checks

Two common failure areas get their own tools. A color contrast analyzer validates text and background pairings, while ARIA validation looks at whether attributes are used correctly and completely. Both catch problems that are tedious to verify by eye.

Rule Exploration

A rule-exploration tool explains which accessibility rules exist and what they mean. That's useful when a report flags something you don't recognize and you want context before deciding whether it's a real problem.

Orientation Lock Detection

The server flags content that forces a specific screen orientation. That matters for users on tablets or with motor conditions, where a locked orientation can make a page unusable.

Pros and cons

Pros

  • Runs inside your existing AI client, so no separate dashboard or account to manage.
  • Free and open source, with the full code available on GitHub.
  • Built on Axe-core, a widely trusted accessibility rule engine.
  • Tests both live URLs and raw HTML, covering early and late stages of a build.
  • Configurable WCAG tags and viewport sizes give control over test scope.

Cons

  • Automated checks miss issues that need human judgment, so it can't replace a manual audit.
  • Requires Node.js 18+ and an MCP-capable client, which rules out casual non-technical users.
  • It's a community project and not an official Deque product, so no vendor support line.

Frequently asked questions

It's an AI accessibility testing tool that connects an AI assistant to Deque's Axe-core engine, so the assistant can test web pages and HTML snippets for accessibility issues and WCAG compliance. That makes it handy for accessibility testing for developers who'd rather not leave their editor. You ask, and it returns a structured list of violations.