Server data from the Official MCP Registry
Audit a local PDF against the machine-checkable basics of PDF/UA accessibility. No uploads.
About
Audit a local PDF against the machine-checkable basics of PDF/UA accessibility. No uploads.
Security Report
pdfaudit is a local-only PDF accessibility auditor that reads a single file from disk, uses only Node built-ins for parsing, and makes no network calls, with permissions matching its stated purpose. No malicious patterns, shell execution, eval, hardcoded secrets, or data exfiltration were found; the only notes are minor: the tool accepts arbitrary filesystem paths without restriction, which is expected for a file-auditing tool, and the regex-based PDF parser is a deliberately simplified model that may misreport complex documents. Supply chain analysis found 3 known vulnerabilities in dependencies (0 critical, 2 high severity). Package verification found 1 issue.
8 files analyzed · 7 issues found
Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.
Permissions Required
This plugin requests these system permissions. Most are normal for its category.
How to Install
Add this to your MCP configuration file:
{
"mcpServers": {
"pdfaudit": {
"command": "npx",
"args": [
"-y",
"@reneturcios/pdfaudit@0.1.0"
]
}
}
}Some servers take additional arguments. See the repository for details.
Documentation
View on GitHubFrom the project's GitHub README.
pdfaudit
Some PDFs look fine on screen and are unusable with a screen reader: the text is there, but nothing says what order to read it in, images carry no descriptions, and the file may even be locked against the extraction assistive technology depends on. pdfaudit checks a local PDF against the machine-checkable basics of PDF/UA accessibility and reports exactly what it found, in a JSON report a caller can act on. The document is never uploaded — the audit reads the file from disk, runs entirely locally, and touches no network.
Seven checks run on every document. The document must be
tagged (a /MarkInfo dictionary with /Marked true in the
catalog) and must carry a structure tree (/StructTreeRoot).
Its language must be set (a non-empty /Lang entry) and its
title exposed (a non-empty /Title in the information
dictionary; XMP metadata is not consulted). Every image must
be reachable from a structure element that carries alt text.
The reading order must be determinable, which requires the
structure tree and at least one structure element. And the
document must not be locked against assistive access: an
unencrypted document passes, while an encrypted one passes
only when its permission bits allow extraction in support of
accessibility.
Each check reports a pinned id, a name, a pass or fail, and a
detail string. The report counts the failures and picks a
route for what to do next: already-compliant when nothing
failed, ocr for a scanned document (no extractable text but
at least one image), guaranteed for an untagged digital PDF
that does carry extractable text, and repair for everything
else — partially tagged or mixed documents that need targeted
fixes. A one-line verdict summarises the pass count, the
route, and the ids of any failed checks.
The audit works on a deliberately small reading of the PDF:
plain object blocks are scanned for the catalog, the
information dictionary, structure elements, image objects,
and the encryption dictionary, and text is recovered from
the Tj and TJ operators to inform the route decision.
Files that cannot be read this way are reported honestly —
a missing file, a file with no PDF header, and a file with
no usable object structure each produce their own error
rather than a misleading report.
CLI
npx @reneturcios/pdfaudit check_pdf_accessibility '{"file_path": "/path/to/document.pdf"}'
npx @reneturcios/pdfaudit --version
The report is printed as JSON:
{
"filePath": "/path/to/document.pdf",
"checks": [
{
"id": "tagged",
"name": "Document is tagged",
"passed": true,
"detail": "MarkInfo/Marked is true"
}
],
"failed": 0,
"route": "already-compliant",
"verdict": "7/7 checks passed. Route: already-compliant."
}
(The example above abbreviates the checks list; a real
report always carries all seven entries.)
Exit codes: 0 on success, 1 on a runtime error
(including an unparseable JSON argument, a missing file,
or a file that is not an auditable PDF), 2 on a usage
error.
MCP server
npx -y @reneturcios/pdfaudit mcp
MCP client config:
{
"mcpServers": {
"pdfaudit": {
"command": "npx",
"args": ["-y", "@reneturcios/pdfaudit", "mcp"]
}
}
}
Tools
-
check_pdf_accessibility— Audit a local PDF against the machine-checkable basics of PDF/UA accessibility and return a JSON report. The document is never uploaded.file_path(string, required) — path to a local PDF
Returns a single text item carrying the JSON report, pretty-printed with a 2-space indent, with keys in the order
filePath,checks,failed,route,verdict. Each entry incheckscarriesid,name,passed, anddetailin that order.
Docker
docker run -i ghcr.io/cloudcorprecords/pdfaudit
docker run --rm -v "$PWD:/w" ghcr.io/cloudcorprecords/pdfaudit check_pdf_accessibility '{"file_path": "/w/document.pdf"}'
Development
npm install
npm run build # tsc -> dist/
npm test # tsx --test test/*.test.ts (pure local, no network)
npm run dev # run the CLI from source
License
MIT — Copyright (c) 2026 Rene Turcios
Reviews
No reviews yet
Be the first to review this server!
More Developer Tools MCP Servers
Rea
Freeby Morluto · Developer Tools
Reverse engineer anything from your terminal or agent with one CLI and MCP server.
Paperclip
Freeby Paperclipai · Developer Tools
Trending hip-hop artist momentum scores across four cultural dimensions.
Scrapling
Freeby D4Vinci · Developer Tools
Web scraping with stealth HTTP, real browsers, and Cloudflare bypass. CSS selectors supported.
Toleno
Freeby Toleno · Developer Tools
Toleno Network MCP Server — Manage your Toleno mining account with Claude AI using natural language.
MCP Marketplace
Freeby mcp-marketplace · Developer Tools
Search and install MCP servers from inside your AI client.
mcp-creator-python
Freeby mcp-marketplace · Developer Tools
Create, build, and publish Python MCP servers to PyPI — conversationally.
