A11ymcp MCP Server

An MCP server for accessibility testing using Axe-core

Local serverstdio

What is the A11ymcp MCP Server?

An MCP server for accessibility testing using Axe-core.

What A11ymcp does

https://github.com/user-attachments/assets/316c6d44-e677-433e-b4d5-63630b4bab2b

Key capabilities

  • 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

Requirements

  • Node.js 18 or later - An MCP-compatible client (Claude Desktop, Claude Code, VS Code, Cursor, etc.)

Practical notes

  • Maintained by ronantakizawa.

Recorded tools

  • test_accessibility — The test_accessibility tool exposed by this server.
  • test_html_string — The test_html_string tool exposed by this server.
  • 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.
  • check_color_contrast — Check if a foreground and background color combination meets WCAG contrast requirements.
  • check_aria_attributes — The check_aria_attributes tool exposed by this server.
  • check_orientation_lock — The check_orientation_lock tool exposed by this server.

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
urlYes
tagsNo
widthNo
heightNo
htmlYes
foregroundYes
backgroundYes
fontSizeNo
isBoldNo
test_accessibility
test_html_string
get_rules
check_color_contrast
check_aria_attributes
check_orientation_lock

How to install the A11ymcp MCP Server

{
  "mcpServers": {
    "a11y-accessibility": {
      "command": "npx",
      "args": [
        "-y",
        "a11y-mcp-server"
      ]
    }
  }
}

From the project documentation. Replace placeholders and example paths before connecting.

Configuration

  • Node.js 18 or later - An MCP-compatible client (Claude Desktop, Claude Code, VS Code, Cursor, etc.)

Example prompts to try

  • “Use A11ymcp to Prerequisites.”
  • “Use A11ymcp to Cursor.”
  • “Use A11ymcp to Windsurf.”

Frequently asked questions

An MCP server for accessibility testing using Axe-core Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.