Deterministic PDF document validation with traceable evidence.
Wellknown found it in public sources; nobody has proven control of it yet. Claiming takes one click if the repository is under your GitHub account, or a small file on your domain otherwise. Verified owners get the badge, 15-minute checks, status alerts, edits that outrank crawled data, and a ranking boost.
Agents can do it too: POST https://wellknown.network/api/v1/claims with {"agent":"pdfproof-mcp","method":"well_known_file"} — machine-readable steps at claim.json, guide at /docs/claim.
Everything here was measured by our prober or read from a registry. Nothing is self-reported.
Attributed to the source that supplied each field. Treated as claims, not facts.
# pdfproof-mcp `pdfproof-mcp` is a framework-agnostic MCP server and Python engine for validating structured JSON, Excel, or CSV test data against PDF documents. It resolves records through an ordered, configurable hierarchy and returns deterministic evidence, structured results, and an HTML report. The published distribution is named `pdfproof-mcp`; its Python import package is `pdfproof`. The project is intentionally not a general PDF-to-Excel converter, browser automation tool, or LLM-based validation system. ## Current status The deterministic core and MCP integration are implemented. The approved architecture and implementation sequence are in [PLAN.md](PLAN.md). ## Core guarantee Each locator narrows only the candidates left by the preceding locator. The engine never searches an expected field across the entire document after a record has been resolved, and never silently selects among ambiguous candidates. ## Test-data formats JSON, multi-sheet Excel, and simple tabular CSV inputs normalize into the same test suite. Each user-defined `record_id` links its locators and validations, but is never an implicit PDF search key. See [the test-data schema](docs/test-data-schema.md) for the JSON example, Excel sheet design, CSV guidance, and the locator-versus-validation distinction. Canonical fields use stable machine keys with optional report labels; financial values use `Decimal` precision. ## Usage modes For batch testing, pass `test_data_path` pointing to JSON, Excel, or CSV. For interactive use, an AI host/client can convert a user request into direct structured `test_data` for the same `validate_document` tool. Both paths use one canonical model and one deterministic validation engine; the server does not parse natural language. See [MCP usage](docs/mcp-usage.md). ## MCP server Start the stdio server from `C:\pdfproof-mcp`: ```text .venv\Scripts\python.exe -m pdfproof.server ``` The primary `validate_document` tool accepts exactly one of `test_da…
Mapped onto the structured taxonomy from declared text and observed tool names. Confidence shown for derived entries.
Every source is kept verbatim. Field changes are logged as events.