How do I use @mhdd_24/accessibility-mcp?

1. Click on "Deploy Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@@mhdd_24/accessibility-mcp Check accessibility of example.com against WCAG" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

@mhdd_24/accessibility-mcp

MCP server for WCAG/accessibility inspection.

Same architecture as @mhdd_24/sublime-mcp.

Full documentation: docs/WIKI.md

How it works (30 seconds)

You (chat) → MCP client → accessibility-mcp → Accessibility APIs / CLIs / local tools

Related MCP server: WCAG Color Contrast MCP Server

Prerequisites

Requirement	Notes
Node.js 18+	ESM TypeScript MCP server
Credentials / CLIs	See environment variables below

Install

Option A — npm (after publish)

npm install -g @mhdd_24/accessibility-mcp

Option B — npx

npx @mhdd_24/accessibility-mcp

Option C — clone and build

git clone https://github.com/Mhdd-24/Accessibility-MCP.git
cd Accessibility-MCP
npm install
npm run build
node dist/index.js

Configure Cursor

Edit ~/.cursor/mcp.json:

{
  "mcpServers": {
    "a11y": {
      "command": "npx",
      "args": ["-y", "@mhdd_24/accessibility-mcp"],
      "env": {
        "_": "optional"
      }
    }
  }
}

Local development:

{
  "command": "node",
  "args": ["/absolute/path/to/Accessibility-MCP/dist/index.js"]
}

Environment variables

Variable	Description
—	No required env

Tools

Tool	Description
`a11y_status`	Show wcag/accessibility inspection configuration / health.
`a11y_analyze`	Analyze a page/site for wcag/accessibility inspection.
`a11y_report`	Generate a wcag/accessibility inspection report.
`a11y_check`	Quick wcag/accessibility inspection check.

License

ISC

Available Tools

4 tools

a11y_analyzeC

Analyze a page/site for wcag/accessibility inspection.

Inputs: url (required).

a11y_checkC

Quick wcag/accessibility inspection check.

Inputs: target (required).

a11y_reportC

Generate a wcag/accessibility inspection report.

Inputs: url (required), options.

a11y_statusB

Show wcag/accessibility inspection configuration / health.

Inputs: no named parameters.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

Deploy Server

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

TDQS

B3/5.0

Scored 2026-09-09 17:30 across 4 tools

Disambiguation3/5

a11y_analyze and a11y_check overlap in purpose, both performing inspection with only a depth/quick distinction. a11y_report and a11y_status are clearly distinct, but the boundary between analyze and check could confuse an agent.

Naming Consistency5/5

All tools share the a11y_ prefix and follow the same verb-after-prefix pattern in lowercase snake_case, making the naming highly predictable and consistent.

Tool Count5/5

Four tools is a well-scoped set for a focused accessibility inspection server, covering analysis, reporting, quick checks, and status without redundancy.

Completeness4/5

The core workflows of inspection, reporting, and configuration health are covered. A tool to list or retrieve specific violations would be a minor enhancement, but no critical gaps exist.

Maintenance

ActivityStale

ResponsivenessNo recent community issues

Resources

Related MCP Connectors

Lazynext Accessibility CheckerA
com.lazynext
Scan URLs or HTML for WCAG 2.2 violations. 75-rule manifest, weighted score, shareable reports.
Testing & QA Tools Web Scraping Developer Tools
41
https://api.lazynext.com/mcp
Inclusify AccessibilityA
com.inclusifyapp
Accessibility and WCAG data for your own websites: fix lists, live checks, and fix validation.
Developer Tools Monitoring Testing & QA Tools
381
https://app.inclusifyapp.com/api/mcp/customer
webabilityA
io.github.snayyar00
Free WCAG 2.2/ADA/508 accessibility MCP: scan, AI fixes, verify, vision audit, localhost tunnel
Testing & QA Tools Web Scraping Developer Tools
171
https://mcp.webability.io/mcp
Sitejar Web Compliance ScannerA
app.sitejar
Scan a web page for accessibility, security, privacy, quality and SEO issues, with fixes.
Legal & Compliance Security Testing & QA Tools
51
https://mcp.sitejar.app/mcp

Related MCP Servers

Accessibility Testing MCP
Testing & QA Tools Web Scraping Browser Automation
joe-watkins
A
license
A
quality
D
maintenance
Enables accessibility testing of websites and HTML content using axe-core and IBM Equal Access engines. Supports WCAG compliance checking, multi-viewport testing, and provides detailed violation reports with remediation guidance.
Updated a year ago (2025-12-07 09:01 UTC)
5
1
MIT
WCAG Color Contrast MCP Server
Developer Tools
bryanberger
A
license
Not graded
quality
D
maintenance
Enables accurate WCAG color contrast checking and accessibility analysis by calculating actual contrast ratios between color pairs, checking compliance levels, and analyzing luminance values for web accessibility.
Updated a year ago (2025-09-19 17:52 UTC)
MIT
mcp-a11y-service
Testing & QA Tools Design Tools
alan-ho
F
license
Not graded
quality
D
maintenance
Enables automated WCAG 2.2 AA accessibility audits of Figma designs and webpages. Generates detailed markdown reports with severity-grouped violations, specific criterion references, and concrete fix recommendations.
Updated 7 months ago (2026-04-07 06:37 UTC)
-
accessibility-mcp-server
Testing & QA Tools Browser Automation
AiAgentKarl
A
license
A
quality
D
maintenance
Enables AI agents to perform comprehensive web accessibility checks (WCAG 2.1/2.2) including color contrast analysis, ARIA validation, and full accessibility report generation without requiring any API key.
Updated 7 months ago (2026-04-09 07:44 UTC)
8
30 PyPI
MIT