rog0x avatar

A11y

rog0x/mcp-a11y-tools

This server gives Claude five tools to audit web accessibility in HTML: check_alt_text scans images for missing or weak alt attributes, check_heading_hierarchy validates h1-h6 nesting and outputs a visual tree, check_color_contrast calculates WCAG contrast ratios for color pairs, validate_aria catches role misuse and missing properties, and check_form_accessibility ensures inputs have labels and fieldsets. You'd reach for this when reviewing markup for compliance issues or teaching an agent to spot common accessibility problems like unlabeled form fields, skipped heading levels, or aria-hidden on focusable elements. It runs over stdio and returns structured findings rather than browser automation.

tools
5
transport
STDIO
last updated
Mar 22, 2026

Tools

5 tools

Public tool metadata for what this MCP can expose to an agent.

check_alt_textAnalyze images in HTML for missing, empty, or low-quality alt text.

Analyze images in HTML for missing, empty, or low-quality alt text.

No parameter schema in public metadata yet.

check_heading_hierarchyValidate heading structure for proper nesting and content quality.

Validate heading structure for proper nesting and content quality.

No parameter schema in public metadata yet.

check_color_contrastCheck WCAG 2.x contrast ratio for foreground/background color pairs.

Check WCAG 2.x contrast ratio for foreground/background color pairs.

No parameter schema in public metadata yet.

validate_ariaValidate ARIA attributes on HTML elements.

Validate ARIA attributes on HTML elements.

No parameter schema in public metadata yet.

check_form_accessibilityAudit form elements for accessibility compliance.

Audit form elements for accessibility compliance.

No parameter schema in public metadata yet.

Sponsors

Readme

mcp-a11y-tools

Web accessibility analysis tools for AI agents, served over the Model Context Protocol (MCP).

Tools

check_alt_text

Analyze images in HTML for missing, empty, or low-quality alt text.

  • Detects missing alt attributes
  • Identifies decorative images (alt="" with role="presentation")
  • Flags low-quality alt text (e.g., "image", "photo", filenames)
  • Checks linked images, <input type="image">, and <area> elements

check_heading_hierarchy

Validate heading structure for proper nesting and content quality.

  • Verifies h1-h6 order with no skipped levels
  • Ensures a single <h1> per page
  • Detects empty, too-short, or too-long headings
  • Supports role="heading" with aria-level
  • Returns a visual tree of the heading outline

check_color_contrast

Check WCAG 2.x contrast ratio for foreground/background color pairs.

  • Calculates precise contrast ratio per WCAG relative luminance formula
  • Reports AA and AAA compliance for normal and large text
  • Accepts hex (#fff, #ffffff), rgb(r,g,b), and named colors

View the full README on GitHub

Details

Repository
github.com/rog0x/mcp-a11y-tools
Package
@rog0x/mcp-a11y-tools
Transport
STDIO
Registry
MCP registry, active

More from rog0x