mcp-a11y
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| GITHUB_TOKEN | No | Used only by open_pr | |
| A11Y_TARGET_REPO | No | STRICT guardrail: the only repo open_pr will touch, format owner/repo | |
| ANTHROPIC_API_KEY | No | Used only by generate_alt_text | |
| A11Y_ALT_TEXT_MODEL | No | Optional, defaults to Haiku | claude-haiku-4-5 |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| pingA | Health check. Returns 'pong', optionally echoing a message. |
| audit_pageA | Audit a web page against WCAG rules with axe-core (Playwright headless Chromium). 100% deterministic detection - no LLM. Returns structured violations with selectors and colors. |
| fix_contrastA | Compute the closest WCAG-compliant foreground color for a fg/bg pair (AA 4.5:1 normal text). Deterministic - no LLM. |
| simple_fixesB | Apply deterministic structural fixes to HTML: missing lang, missing title, unlabeled form controls. Returns the patched HTML and the list of fixes. No LLM. |
| generate_alt_textA | Describe an image for an HTML alt attribute using a vision model. The ONLY LLM-backed tool. Provide either |
| generate_reportA | Build a self-contained before/after HTML accessibility report from an audit and applied fixes. No LLM. Returns the HTML string. |
| open_prB | Open a mergeable PR with the remediated files. STRICT GUARDRAIL: only ever operates on the repo configured in A11Y_TARGET_REPO - never an arbitrary repo. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 7 tools
Each tool has a clearly distinct purpose: audit_page does WCAG auditing, fix_contrast computes contrast fixes, generate_alt_text generates alt text, generate_report builds reports, open_pr opens PRs, ping is health check, and simple_fixes applies structural fixes. No overlap or ambiguity.
All tool names follow a consistent verb_noun pattern (e.g., audit_page, fix_contrast, generate_alt_text, simple_fixes). Even ping fits the pattern of a simple verb. Snake_case is used uniformly.
With 7 tools, the server is well-scoped for accessibility tasks. Each tool covers a key aspect of auditing, fixing, reporting, and deployment, without being overwhelming or sparse.
The tool surface covers the full lifecycle: audit (audit_page), fix contrast (fix_contrast), generate alt text (generate_alt_text), apply structural fixes (simple_fixes), generate report (generate_report), and deploy changes (open_pr). No obvious gaps for the domain.