# Audit your website for accessibility with a browser agent

A code agent with Playwright MCP and axe-core can find accessibility barriers on your site and propose fixes.

Organisation: Workflow (Microsoft Playwright, Deque axe-core)
Status: Workflow you can run
Place: Worldwide
Categories: Accessibility & inclusion, Work & productivity
Built with: Playwright MCP
Try it with: Claude Code, Codex, Cursor, Grok Bot, OpenClaw
Time to try: 1 hour

## Why it matters

Many websites still have barriers that shut disabled people out. An agent that runs automated checks and walks through key journeys makes accessibility checks routine.

## How it works

Playwright documents automated accessibility testing with the axe-core engine (AxeBuilder). Playwright MCP lets an AI agent drive a real browser through the page's accessibility tree. The agent runs axe on each page, tries keyboard-only journeys, then drafts fixes for a human to review. Automated tools only find some issues, so manual testing is still needed.

## Who it's for

Web teams, product owners and public-sector digital teams.

## The prompt

```
Audit [site URL] for accessibility using the Playwright MCP browser and, in a test script, @axe-core/playwright. Only test a site I own or have permission to test, ideally a staging copy.

1. Visit [list of key pages]. Run axe on each and collect violations with rule, impact, element and WCAG reference.
2. Using only the keyboard and test accounts, complete these journeys: [e.g. sign up, search, checkout]. Stop before any real payment, order or message is submitted. Note any focus trap, invisible focus or unreachable control.
3. Check that images have alt text, form fields have labels and headings are in order.
4. Output a table sorted by impact, then propose code fixes as a diff for the top 10.

Do not commit or deploy. List what automated checks cannot cover and needs manual testing.
```

## Caveats

Automated testing finds only part of the problems.

## Sources

The sources document the tools, not a deployment.

1. Playwright (Microsoft): axe-core via @axe-core/playwright; automated checks find some problems. Accessibility testing (https://playwright.dev/docs/accessibility-testing)
2. GitHub (Microsoft): MCP server; agent uses accessibility snapshots. microsoft/playwright-mcp (https://github.com/microsoft/playwright-mcp)
3. GitHub (Deque): Accessibility engine; WCAG rules. dequelabs/axe-core (https://github.com/dequelabs/axe-core)

Fact-checked: 16 Oct 2026

Page: https://escapevelocitysociety.com/picks/accessibility-audit-agent

See Selected Projects: https://escapevelocitysociety.com/picks.md
