accessibility-mcp-server

MCP-Server for Web Accessibility Checks (WCAG 2.1/2.2)

Gives AI agents the ability to check websites for accessibility issues, validate ARIA attributes, check color contrast ratios, and generate full accessibility reports — without any API key.

Features

• WCAG 2.1 AA Compliance Checks — Automated checks for 10+ WCAG success criteria
• Color Contrast Analyzer — Calculates contrast ratios and WCAG AA/AAA pass/fail
• ARIA Validator — Checks ARIA roles and attributes for correctness
• Heading Structure Analyzer — Validates heading hierarchy (H1→H2→H3...)
• Image Alt Text Checker — Finds images missing alt attributes
• Form Label Validator — Ensures all form inputs have accessible labels
• Full A11y Report — Comprehensive report with accessibility score (0-100)
• WCAG Rule Reference — Browse all WCAG 2.1 A/AA/AAA rules
• No API Key Required — Works with any public website

Tools

Installation

pip install accessibility-mcp-server

Usage with Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "accessibility": {
      "command": "accessibility-mcp-server"
    }
  }
}

Example Prompts

• "Check https://example.com for accessibility issues"
• "What is the contrast ratio between #333333 and #ffffff?"
• "Generate a full accessibility report for https://mysite.com"
• "Check if the images on https://example.com have alt text"
• "Validate the ARIA in this HTML: <div role='buttn'>Click</div>"
• "List all WCAG 2.1 AA rules"

WCAG Criteria Checked

Tech Stack

• Python 3.10+ with FastMCP
• httpx for async HTTP requests
• BeautifulSoup4 + lxml for HTML parsing
• WCAG formulas implemented directly (relative luminance, contrast ratio)

License

MIT — Free for personal and commercial use.

Built by AiAgentKarl | Part of the AI Agent Tools ecosystem