# A11y MCP

Run WCAG compliance tests, ARIA attribute tests, and accessible color contrast tests via the axe-core API. Users can upload raw HTML or URLs to run tests.

## Quick Start

```bash
# Connect this server (installs CLI if needed)
npx -y @smithery/cli@latest mcp add ronantakizawa/a11ymcp

# Browse available tools
npx -y @smithery/cli@latest tool list ronantakizawa/a11ymcp

# Get full schema for a tool
npx -y @smithery/cli@latest tool get ronantakizawa/a11ymcp test_accessibility

# Call a tool
npx -y @smithery/cli@latest tool call ronantakizawa/a11ymcp test_accessibility '{}'
```

## Tools (6)

- `test_accessibility` — Test a webpage for accessibility issues using Axe-core
- `test_html_string` — Test an HTML string for accessibility issues
- `get_rules` — Get information about available accessibility rules with optional filtering
- `check_color_contrast` — Check if a foreground and background color combination meets WCAG contrast requirements
- `check_aria_attributes` — Check if ARIA attributes are used correctly in HTML
- `check_orientation_lock` — Check if content forces a specific orientation

```bash
# Get full input/output schema for a tool
npx -y @smithery/cli@latest tool get ronantakizawa/a11ymcp <tool-name>
```

---

Source: https://github.com/ronantakizawa/a11ymcp