Skip to content
MCP server

PDF Accessibility Audit

Audit local PDFs for accessibility with cited findings, no upload or API key

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
CLI
Runs
Locally
Version
0.2.0
Listing updated
3 days ago

About PDF Accessibility Audit

PDF Accessibility Audit is an open-source MCP server for files and documents. It runs locally on your machine and is started by your AI client.

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.

Install

Run in a terminal

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

Add to claude_desktop_config.json

{
  "mcpServers": {
    "pdf-a11y-audit": {
      "command": "npx",
      "args": [
        "-y",
        "pdf-a11y-audit"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "pdf-a11y-audit": {
      "command": "npx",
      "args": [
        "-y",
        "pdf-a11y-audit"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

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

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

Tools this server provides (6)

Taken from the project documentation; the running server may differ.

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.

What it does

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

Pricing

Open source

Free and MIT licensed; the publisher's separate Remediate service is sold by annual quote

Prices change. Check remediatepdf.com before you buy.

PDF Accessibility Audit 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 to PDF Accessibility Audit

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  3. GitHub

    MCP server

    Official MCP server connecting AI assistants to GitHub repos, issues and workflows

    Not checked yet
    • Remote
    • Open source
    • 34.5K GitHub stars
    • Developer tools
  4. MCP toolkit giving coding agents symbol-level code retrieval and editing

    Runs locally
    • Open source
    • 31.5K GitHub stars
    • Developer tools
  5. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory
  6. Ouroboros

    MCP server

    Spec-first layer that pins requirements and verifies results of AI coding agent work

    Runs locally
    • Open source
    • 6.4K GitHub stars
    • Developer tools