MagentaA11y MCP Server

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

Installation

Via npm (Recommended)

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

Claude Code CLI

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

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

Local Development

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

Remote (Netlify)

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"]
    }
  }
}

Example Prompts

• 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.

Tools

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

Tool	Description
list_web_components	List web accessibility components
get_web_component	Get detailed criteria for a web component
search_web_criteria	Search web criteria by keyword
list_native_components	List native iOS/Android components
get_native_component	Get detailed criteria for a native component
search_native_criteria	Search native criteria by keyword
get_component_gherkin	Get Gherkin-style acceptance criteria
get_component_condensed	Get condensed acceptance criteria
get_component_developer_notes	Get developer implementation notes
get_component_native_notes	Get iOS or Android specific notes
list_component_formats	List available formats for a component

OpenAI Marketplace Tool Annotations

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

Development Setup

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

Updating 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.

Project Structure

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

License

This MCP server is licensed under the MIT License.

Third-Party Content Attribution

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

Links

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

Privacy & Data Handling

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