a11y-toolkit MCP

A WCAG 2.2 accessibility suite as an MCP server (Model Context Protocol) for AI agents — plus a unified CLI. Zero dependencies at its core; all math is local and exact (the official relative-luminance formula).

The full audit → fix → document → regression-watch loop, in one toolkit:

1. Audit: express WCAG audit of any URL (severity-ranked findings)

2. Fix: exact contrast checks — color pairs and text over images (pixel-level sampling of the real background) — with nearest-passing-color suggestions

3. Document: legal accessibility declarations (EU), generated as accessible HTML

4. Watch: snapshots + diffs between builds to catch accessibility regressions before production

Multilanguage es/en across all tools (EN declarations use Directive (EU) 2016/2102 and Directive (EU) 2019/882 — European Accessibility Act — wording, useful EU-wide).

MCP tools (9)

Related MCP server: Accessibility MCP Server

Install as MCP

{
  "mcpServers": {
    "a11y-toolkit": {
      "command": "python3",
      "args": ["/path/to/a11y-toolkit/server.py"]
    }
  }
}

Or with uv, no clone needed:

{
  "mcpServers": {
    "a11y-toolkit": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/kinti/a11y-toolkit", "a11y-toolkit-mcp"]
    }
  }
}

Add "timeoutMs": 60000 if you plan to use a11y_snapshot (browser startup).

Unified CLI — one command for everything

a11y pair "#1f2328" "#fbfaf7"                     # contrast, per-criterion verdicts
a11y image hero.jpg --text "#ffffff" --region 120,40,420,90
a11y audit --url https://example.com              # express WCAG audit
a11y declaration --entidad "Acme" --url https://acme.example \
       --estado parcial --marco eaa --lang en --output decl.html
a11y snapshot https://mysite --out before.json    # before deploy (needs Playwright)
a11y diff before.json after.json                  # after deploy

Run from the repo: python3 a11y.py <subcommand>.

Interpreting image mode

• ratio_peor (worst) — the most hostile spot for your text color.

• area_pasa_aa_texto_normal_4_5 — % of safe surface. If < 100% where the text sits: scrim/overlay, crop, or move the text.

• zona_peor — the 3×3 grid cell that fails hardest, with exact coordinates.

Security & scope

A local tool: runs on your machine as your user. The path (image) and output_path (declaration) arguments read/write local paths — use it in MCP clients you trust. Nothing is sent over the network (except fetching the URL you explicitly audit).

Technical notes

• Image decoding: Pillow if available, else sips (macOS); PPM always (that's why CI needs no dependencies).

• The aria-live monitor carries a documented design lesson: its panel is deliberately NOT a live region and excludes itself from the observer — a role="log" panel would match its own selector and create an infinite self-observation loop. We know because it happened to us.

• Tested against real production sites (the author's own, which must pass its own audit).

• Web versions for humans (same math): jquin.net/lab — contrast (pairs + image), declaration generator, aria-live monitor, build diff.

Español

Suite de accesibilidad WCAG 2.2 como servidor MCP + CLI unificado. Cero dependencias en el núcleo (Pillow opcional; sips en macOS; PPM siempre). Todo el ciclo en un toolkit: auditar (a11y_audit_url) → corregir (contraste de pares y texto sobre imagen con muestreo píxel a píxel y detección de zona hostil; sugerencia de color accesible) → documentar (declaración legal RD 1112/2018 art. 10 o Ley 11/2023/EAA, en HTML accesible) → vigilar (snapshots y diff entre builds: añadidos/eliminados/renombrados y orden de foco).

9 herramientas MCP (ver tabla superior) · multilenguaje es/en (la declaración EN usa la terminología de las Directivas (UE) 2016/2102 y 2019/882) · CLI unificado a11y con subcomandos pair, image, audit, declaration, snapshot, diff.

{ "mcpServers": { "a11y-toolkit": {
    "command": "python3", "args": ["/ruta/al/repo/server.py"] } } }

Herramienta local: los argumentos path y output_path leen/escriben rutas locales; nada sale a la red salvo la URL que audites explícitamente. El monitor aria-live documenta su lección de diseño: el panel NO es una región viva y se autoexcluye del observador (un role="log" casaría con su propio selector y crearía un bucle infinito de auto-observación — lo sabemos porque nos pasó). Versiones web para humanos: jquin.net/lab.

Autor / Author

Jesús Quintana Fernández (jquin.net) — SEO/GEO consultant and web-accessibility practitioner since 2003. MIT © 2026.