MCP server providing accessibility criteria from MagentaA11y. Works locally (stdio) and remotely (Netlify Functions).

{
  "mcpServers": {
    "magentaa11y": {
      "command": "npx",
      "args": ["-y", "magentaa11y-mcp"]
    }
  }
}

mcp add --scope user magentaa11y -- npx -y magentaa11y-mcp

Use --scope project instead of --scope user to install for the current project only.

{
  "mcpServers": {
    "magentaa11y": {
      "command": "node",
      "args": ["/path/to/src/index.js"]
    }
  }
}

Clone this project, build it, and deploy to Netlify. Then use the following configuration:

{
  "mcpServers": {
    "magentaa11y": {
      "command": "npx",
      "args": ["mcp-remote@next", "https://your-site.netlify.app/mcp"]
    }
  }
}

• Get me the accessibility criteria for the Web Button component in Gherkin format.
• Get me a list of all the native components.
• Get me the Tooltip AC for Web - Condensed in markdown format.

All tools are read-only, non-destructive, and idempotent. They include OpenAI Apps SDK annotations for enhanced integration.

Each tool includes these annotations (OpenAI Apps SDK compatible):

• readOnlyHint: true - Tools only read data, never modify
• destructiveHint: false - No destructive operations
• idempotentHint: true - Same input always produces same output
• openWorldHint: false - Operates on curated MagentaA11y dataset

git clone --recurse-submodules https://github.com/joe-watkins/magentaa11y-mcp.git
cd magentaa11y-mcp
npm install
npm run update-content

The accessibility criteria comes from the magentaA11y submodule. To update:

npm run update-content

This pulls the latest from magentaA11y, builds it, and copies the generated content.json to /data.

src/
  index.js          # MCP server (stdio transport)
  tools.js          # Tool definitions and handlers
  helpers.js        # Data loading and search utilities
data/
  content.json      # MagentaA11y accessibility criteria
netlify/
  functions/api.js  # Netlify Function (SSE transport)
scripts/
  update-content.js # Build script for updating content

This MCP server is licensed under the MIT License.

The accessibility criteria content served by this MCP server is sourced from MagentaA11y by T-Mobile, which is licensed under the Apache License 2.0.

MagentaA11y © T-Mobile USA, Inc. - Licensed under Apache 2.0

• MagentaA11y Website
• MagentaA11y GitHub
• npm Package
• MCP Registry

This MCP server is read-only and collects no user data. All accessibility criteria is sourced from the public MagentaA11y project.