sgudimitla/accesslumens-mcp

Free accessibility checks for your AI coding agent. Ask it to scan the page you are building, and it gets back every WCAG problem with the exact element, the reason it fails and how to fix it. Then it fixes the code and scans again to confirm.
It runs the same scanner as accesslumens.com: axe-core plus AccessLumens' own checks for things axe does not test, such as controls you cannot reach by keyboard, keyboard traps, invisible focus, reflow at 320px, and names a screen reader cannot tell apart (three identical "Add to cart" buttons, alt text that repeats the heading beside it, an aria-label that drops the visible words).
Everything runs on your machine in a headless browser. It works on localhost, staging URLs, public sites and plain .html files. Nothing is sent to AccessLumens and no account or API key is needed.
Watch the 1-minute demo: Claude Code takes a page from 75 to 100, then axe DevTools confirms zero issues. Setup guide and FAQ: accesslumens.com/mcp.
## Setup
Requires Node.js 18.17 or later. AccessLumens scans in a headless Chromium, which it downloads once (about 150 MB). Download it now so your first scan does not wait on it:
sh
npx -y @accesslumens/mcp install
Then add the server to your editor.
Claude Code
sh
claude mcp add accesslumens -- npx -y @accesslumens/mcp
Cursor (.cursor/mcp.json), Windsurf, Claude Desktop and most other clients:
json
"mcpServers": {
"accesslumens": { "command": "npx", "args": ["-y", "@accesslumens/mcp"] }
VS Code (.vscode/mcp.json):
json
"servers": {
"accesslumens": { "type": "stdio", "command": "npx", "args": ["-y", "@accesslumens/mcp"] }
## Use it
Start your dev server, then run one of the ready-made workflows below, or just ask:
> Check http://localhost:3000/checkout for accessibility issues and fix them.
## Workflows (prompts)
Ready-made instructions that tell your agent not just what is wrong but how to fix it well: in the source, native HTML before ARIA, shared causes fixed once, design and behaviour unchanged, and every fix verified by a rescan. In clients that support MCP prompts they appear as slash commands: in Claude Code, type / and pick accesslumens:fix-all. Each takes an optional url; leave it empty and the agent finds your dev server. Some clients, including some VS Code Copilot versions, do not list MCP prompts; there, just ask your agent to fix the accessibility issues on your page. The scanner's results carry the same guidance.
| Prompt | What it does |
| fix-page | Scans one page, fixes every issue in the source, rescans until no Critical or Serious issues remain, and lists what it changed. |
| fix-all | Two passes over every route in your app: fixes everything the scanner finds, then reviews the code for what scanners cannot detect (duplicate button names, focus in dialogs, route-change announcements, form errors, reduced motion). Rescans every route and reports scores before and after. |
| audit | The same review without changing any files: issues grouped by root cause, with the file each one comes from and an ordered fix plan. |