wcagc-mcp
wcagc-mcp is an MCP server that lets AI assistants run real, deterministic accessibility scans (powered by axe-core) and PDF/UA-1 checks via the wcagc API — without relying on LLM guesses. Scans are queued and return an ID immediately; separate polling tools retrieve results. No compliance scores are returned, as automated testing covers only ~30–57% of accessibility issues.
Core Tools (all tiers)
scan_url— Scan any public URL for accessibility issues. Returns a scan ID to poll.get_scan— Poll status and results (severity counts, top-5 findings) for ascan_urlscan.get_findings— Retrieve top-5 findings (rule ID, severity, help URL, target selector) for a URL scan.check_pdf— Check a public PDF for PDF/UA-1 conformance (structure, tags, reading order) via veraPDF.get_pdf_check— Poll results of acheck_pdfscan.
Pro+ Tools
list_sites— List all registered sites in your organization.scan_site— Crawl and scan every reachable page of a registered site; returns arunIdto poll.get_run— Poll the status of a full-site scan run.get_run_findings— Retrieve deduplicated, rule-level findings for a full-site scan.run_journey— Replay a saved multi-step user journey (e.g., a checkout flow) and check accessibility at each step.get_journey_run— Poll results of a journey run, including per-step checkpoints.get_trends— Retrieve historical violation-count trends for a registered site across completed runs (by severity, with added/resolved markers).
This server has a remotely hosted endpoint. Open its connector listing for connection details, authentication requirements, and setup instructions:
wcagc-mcp
An MCP server that lets an AI assistant (Claude, ChatGPT, or any MCP-compatible client) run real, deterministic accessibility scans through wcagc — axe-core under the hood, not an LLM guess. Every scan result carries an explicit coverage disclaimer and never claims "compliant": automated testing finds only a portion of accessibility barriers, and this tool says so in every response.
This package is a thin, stateless adapter. It holds no database, no scan logic, and no secrets beyond the wcagc API base URL — it translates MCP tool calls into HTTP calls against the wcagc API and forwards the caller's own bearer. All authentication, entitlements, quotas, and scan orchestration live in the API; this code is safe to read end to end.
Two ways to run it
Local (stdio) — for Claude Desktop, Cursor, or any MCP client that spawns a local process:
npx @wcagc/mcpConfigure your MCP client with:
{
"mcpServers": {
"wcagc": {
"command": "npx",
"args": ["-y", "@wcagc/mcp"],
"env": {
"WCAGC_MCP_KEY": "<your mcp:scan API key>"
}
}
}
}Mint an mcp:scan key from your wcagc account under Settings → API keys — available on every
plan, with a daily quota on Free/Starter and unlimited on Pro/Agency.
Hosted (Streamable HTTP + managed OAuth) — what Claude web/desktop/mobile connectors and ChatGPT use, since neither runs a local process for you. Add this remote MCP connector:
https://mcp.wcagc.com/mcpThe client discovers /.well-known/oauth-protected-resource/mcp, opens the wcagc login/consent
flow, and binds the connection to one Organization. No key copy/paste is required. API-key bearer
authentication remains supported for local stdio and CI.
ChatGPT availability depends on the ChatGPT plan and on whether the client permits action tools;
scan_url creates a scan and is not a read-only operation. See
wcagc.com/integrations/mcp.
Related MCP server: WCAG Color Contrast MCP Server
Tools
Tool | Plan | What it does |
| all | Scan any public URL, or a registered site for full tracking (Pro+). |
| all | Run a PDF/UA-1 structure check on a public PDF. |
| all | Read a |
| Pro+ | List the account's registered sites. |
| Pro+ | Crawl and scan every reachable page of a registered site. |
| Pro+ | Read a full-site run from |
| Pro+ | Group a run's repeated DOM patterns and return factual element/page blast radius. |
| Pro+ | Replay a saved multi-step journey and check each step. |
| Pro+ | Read a site's violation-count history over time. |
One id, one poll tool: whatever scan_url did with a URL, get_scan and get_findings read it
back. get_run and get_run_findings are only for full-site runs from scan_site.
Every scan-producing tool returns the coverage disclaimer in both the text content and the structured content. There is no score, grade, or conformance verdict — automated testing finds roughly 30–57% of accessibility issues, and the remainder needs manual review.
Configuration
Env var | Used by | Meaning |
| both | The wcagc API to call. Defaults to |
| stdio | Your |
| hosted | Port to listen on (default |
| hosted | Comma-separated Host-header allowlist (DNS-rebinding protection when bound to |
| hosted | How long a verified bearer is cached before re-checking with the API (default |
| hosted | Expected OAuth issuer (defaults to |
| hosted | Authorization Server public JWKS URL. |
| hosted | Canonical RFC 9728 protected-resource URL (defaults to |
| hosted | JWKS cache TTL; an unknown |
| hosted | OpenAI Plugins Directory domain-verification token; keep it in the deployment secret store, never in source. |
Development
Hosted HTTP requests to /mcp and discovery endpoints produce JSON logs with a generated
request ID, HTTP status, MCP method, error code and duration. Tokens, headers, query strings,
tool arguments and results are excluded. Health probes are not logged.
The Docker entrypoint preloads the New Relic ESM agent. Set NEW_RELIC_AGENT_ENABLED=true,
NEW_RELIC_APP_NAME=wcagc-mcp and the deployment secret NEW_RELIC_LICENSE_KEY to enable
APM and forwarding of these safe request logs. The license key must belong to the existing
New Relic account; never commit it. The stdio entrypoint does not load the agent.
npm install
npm run dev # hosted, watch mode
npm run start:stdio # stdio mode
npm run typecheck
npm run verify # node:test against a local fixture APILicense
MIT — see LICENSE.
Available Tools
16 toolscheck_pdfCheck a PDF for PDF/UA-1 conformanceAInspect
Downloads a public PDF URL and runs a machine-verifiable veraPDF PDF/UA-1 check (document structure, tags, reading order — not a full WCAG audit). Free tier, counted against the caller's daily quota. Queues the check and returns immediately with an id; call get_pdf_check to poll.
Inputs: url (required). Returns: pdfCheck, standard, scoringGuidance, coverageDisclaimer
get_findingsGet a scan's findingsARead-onlyIdempotentInspect
The findings for a scan started by scan_url — rule id, severity, help URL and the element selector. Works for both kinds of scan_url scan. A one-off scan returns the top-5 sample; a scan recorded against a registered site returns its full findings. For a full-site run from scan_site, use get_run_findings instead.
Inputs: scanId (required). Returns: violations, recordedAgainstSite
get_fixesList tracked fixesARead-onlyIdempotentInspect
Lists tracked remediation items for a registered site, including status and the scope of any automated verification proof. Pro+ (REMEDIATION_TRACKING).
Inputs: siteHost (required). Returns: fixes, standard, scoringGuidance, coverageDisclaimer
get_fix_verificationGet fix verificationBRead-onlyIdempotentInspect
Polls a targeted fix verification and reports only what was detected on the selected pages checked. Pro+.
Inputs: fixVerificationId (required). Returns: standard, verification, scoringGuidance, coverageDisclaimer
get_journey_runGet a journey run by idARead-onlyIdempotentInspect
Polls a run started by run_journey — per-step checkpoints and, once terminal, a failure reason if a step failed. Pro+.
Inputs: runId (required). Returns: run, standard, scoringGuidance, coverageDisclaimer
get_pdf_checkGet a PDF check by idARead-onlyIdempotentInspect
Polls a PDF check started by check_pdf — status, failed-rule and failed-check counts, and a failure reason if it did not complete.
Inputs: checkId (required). Returns: pdfCheck, standard, scoringGuidance, coverageDisclaimer
get_root_causesGet a scan run's root causesARead-onlyIdempotentInspect
Returns deterministic repeated DOM patterns and factual blast-radius counts for a full-site run. Grouping does not expand automated-test coverage and may not match the site's real component boundaries. Pro+.
Inputs: runId (required). Returns: rootCauses
get_runGet a full-site scan run by idARead-onlyIdempotentInspect
Polls a full-site run started by scan_site — page progress, severity counts and, once terminal, a failure reason. Pro+. For a single-page scan from scan_url, use get_scan instead.
Inputs: runId (required). Returns: run, standard, scoringGuidance, coverageDisclaimer
get_run_findingsGet a full-site scan run's findingsARead-onlyIdempotentInspect
Run-level, rule-deduplicated findings for a scan_site run — one entry per rule, with the WCAG success criteria it maps to. Pro+. For a single-page scan from scan_url, use get_findings instead.
Inputs: runId (required). Returns: violations
get_scanGet a scan by idARead-onlyIdempotentInspect
Polls a scan started by scan_url — either kind, recorded against a registered site or one-off; this tool finds it either way. Returns severity counts, a finding sample, the coverage disclaimer, and (once terminal) a failure reason if the scan did not complete. For a full-site run from scan_site, use get_run instead.
Inputs: scanId (required). Returns: scan, pollWith, standard, scoringGuidance, +2 more
get_trendsGet a site's violation-count trendARead-onlyIdempotentInspect
Chronological (oldest->newest) per-run point history for a registered site's completed full-site runs — counts by severity and, where a comparison exists, added/resolved markers. No score. Pro+ (TREND_HISTORY).
Inputs: siteHost (required), limit. Returns: trend, standard, scoringGuidance, coverageDisclaimer
list_sitesList registered sitesARead-onlyIdempotentInspect
Lists this organization's registered sites — their normalized hosts are what every other Pro+ tool takes as siteHost. Pro+ (requires sites:read + API_ACCESS).
Inputs: no named parameters. Returns: sites
run_journeyRun a saved user journeyADestructiveInspect
Replays a saved multi-step journey (e.g. "add to cart -> checkout") against its registered site and checkpoints accessibility at each step. Pro+ (JOURNEYS; also AUTHENTICATED_SCANS when the journey logs in). Steps and any login credential always come from the journey's own saved configuration — never accepted here. Saved click or fill steps can submit forms or trigger external actions, so run only a journey the user has reviewed. Queues the run and returns immediately with a runId — call get_journey_run to poll.
Inputs: siteHost (required), journeyName (required). Returns: run, standard, scoringGuidance, coverageDisclaimer
scan_siteStart a full-site scanAInspect
Crawls and scans every reachable page of a registered site. Pro+ (SCAN_FULL_SITE). Queues the run and returns immediately with a runId — call get_run to poll. Call list_sites first if you do not already know the exact registered host.
Inputs: siteHost (required). Returns: run, standard, scoringGuidance, coverageDisclaimer
scan_urlScan a URLAInspect
Scans one http(s) URL for accessibility problems with axe-core — deterministic checks, not a language model's opinion. Pass the URL and nothing else. If it belongs to a site registered in the caller's account (and their plan allows), the scan is recorded against that site so it feeds history and trends; otherwise it runs as a one-off. Either way, poll it with get_scan. Returns immediately with an id — never a compliance score, because automated testing finds only a portion of accessibility barriers; see coverageDisclaimer in the result.
Inputs: url (required). Returns: scan, pollWith, standard, scoringGuidance, +2 more
verify_fixVerify a tracked fixAInspect
Queues a targeted automated re-check of representative pages for one tracked fix. This is not a full-site re-scan or a compliance guarantee. Pro+.
Inputs: remediationItemId (required). Returns: pollWith, standard, verification, scoringGuidance, +1 more
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 16 tools
Most tools are clearly scoped to distinct resources and actions: scan_url/scan_site, check_pdf, run_journey, and verify_fix each have their own dedicated polling tool. The many get_* tools could be confused at a glance, but descriptions explicitly cross-reference which poller to use for each job type.
All tools follow a consistent lowercase snake_case verb_noun pattern (scan_url, list_sites, get_run_findings, verify_fix). Paired queue/poll tools are predictably named (check_pdf -> get_pdf_check, run_journey -> get_journey_run), making the set easy to navigate.
16 tools is slightly above the ideal 3-15 range but each tool maps to a distinct stage in the scanning pipeline: initiating a job, polling it, retrieving findings, and listing supporting resources. The count feels justified by the breadth of scan types rather than redundant.
The surface covers the core lifecycle for URL scans, full-site runs, PDF checks, journeys, trend history, and fix verification. Minor gaps exist — no site registration/update/delete and no cancellation or re-run operations — but these are likely managed outside the MCP and don't block primary workflows.
Maintenance
Related MCP Connectors
Free WCAG 2.2/ADA/508 accessibility MCP: scan, AI fixes, verify, vision audit, localhost tunnel
Scan URLs or HTML for WCAG 2.2 violations. 75-rule manifest, weighted score, shareable reports.
Run WCAG accessibility scans on websites, list each issue with its element, and triage from chat.
Scan URLs for WCAG 2.1 violations, generate AI fixes, and produce VPAT 2.5 compliance reports.
Related MCP Servers
- AlicenseAqualityDmaintenanceProvides comprehensive access to WCAG 2.2 accessibility guidelines, including all 87 success criteria with full Understanding documentation, 400+ techniques, glossary terms, and ACT test rules from official W3C data.2086 npm15MIT
- AlicenseNot gradedqualityDmaintenanceEnables 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.MIT
- AlicenseNot gradedqualityDmaintenanceProvides AI agents with web accessibility analysis tools via MCP, enabling checks for alt text, heading hierarchy, color contrast, ARIA validation, and form accessibility.39 npmMIT
- AlicenseNot gradedqualityDmaintenanceValidates text accessibility (contrast, spacing, language) against WCAG 2.1 criteria via modular MCP tools.15 npm2MIT