Skip to content
Back to search

a11ymcp

MCP Server for Web Accessibility Testing (10k+ Downloads, #20 on ProductHunt)

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/ronantakizawa--a11ymcp/badge.svg)](/listings/ronantakizawa--a11ymcp)

HTML

<a href="/listings/ronantakizawa--a11ymcp"><img src="/api/listings/ronantakizawa--a11ymcp/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

Prerequisites

- [Node.js](https://nodejs.org/) 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:

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

Claude Code (CLI)

claude mcp add a11y-accessibility -- npx -y a11y-mcp-server

This registers the server for the current project. To make it available across all projects:

claude mcp add --scope user a11y-accessibility -- npx -y a11y-mcp-server

Verify the server is registered:

claude mcp list

> **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`:

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

Cursor

Add to your Cursor MCP configuration (`.cursor/mcp.json`):

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

Windsurf

Add to your Windsurf MCP configuration (`~/.codeium/windsurf/mcp_config.json`):

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

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 330 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # Web Accessibility-Testing MCP Server (A11y MCP)
  2. <a href="https://www.producthunt.com/products/web-accessibility-testing-mcp?embed=true&utm_source=badge-featured&utm_medium=badge&utm_campaign=badge-web-accessibility-testing-mcp" target="_blank" rel="noopener noreferrer"><img alt="Web Accessibility Testing MCP - Give LLMs access to web accessibility testing APIs | Product Hunt" width="250" height="54" src="https://api.producthunt.com/widgets/embed-image/v1/featured.svg?post_id=1062073&theme=light&t=1768415232797"></a>
  3. [![MseeP.ai Security Assessment Badge](https://mseep.net/pr/ronantakizawa-a11ymcp-badge.png)](https://mseep.ai/app/ronantakizawa-a11ymcp)
  4. [![Verified on MseeP](https://mseep.ai/badge.svg)](https://mseep.ai/app/01361aeb-0dce-45d6-80fb-76ff443dbfc8)
  5. <a href="https://glama.ai/mcp/servers/@ronantakizawa/a11ymcp">
  6. <img width="380" height="200" src="https://glama.ai/mcp/servers/@ronantakizawa/a11ymcp/badge" />
  7. </a>
  8. https://github.com/user-attachments/assets/316c6d44-e677-433e-b4d5-63630b4bab2b
  9. A11y MCP is an [MCP (Model Context Protocol)](https://modelcontextprotocol.io/) server that gives LLMs access to web accessibility testing APIs.
  10. This server uses the [Deque Axe-core](https://github.com/dequelabs/axe-core) API and [Puppeteer](https://pptr.dev/) to allow LLMs to analyze web content for WCAG compliance and identify accessibility issues.
  11. > **Note:** This is not an official MCP server from Deque Labs.
  12. ## Features
  13. - **Test web pages**: Test any public URL for accessibility issues with customizable viewport dimensions
  14. - **Test HTML snippets**: Test raw HTML strings for accessibility issues
  15. - **WCAG compliance testing**: Check content against various WCAG standards (2.0, 2.1, 2.2)
  16. - **Customizable tests**: Specify which accessibility tags/standards to test against
  17. - **Rule exploration**: Get information about available accessibility rules
  18. - **Color contrast analysis**: Check color combinations for WCAG compliance
  19. - **ARIA validation**: Test proper usage of ARIA attributes
  20. - **Orientation lock detection**: Identify content that forces specific screen orientations
  21. ## Installation
  22. ### Prerequisites
  23. - [Node.js](https://nodejs.org/) 18 or later
  24. - An MCP-compatible client (Claude Desktop, Claude Code, VS Code, Cursor, etc.)
  25. ### Claude Desktop
  26. Edit your MCP configuration file:
  27. - **macOS:** `~/Library/Application Support/Claude/claude_desktop_config.json`
  28. - **Windows:** `%APPDATA%\Claude\claude_desktop_config.json`
  29. - **Linux:** `~/.config/Claude/claude_desktop_config.json`
  30. Add the server to the `mcpServers` object:
  31. ```json
  32. {
  33. "mcpServers": {
  34. "a11y-accessibility": {
  35. "command": "npx",
  36. "args": ["-y", "a11y-mcp-server"]
  37. }
  38. }
  39. }
  40. ```
  41. ### Claude Code (CLI)
  42. ```bash
  43. claude mcp add a11y-accessibility -- npx -y a11y-mcp-server
  44. ```
  45. This registers the server for the current project. To make it available across all projects:
  46. ```bash
  47. claude mcp add --scope user a11y-accessibility -- npx -y a11y-mcp-server
  48. ```
  49. Verify the server is registered:
  50. ```bash
  51. claude mcp list
  52. ```
  53. > **Note:** MCP tools become available after restarting your Claude Code session.
  54. ### VS Code (Copilot)
  55. Add to your VS Code `settings.json` or `.vscode/settings.json`:
  56. ```json
  57. {
  58. "mcp": {
  59. "servers": {
  60. "a11y-accessibility": {
  61. "command": "npx",
  62. "args": ["-y", "a11y-mcp-server"]
  63. }
  64. }
  65. }
  66. }
  67. ```
  68. ### Cursor
  69. Add to your Cursor MCP configuration (`.cursor/mcp.json`):
  70. ```json
  71. {
  72. "mcpServers": {
  73. "a11y-accessibility": {
  74. "command": "npx",
  75. "args": ["-y", "a11y-mcp-server"]
  76. }
  77. }
  78. }
  79. ```
  80. ### Windsurf
  81. Add to your Windsurf MCP configuration (`~/.codeium/windsurf/mcp_config.json`):
  82. ```json
  83. {
  84. "mcpServers": {
  85. "a11y-accessibility": {
  86. "command": "npx",
  87. "args": ["-y", "a11y-mcp-server"]
  88. }
  89. }
  90. }
  91. ```
  92. ## Available Tools
  93. ### test_accessibility
  94. Tests a URL for accessibility issues.
  95. **Parameters:**
  96. | Parameter | Required | Description |
  97. |-----------|----------|-------------|
  98. | `url` | Yes | The URL of the web page to test |
  99. | `tags` | No | Array of WCAG tags to test against (e.g., `["wcag2aa"]`) |
  100. | `width` | No | Viewport width in pixels (default: 1280) |
  101. | `height` | No | Viewport height in pixels (default: 800) |
  102. **Example — desktop viewport (default):**
  103. ```json
  104. {
  105. "url": "https://example.com",
  106. "tags": ["wcag2aa"]
  107. }
  108. ```
  109. **Example — mobile viewport (iPhone 12/13):**
  110. ```json
  111. {
  112. "url": "https://example.com",
  113. "tags": ["wcag2aa"],
  114. "width": 390,
  115. "height": 844
  116. }
  117. ```
  118. ### test_html_string
  119. Tests an HTML string for accessibility issues.
  120. **Parameters:**
  121. | Parameter | Required | Description |
  122. |-----------|----------|-------------|
  123. | `html` | Yes | The HTML content to test |
  124. | `tags` | No | Array of WCAG tags to test against (e.g., `["wcag2aa"]`) |
  125. | `width` | No | Viewport width in pixels (default: 1280) |
  126. | `height` | No | Viewport height in pixels (default: 800) |
  127. **Example — default viewport:**
  128. ```json
  129. {
  130. "html": "<div><img src='image.jpg'></div>",
  131. "tags": ["wcag2aa"]
  132. }
  133. ```
  134. **Example — mobile viewport:**
  135. ```json
  136. {
  137. "html": "<div><img src='image.jpg'></div>",
  138. "tags": ["wcag2aa"],
  139. "width": 375,
  140. "height": 812
  141. }
  142. ```
  143. ### get_rules
  144. Get information about available accessibility rules with optional filtering. Returns an array of rule objects, each containing `ruleId`, `description`, `help`, `helpUrl`, and `tags`.
  145. **Parameters:**
  146. | Parameter | Required | Description |
  147. |-----------|----------|-------------|
  148. | `tags` | No | Filter rules by tags (e.g., `["wcag2a", "wcag2aa", "best-practice"]`) |
  149. **Example — filter rules by WCAG 2.1 AA:**
  150. ```json
  151. {
  152. "tags": ["wcag21aa"]
  153. }
  154. ```
  155. **Example — get all rules (no filter):**
  156. ```json
  157. {}
  158. ```
  159. ### check_color_contrast
  160. Check if a foreground and background color combination meets WCAG contrast requirements.
  161. **Parameters:**
  162. | Parameter | Required | Description |
  163. |-----------|----------|-------------|
  164. | `foreground` | Yes | Foreground color (e.g., `"#000000"`, `"rgb(0,0,0)"`) |
  165. | `background` | Yes | Background color (e.g., `"#FFFFFF"`, `"rgb(255,255,255)"`) |
  166. | `fontSize` | No | Font size in pixels (default: 16) |
  167. | `isBold` | No | Whether the text is bold (default: false) |
  168. **Example:**
  169. ```json
  170. {
  171. "foreground": "#777777",
  172. "background": "#EEEEEE",
  173. "fontSize": 16,
  174. "isBold": false
  175. }
  176. ```
  177. ### check_aria_attributes
  178. Check if ARIA attributes are used correctly in HTML.
  179. **Parameters:**
  180. | Parameter | Required | Description |
  181. |-----------|----------|-------------|
  182. | `html` | Yes | HTML content to test for ARIA attribute usage |
  183. **Example:**
  184. ```json
  185. {
  186. "html": "<div role='button' aria-pressed='false'>Click me</div>"
  187. }
  188. ```
  189. ### check_orientation_lock
  190. Check if content forces a specific orientation.
  191. **Parameters:**
  192. | Parameter | Required | Description |
  193. |-----------|----------|-------------|
  194. | `html` | Yes | HTML content to test for orientation lock issues |
  195. **Example:**
  196. ```json
  197. {
  198. "html": "<html><head><meta name='viewport' content='width=device-width, orientation=portrait'></head><body>Content</body></html>"
  199. }
  200. ```
  201. ## Response Format
  202. The server returns accessibility test results in structured JSON:
  203. ```json
  204. {
  205. "violations": [
  206. {
  207. "id": "color-contrast",
  208. "impact": "serious",
  209. "description": "Ensure the contrast between foreground and background colors meets WCAG 2 AA minimum contrast ratio thresholds",
  210. "help": "Elements must meet minimum color contrast ratio thresholds",
  211. "helpUrl": "https://dequeuniversity.com/rules/axe/4.10/color-contrast",
  212. "affectedNodes": [
  213. {
  214. "html": "<div style=\"color: #aaa; background-color: #eee;\">Low contrast text</div>",
  215. "target": ["div"],
  216. "failureSummary": "Fix any of the following: Element has insufficient color contrast of 1.98 (foreground color: #aaa, background color: #eee, font size: 12.0pt, font weight: normal)"
  217. }
  218. ]
  219. }
  220. ],
  221. "passes": 1,
  222. "incomplete": 0,
  223. "inapplicable": 2,
  224. "timestamp": "2025-04-25T16:45:33.655Z",
  225. "url": "about:blank",
  226. "testEngine": {
  227. "name": "axe-core",
  228. "version": "4.10.3"
  229. }
  230. }
  231. ```
  232. ## WCAG Tags Reference
  233. Common tags you can use with the `tags` parameter:
  234. | Tag | Description |
  235. |-----|-------------|
  236. | `wcag2a` | WCAG 2.0 Level A |
  237. | `wcag2aa` | WCAG 2.0 Level AA |
  238. | `wcag2aaa` | WCAG 2.0 Level AAA |
  239. | `wcag21a` | WCAG 2.1 Level A |
  240. | `wcag21aa` | WCAG 2.1 Level AA |
  241. | `wcag22aa` | WCAG 2.2 Level AA |
  242. | `best-practice` | Best practices (not strictly WCAG) |
  243. ## Dependencies
  244. - [@modelcontextprotocol/sdk](https://github.com/modelcontextprotocol/sdk)
  245. - [puppeteer](https://pptr.dev/)
  246. - [@axe-core/puppeteer](https://github.com/dequelabs/axe-core-npm/tree/develop/packages/puppeteer)
  247. - [axe-core](https://github.com/dequelabs/axe-core)
  248. ## License
  249. MIT

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.