# PDF Accessibility Audit

> PDF Accessibility Audit is an open-source MCP server for files and documents. Audit local PDFs for accessibility with cited findings, no upload or API key. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI
- **Website:** https://remediatepdf.com/open/pdf-a11y-audit
- **Repository:** https://github.com/veduis/pdf-a11y-audit
- **MCP Registry name:** io.github.Veduis/pdf-a11y-audit
- **Categories:** files and documents, developer tools
- **Listing updated:** 2026-11-14

## About

Rather than judging a screenshot, the auditor reads the PDF's real object model and text layer and runs 42 automated checks plus 10 manual ones. Each finding names its rule, severity, standards reference, page, evidence and a concrete fix, and there is no vague score. The site shows an example of 55 out of 100 with 2 critical and 2 serious issues, and the report says plainly that the score is a summary.

Checks span tags and heading order, parent trees and reading order, table headers and form fields, scanned or image-only pages, embedded fonts, language and title. It cannot judge colour contrast, alt-text quality or OCR accuracy, and it lists those as manual so a conformance claim is not made from the score.

It runs locally over stdio with six tools plus a rule catalog and methodology as resources and an audit_and_plan prompt. Output can be Markdown, JSON, CSV or a self-contained HTML report, and a CLI can fail a build above a chosen severity. It comes from Remediate, a paid product for public-sector PDFs.

## Features

- **42 automated checks:** Structure, tables, forms, text, fonts and metadata.
- **Manual check list:** Lists what needs a human and a screen reader.
- **Cited findings:** Rule, severity, standard, page and fix.
- **HTML report:** Self-contained, with no external scripts.
- **Batch and compare:** Audit folders and diff two reports.
- **CI mode:** Fail a build at a set severity.

## Good for

- Audit a county report before publishing
- Compare PDFs before and after remediation
- Fail a pipeline on serious findings
- Hand a reviewer an offline HTML report

## Install

### Claude Code (Terminal)

```sh
claude mcp add pdf-a11y-audit -- npx -y pdf-a11y-audit
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "pdf-a11y-audit": {
      "command": "npx",
      "args": [
        "-y",
        "pdf-a11y-audit"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "pdf-a11y-audit": {
      "command": "npx",
      "args": [
        "-y",
        "pdf-a11y-audit"
      ]
    }
  }
}
```

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

```json
{
  "servers": {
    "pdf-a11y-audit": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "pdf-a11y-audit"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "pdf-a11y-audit": {
      "command": "npx",
      "args": [
        "-y",
        "pdf-a11y-audit"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "pdf-a11y-audit": {
      "command": "npx",
      "args": [
        "-y",
        "pdf-a11y-audit"
      ]
    }
  }
}
```

## Tools

- `audit_pdf`: Audits one local PDF and returns JSON, Markdown or HTML, optionally written to a file.
- `audit_batch`: Audits every PDF in one or more folders and returns a comparison table.
- `explain_finding`: Explains a rule, its standards mapping and its remediation.
- `list_checks`: Lists the rule catalog including manual checks.
- `compare_reports`: Compares two JSON reports and lists new, fixed and persisting findings.
- `render_report`: Re-renders an existing JSON report as HTML and writes the file.

## FAQ

### Is the PDF uploaded?

No, the audit runs locally with no account, key or model call.

### Does a good score prove compliance?

No, it is an audit, not a certificate.

### What licence?

MIT.

### How do I run it?

With npx -y pdf-a11y-audit, or from a checkout; the MCP form uses --mcp.

### Is PDF Accessibility Audit free?

Yes. PDF Accessibility Audit is open source, so you can use and self-host it for free.

### How do I add PDF Accessibility Audit to Claude Code?

Run this command in your terminal: claude mcp add pdf-a11y-audit -- npx -y pdf-a11y-audit

### What are the best alternatives to PDF Accessibility Audit?

The closest alternatives to PDF Accessibility Audit 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/pdf-accessibility-audit
