English Français العربية

io.github.rog0x/a11y

Official registry AI and agents

Alt text, headings, contrast, ARIA for AI agents

Source code Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

NPM package @rog0x/mcp-a11y-tools
Claude Code 
claude mcp add a11y -- npx -y @rog0x/mcp-a11y-tools@1.0.2
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "a11y": {
            "command": "npx",
            "args": [
                "-y",
                "@rog0x/mcp-a11y-tools@1.0.2"
            ]
        }
    }
}

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. mcp-a11y-tools
  2. Tools
  3. Setup
  4. Usage with Claude Desktop
  5. License

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
validate_aria

Validate ARIA attributes on HTML elements.

  • Detects invalid ARIA roles
  • Checks for missing required ARIA properties per role
  • Flags redundant ARIA roles that match native semantics
  • Warns about aria-label on non-interactive elements
  • Catches aria-hidden="true" on focusable elements
check_form_accessibility

Audit form elements for accessibility compliance.

  • Verifies every input has an associated label (explicit, implicit, or ARIA)
  • Checks radio/checkbox groups for <fieldset> and <legend>
  • Flags placeholder text used as the only label
  • Suggests autocomplete attributes for personal info fields
  • Detects duplicate IDs that break label association

Setup

npm install
npm run build

Usage with Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "a11y-tools": {
      "command": "node",
      "args": ["D:/products/mcp-servers/mcp-a11y-tools/dist/index.js"]
    }
  }
}

License

MIT

Frequently asked questions

What is io.github.rog0x/a11y?

Alt text, headings, contrast, ARIA for AI agents

How do I install io.github.rog0x/a11y?

It runs on your machine. In Claude Code: claude mcp add a11y -- npx -y @rog0x/mcp-a11y-tools@1.0.2. For other clients, paste the JSON configuration from this page into their MCP settings.

Does io.github.rog0x/a11y need an API key?

Its registry entry lists no required key or secret. Some features may still need an account with the service it connects to.

Is io.github.rog0x/a11y open source?

Its code is public on GitHub, but the repository does not declare a standard license.

Who maintains io.github.rog0x/a11y?

It is published by rog0x. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.