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.