1. Conduid
  2. Developer Tools
  3. accessibility-mcp-server
MCP server · Developer Tools

accessibility-mcp-server

by · github.com/AiAgentKarl/accessibility-mcp-server

MCP server configuration for automated web accessibility auditing. Test WCAG compliance, generate reports, and integrate accessibility testing into your IDE workflow.

Unclaimed last commit 6 months ago devtools
InstallView source
37Low

Scored 16 days ago · breakdown

About accessibility-mcp-server

accessibility-mcp-server is an MCP server published by AiAgentKarl in the Developer Tools category: mCP server configuration for automated web accessibility auditing. Test WCAG compliance, generate reports, and integrate accessibility testing into your IDE workflow.

Six months or more without a commit doesn't mean the server is broken, but check the open issues before depending on it in production.

Install

uvx
uvx accessibility-mcp-server
pip
pip install accessibility-mcp-server

This server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.

Tools (8)

check_color_contrastCalculate contrast ratio between two colors

Parameters not published.

check_form_labelsCheck all form inputs for labels

Parameters not published.

check_heading_structureAnalyze heading hierarchy on a page

Parameters not published.

check_images_altCheck all images for alt text

Parameters not published.

check_url_accessibilityFull WCAG 2.1 AA check for any URL

Parameters not published.

generate_a11y_reportComprehensive accessibility report with score

Parameters not published.

list_wcag_rulesList all WCAG 2.1 rules for a given level

Parameters not published.

validate_ariaValidate ARIA attributes in HTML snippet

Parameters not published.

Ask AI

✦

Ask AI about accessibility-mcp-server

Powered by Claude · Grounded in docs

I know everything about accessibility-mcp-server. Ask me about installation, configuration, usage, or troubleshooting.

Security checks

  • ✓README presentThe repository ships documentation.

5 checks have not been run yet.

README

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.

PyPI version

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

Tool Description
check_url_accessibility Full WCAG 2.1 AA check for any URL
check_color_contrast Calculate contrast ratio between two colors
validate_aria Validate ARIA attributes in HTML snippet
check_heading_structure Analyze heading hierarchy on a page
check_images_alt Check all images for alt text
check_form_labels Check all form inputs for labels
generate_a11y_report Comprehensive accessibility report with score
list_wcag_rules List all WCAG 2.1 rules for a given level

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

Criterion Level Check
1.1.1 Non-text Content A Images without alt text
1.3.1 Info and Relationships A Heading hierarchy, landmark regions
1.4.3 Contrast (Minimum) AA Color contrast ratio calculator
2.4.1 Bypass Blocks A Skip links and landmarks
2.4.2 Page Titled A Missing or empty page titles
2.4.4 Link Purpose A Generic link text detection
3.1.1 Language of Page A Missing lang attribute
3.3.2 Labels or Instructions A Form inputs without labels
4.1.1 Parsing A Duplicate IDs
4.1.2 Name, Role, Value A ARIA validation, unlabeled buttons

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

README copy captured when this server was indexed; it may lag the repository. The original is authoritative.

Questions

About accessibility-mcp-server

How do I install accessibility-mcp-server?

Run uvx accessibility-mcp-server, then add the server to your MCP client's configuration.

Is accessibility-mcp-server safe to use with an AI agent?

Its trust score is 37 out of 100 (low). It passes 1 of the 1 static security checks run so far. It has no ConduID identity yet, so agent calls to it are not receipted.

Is accessibility-mcp-server still maintained?

The last commit was 6 months ago. That's long enough that you should check whether the maintainer is responding to issues before depending on it.