# AccessibilityBrief

> AccessibilityBrief is a freemium MCP server for developer tools. WCAG 2.2 scan results and fix prompts for AI coding agents, with rescan to confirm. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Starting price:** $19 a month
- **Platforms:** CLI, API
- **Website:** https://accessibilitybrief.com/docs/mcp
- **MCP Registry name:** com.accessibilitybrief/mcp
- **Categories:** developer tools, security
- **Listing updated:** 2026-11-15

## About

The loop here is scan, fix, rescan. An agent reads the latest accessibility scan for a site, takes the worst issue group, fetches the fix prompt with selectors, code and expected result, edits your repository, and after you deploy it starts a new scan to check. Scans test your live or staging site rather than local files, so a fix only shows once deployed. The agent cannot mark an issue as fixed itself; the next scan detects that.

The server runs locally through npx -y accessibilitybrief mcp and needs Node.js 18.17 or newer. It requires an API key from Settings with read scope, plus scan to start scans and write to mark issues as false positive, won't fix or needing a manual check. The site must already be in your workspace, and API access is part of the Starter, Pro and Agency plans.

The docs caution that automated testing finds only part of WCAG issues, so keyboard and screen reader checks are still needed.

## Features

- **Scan reading:** Reads the latest finished scan with score, severity counts and change since the previous scan.
- **Issue groups:** Lists groups worst first with affected elements, WCAG criteria and fix steps.
- **Fix prompts:** Fetches a prompt for one group or a whole site with selectors and expected result.
- **Rescan on demand:** Starts a new scan after a fix is deployed, using one manual scan of the plan.
- **Issue triage:** Marks issues as false positive, won't fix or needs manual check, with a note.
- **Scoped API key:** Separate read, scan and write scopes limit what the agent can do.

## Good for

- Fix the worst accessibility issue group in a repo with an agent
- Confirm that a deployed fix removed an issue
- Triage false positives with a note
- Check a site's score after a release

## Install

### Claude Code (Terminal)

```sh
claude mcp add mcp --env ACCESSIBILITYBRIEF_API_KEY='<ACCESSIBILITYBRIEF_API_KEY>' -- npx -y accessibilitybrief
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "mcp": {
      "command": "npx",
      "args": [
        "-y",
        "accessibilitybrief"
      ],
      "env": {
        "ACCESSIBILITYBRIEF_API_KEY": "<ACCESSIBILITYBRIEF_API_KEY>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "mcp": {
      "command": "npx",
      "args": [
        "-y",
        "accessibilitybrief"
      ],
      "env": {
        "ACCESSIBILITYBRIEF_API_KEY": "<ACCESSIBILITYBRIEF_API_KEY>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "accessibilitybrief"
      ],
      "env": {
        "ACCESSIBILITYBRIEF_API_KEY": "<ACCESSIBILITYBRIEF_API_KEY>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "mcp": {
      "command": "npx",
      "args": [
        "-y",
        "accessibilitybrief"
      ],
      "env": {
        "ACCESSIBILITYBRIEF_API_KEY": "<ACCESSIBILITYBRIEF_API_KEY>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "mcp": {
      "command": "npx",
      "args": [
        "-y",
        "accessibilitybrief"
      ],
      "env": {
        "ACCESSIBILITYBRIEF_API_KEY": "<ACCESSIBILITYBRIEF_API_KEY>"
      }
    }
  }
}
```

## Tools

- `list_sites`: Lists sites in the workspace with their latest score.
- `get_latest_scan`: Reads the latest finished scan of a site.
- `get_issue_groups`: Lists issue groups worst first with affected elements, WCAG criteria and fix steps.
- `get_fix_prompt`: Fetches the fix prompt for one issue group or a whole site.
- `start_scan`: Starts a new scan.
- `get_scan`: Checks scan progress and reads its result.
- `mark_issue_status`: Marks issues as false positive, won't fix or needing a manual check.

## FAQ

### Which plans include the MCP server?

Starter, Pro and Agency.

### What do I need to run it?

Node.js 18.17 or newer and an API key with the scopes you want to grant.

### Can the agent mark issues fixed?

No. Fixed issues are detected by the next scan.

### Does it scan local files?

No. Scans check your live or staging site, so fixes appear after deployment.

### Does it find every WCAG issue?

No. Automated testing finds only part of them; manual checks are still needed.

### Is AccessibilityBrief free?

AccessibilityBrief has a free plan, with paid plans for more usage or features. Paid plans start at $19 a month.

### How do I add AccessibilityBrief to Claude Code?

Run this command in your terminal: claude mcp add mcp --env ACCESSIBILITYBRIEF_API_KEY='<ACCESSIBILITYBRIEF_API_KEY>' -- npx -y accessibilitybrief

### What are the best alternatives to AccessibilityBrief?

The closest alternatives to AccessibilityBrief are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/accessibilitybrief
