{"report":{"v":1,"package":"@shuji-bonji/pdf-verify-mcp","version":"0.35.0","ranAt":"2026-11-16T11:46:11.337Z","install":{"ok":true,"integrity":"sha512-cUQdXUbJU5Z7WbvJAjCqtWJGNbOW+TXeJNP366yjkOhSCeYB1hN9aaZOLp/z91pt1vIoz5pIAwRmxb+Su4i2HQ==","deps":13,"scripts":[],"bins":["pdf-verify-mcp"],"license":"MIT","engines":"node >=20","repository":"git+https://github.com/shuji-bonji/pdf-verify-mcp.git","bin":"pdf-verify-mcp"},"start":{"ok":true,"ms":226,"serverName":"pdf-verify-mcp","serverVersion":"0.35.0","protocol":"2025-06-18","stderr":"pdf-verify-mcp v0.35.0 running via stdio\n"},"tools":[{"name":"verify_signatures","description":"Cryptographically verify the digital signatures in a PDF document.\n\nFor each signature this tool: recomputes the ByteRange digest and compares it with the CMS messageDigest attribute, verifies the CMS/PKCS#7 signature value against the signer certificate, verifies any RFC 3161 signature timestamp, evaluates the certificate chain against trust anchors, and checks revocation status.\n\nArgs:\n  - file_path (string): Absolute path to a local PDF file\n  - response_format ('markdown' | 'json'): Output format (default: 'markdown')\n  - trust_anchors (string[], optional): Paths to trust anchor certificates (PEM/DER). Also reads the PDF_VERIFY_TRUST_ANCHORS env var (directory).\n  - check_revocation ('none' | 'embedded' | 'online'): Revocation mode (default: 'embedded'; 'online' queries OCSP/CRL endpoints over HTTP)\n  - revocation_freshness (integer seconds, default 86400): How long before the validation time a CRL / OCSP response may have been issued and still count as \"good\"\n  - trusted_ocsp_responders (string[], optional): Certificates of locally trusted OCSP responders (RFC 6960 §4.2.2.2)\n  - password (string, optional): Password for an encrypted PDF (permission-encrypted PDFs are decrypted automatically with the empty user password)\n\nReturns:\n  An object of the form { scope, signatures: [...] }. The top level changed from an array to an object in v0.21.0 - read .signatures for the list. signatures is null - not [] - when the document is encrypted and the key could not be derived (supply password); note then says why. [] means the fields were looked for and none is signed (v0.35.0).\n\n  Size (v0.29.0): a JSON response is never cut by length. At most 32 signature fields are verified (file order); when the file has more, signaturesTruncated = { returned, total } is set and the remaining fields are NOT verified — evaluate_policy verifies every field. A markdown response is cut at 50,000 characters with a visible marker.\n\n  Every report begins with file_path (the path as received, so answers to side-by-side calls can be matched to their inputs; markdown shows it as \"File:\" under the heading), then a \"scope\" object - how far the reading got, not a verdict: whether the cross-reference chain could be walked to the end (chainStop), whether this tool had to rebuild the cross-reference table itself (reconstructed - when true, the table is this tool's reconstruction and not the one the file carries), how many objects and sections were read, and whether an encrypted document could be opened. Read it before the verdict: \"no violations\" over a rebuilt table is not the same statement as \"no violations\" over the file's own table. For this tool it matters most: when scope.reconstructed is true, a signature the rebuild did not reach is absent from the list, so a short or empty list is not proof that the file carries no other signatures.\n\n  Per-signature verdict ('valid' / 'invalid' / 'indeterminate'), trust status ('trusted' / 'untrusted' / 'not_evaluated' with certificate ","params":["file_path","response_format","trust_anchors","check_revocation","revocation_freshness","trusted_ocsp_responders","password"]},{"name":"verify_integrity","description":"Analyze a PDF for modifications after signing.\n\nReports: number of revisions (incremental updates), whether bytes were added after each signature's signed range, whether the last signature covers the entire file, DocMDP certification permissions and violations, and DSS presence.\n\nDocMDP is assessed against what the P value actually permits (ISO 32000-2 Table 257): P=1 permits nothing, P=2 form fill-in and signing, P=3 additionally annotation creation/deletion/modification. The later changes are classified from the object-level diff (changeClass), so adding an annotation to a P=2 document is reported as a violation while the same change to a P=3 document is not. Objects a permitted change necessarily drags along — the page whose /Annots grew, the catalog, /Info, the XMP stream — are classified as housekeeping and do not by themselves constitute a violation. Per ISO 32000-2 §12.8.2.2, DSS/document-timestamp incremental updates after a P=1 certification are NOT violations (flagged as laterChangesAppearLtvOnly).\n\nviolationAssessment is three-valued: \"permitted\" / \"violated\" / \"indeterminate\". **\"indeterminate\" is not a pass** — it means the chain could not be walked or a changed object's kind could not be read, so nothing could be disproved. The boolean violatedByLaterChanges collapses indeterminate to false for backward compatibility; read violationAssessment when \"could not tell\" must not be mistaken for \"fine\".\n\nAlso reports an object-level diff of the incremental-update chain: for each revision, which objects were added, rewritten or freed, with the object's /Type and a plain-language role (annotation, form field widget, page object, content stream, …), plus the shortlist of objects written after the last signed range (objectChangesAfterLastSignature). Cross-reference and object streams are flagged as bookkeeping. Where the objects sit on the page is pdf-reader-mcp's answer, not this server's.\n\nLimits of the diff — it is an observation, never a verdict:\n  - Incremental updates are legal in PDF (ISO 32000-2 §7.5.6). A rewritten object says what to review, not that the file was tampered with. No verdict moves because of it.\n  - revisions: null means the cross-reference chain could not be walked (revisionChain.status: 'unwalkable') — \"not determined\", NOT \"nothing changed\".\n  - A non-null revisions list is not necessarily the whole history. revisionChain.status says which it is: 'complete' (walked from the newest cross-reference section back to the original revision), 'partial' (a list came back but revisionChain.missing names the end that is absent), or 'unwalkable' (the case above). revisionChain.missing holds 'oldest' when the chain ended before the original revision, and 'newest' when the last startxref did not point at a parseable section so an older entry point was used and the last append is not listed; both can be absent at once.\n  - **Only 'complete' makes \"no such change appears in the list\" mean \"that change was not made.\"** With a cut ch","params":["file_path","response_format"]},{"name":"detect_pades_level","description":"Observe which PAdES baseline level (ETSI EN 319 142) the structure of each signature matches.\n\n**This is an observation, not a conformance verdict.** ETSI EN 319 142 is not in this family's spec corpus, and unlike PDF/A there is no third-party validator to delegate to — so the result says \"the structure matches B-LT\", never \"conforms to PAdES B-LT\". Every report carries normativeBasis: \"T3\" to make that explicit.\n\nDetection is structural: B-B (CAdES signature), B-T (+ RFC 3161 signature timestamp), B-LT (+ DSS with validation data), B-LTA (+ document timestamp). Legacy adbe.pkcs7.detached signatures are reported as non-PAdES.\n\nArgs:\n  - file_path (string): Absolute path to a local PDF file\n  - response_format ('markdown' | 'json'): Output format (default: 'markdown')\n\nReturns:\n  An object of the form { scope, levels: [...] }. The top level changed from an array to an object in v0.21.0 - read .levels for the list.\n\n  Size (v0.29.0): at most 32 signatures are listed; levelsTruncated = { returned, total } says when the list was cut. JSON is never cut by length.\n\n  Every report begins with file_path (the path as received, so answers to side-by-side calls can be matched to their inputs; markdown shows it as \"File:\" under the heading), then a \"scope\" object - how far the reading got, not a verdict: whether the cross-reference chain could be walked to the end (chainStop), whether this tool had to rebuild the cross-reference table itself (reconstructed - when true, the table is this tool's reconstruction and not the one the file carries), how many objects and sections were read, and whether an encrypted document could be opened. Read it before the verdict: \"no violations\" over a rebuilt table is not the same statement as \"no violations\" over the file's own table.\n\n  Per-signature level with evidence (signature timestamp, DSS, VRI, document timestamp presence).\n\nNote: B-LT / B-LTA additionally require that the DSS revocation data actually covers the signer certificate (content-level LTV validation); otherwise the level is capped at B-T.\n\nExamples:\n  - Check if a signature is long-term validation (LTV) enabled\n  - Audit whether archived contracts meet B-LTA requirements","params":["file_path","response_format"]},{"name":"identify_conformance","description":"Identify declared PDF/A (pdfaid) and PDF/UA (pdfuaid) conformance in a PDF's XMP metadata.\n\nArgs:\n  - file_path (string): Absolute path to a local PDF file\n  - response_format ('markdown' | 'json'): Output format (default: 'markdown')\n\nReturns:\n  Every report begins with file_path (the path as received, so answers to side-by-side calls can be matched to their inputs; markdown shows it as \"File:\" under the heading), then a \"scope\" object - how far the reading got, not a verdict: whether the cross-reference chain could be walked to the end (chainStop), whether this tool had to rebuild the cross-reference table itself (reconstructed - when true, the table is this tool's reconstruction and not the one the file carries), how many objects and sections were read, and whether an encrypted document could be opened. Read it before the verdict: \"no violations\" over a rebuilt table is not the same statement as \"no violations\" over the file's own table.\n\n  Declared PDF/A part/conformance level and PDF/UA part, plus the PDF version.\n\n  xmpNamespaces (v0.31.0): every namespace the packet declares, each marked predefined (XMP Specification / ISO 19005), describedByExtensionSchema (a pdfaSchema:namespaceURI in the packet names it), and known (what this family can say it is — e.g. the W3C TDMRep namespace, or pdfuaid). A PDF/A declaration together with a namespace that is neither predefined nor described is what a PDF/A validator reports under ISO 19005-2 6.6.2.3 (19005-1 6.7.8); the note says so, as a declaration-level observation, not a validation result.\n\nIMPORTANT: This tool only IDENTIFIES the declared conformance — a declaration does not guarantee actual conformance. For real PDF/A rule checking use the validate_conformance tool (native rule subset, or veraPDF when installed).\n\nExamples:\n  - Check whether a document claims PDF/A-2b before archiving\n  - Detect PDF/UA declarations for accessibility workflows","params":["file_path","response_format"]},{"name":"validate_conformance","description":"Validate a PDF against a PDF/A flavour (ISO 19005, archiving) or a PDF/UA flavour (ISO 14289, accessibility).\n\nHybrid engine: when veraPDF is installed (PDF_VERIFY_VERAPDF env var or on PATH) validation is delegated to it for an authoritative result. Otherwise a built-in rule subset is checked natively:\n  - PDF/A (15 rules): encryption, file ID, LZW, font embedding, JavaScript/prohibited actions, OutputIntent, transparency for A-1, XFA, and more\n  - PDF/UA (12 rules): MarkInfo/Marked, StructTreeRoot, pdfuaid declaration, /Lang, DisplayDocTitle, document title, Figure /Alt, image tagging, heading hierarchy, table TH/TR, Link /Contents\n\nArgs:\n  - file_path (string): Absolute path to a local PDF file\n  - response_format ('markdown' | 'json'): Output format (default: 'markdown')\n  - flavour (string, optional): e.g. \"pdfa-2b\", \"pdfa-4\", \"pdfa-4f\", \"pdfua-1\". Defaults to the XMP declaration (PDF/A wins when both are declared; fallback: pdfa-2b). PDF/A-4 has no A/B/U level, so there is no \"pdfa-4b\"\n  - engine ('auto' | 'verapdf' | 'native'): Engine selection (default: 'auto')\n  - password (string, optional): Password for an encrypted PDF. The document is decrypted first so the rules see real structures; permission-encrypted PDFs (empty user password) are decrypted automatically. PDF/A without a derivable key: ENCRYPTED_PDF with next_actions naming the password (v0.35.0) — not a list of violations for objects that were never read\n\nWhen veraPDF does not run, the report says so before the numbers: authoritativeValidation.performed is false and names the reason (\"not_installed\", \"configured_path_unusable\" when PDF_VERIFY_VERAPDF points at something that is not executable, or \"native_engine_requested\"). A configured-but-unusable path is never silently replaced by another executable. With engine: \"verapdf\" the call fails instead of falling back to native: the error code is VERAPDF_NOT_AVAILABLE when PDF_VERIFY_VERAPDF is set but unusable, and VERAPDF_NOT_FOUND when veraPDF is in none of PDF_VERIFY_VERAPDF, PATH or the well-known install locations.\n\nReturns:\n  Every report begins with file_path (the path as received, so answers to side-by-side calls can be matched to their inputs; markdown shows it as \"File:\" under the heading), then a \"scope\" object - how far the reading got, not a verdict: whether the cross-reference chain could be walked to the end (chainStop), whether this tool had to rebuild the cross-reference table itself (reconstructed - when true, the table is this tool's reconstruction and not the one the file carries), how many objects and sections were read, and whether an encrypted document could be opened. Read it before the verdict: \"no violations\" over a rebuilt table is not the same statement as \"no violations\" over the file's own table.\n\n  Size (v0.29.0): violations lists at most 200 entries; failedRules and compliant are computed over all of them and violationsTruncated = { returned, total } says when the list was cut. JSON is never cut by l","params":["file_path","response_format","flavour","engine","password"]},{"name":"validate_clauses","description":"Check a PDF against constraints mapped from ISO 32000-1/-2 clauses — the body of the PDF specification itself, not PDF/A or PDF/UA.\n\nThis covers what veraPDF does not look at. veraPDF judges PDF/A and PDF/UA profiles; a document can pass those and still violate ISO 32000 (for example embedding a CFF font program under /FontFile2, which Table 124 forbids).\n\nThe mapping and its evaluation live in @shuji-bonji/pdf-constraints; this tool reports which version decided the result. Same file plus same given facts always produce the same result.\n\nBundled domains: font-embedding, document-metadata, annotation\n\nArgs:\n  - file_path (string): Absolute path to a local PDF file\n  - response_format ('markdown' | 'json'): Output format (default: 'markdown')\n  - domains (string[], optional): Restrict to specific domains\n  - given (object, optional): External facts, e.g. { \"isSubset\": true }\n\nReturns:\n  Every report begins with file_path (the path as received, so answers to side-by-side calls can be matched to their inputs; markdown shows it as \"File:\" under the heading), then a \"scope\" object - how far the reading got, not a verdict: whether the cross-reference chain could be walked to the end (chainStop), whether this tool had to rebuild the cross-reference table itself (reconstructed - when true, the table is this tool's reconstruction and not the one the file carries), how many objects and sections were read, and whether an encrypted document could be opened. Read it before the verdict: \"no violations\" over a rebuilt table is not the same statement as \"no violations\" over the file's own table.\n\n  Size (v0.29.0): results lists at most 200 entries (file order); violations and notDecided are counted over all of them and resultsTruncated = { returned, total } says when the list was cut. JSON is never cut by length.\n\n  Per-constraint results with the clause IDs they come from. Four states:\n  - pass — nothing in this constraint could be disproved\n  - fail — disproved, with the fact and its measured value as evidence\n  - not_applicable — the clause does not apply to this document\n  - needs_external_fact — a fact outside the file was not supplied, so the constraint was not decided (never defaulted into a pass)\n\nBecause these are T1 clauses, a failure can be stated plainly and the clause ID quoted — retrieve the wording with pdf-spec-mcp's get_requirements. Failures marked as traces are different: the clause addresses the PDF *processor*, so the file only shows that someone broke it, not that the last writer did.\n\nSome failures carry a Context note. Those clauses are real and the failure is real, but the industry deviates from them deliberately — text markup QuadPoints are written in Z order by nearly every writer because following the clause literally breaks rendering in major viewers. Pass the context on; a failure reported without it reads as a defect.\n\nEvery result also carries `observation` — how far the reading got: whether the revision chain could be walked to t","params":["file_path","response_format","domains","given"]},{"name":"evaluate_policy","description":"Produce a deterministic 4-value trust verdict (trust_and_use / use_with_caution / human_review_required / reject) for a PDF.\n\nRuns verify_signatures, verify_integrity and detect_pades_level internally (plus validate_conformance for long-term-preservation profiles) and folds the facts through a fixed rule table — the same facts and profile always yield the same verdict. The verdict is decided entirely by code; use the returned firedRules/advisories to explain the outcome, never to override it. It judges authenticity and integrity only, never the truth of the document's content.\n\nArgs:\n  - file_path (string): Absolute path to a local PDF file\n  - response_format ('markdown' | 'json'): Output format (default: 'markdown')\n  - profile ('general' | 'contract' | 'financial' | 'legal' | 'medical' | 'government'): Judgment profile (default: 'general')\n  - trust_anchors (string[], optional): Trust anchor certificate paths. Without them, signer identity stays not_evaluated and the verdict is capped at use_with_caution\n  - check_revocation ('none' | 'embedded' | 'online'): Revocation mode (default: 'embedded')\n  - revocation_freshness (integer seconds, default 86400): How long before the validation time a CRL / OCSP response may have been issued and still count as \"good\"\n  - trusted_ocsp_responders (string[], optional): Certificates of locally trusted OCSP responders (RFC 6960 §4.2.2.2)\n  - password (string, optional): Password for an encrypted PDF\n\nReturns:\n  Every report begins with file_path (the path as received, so answers to side-by-side calls can be matched to their inputs; markdown shows it as \"File:\" under the heading), then a \"scope\" object - how far the reading got, not a verdict: whether the cross-reference chain could be walked to the end (chainStop), whether this tool had to rebuild the cross-reference table itself (reconstructed - when true, the table is this tool's reconstruction and not the one the file carries), how many objects and sections were read, and whether an encrypted document could be opened. Read it before the verdict: \"no violations\" over a rebuilt table is not the same statement as \"no violations\" over the file's own table.\n\n  Size (v0.29.0): the verdict is computed over EVERY signature; facts.signatures lists at most 32 of them and facts.signaturesTruncated = { returned, total } says when it was cut. JSON is never cut by length.\n\n  facts.signatureCount counts signatures and leaves out document timestamps (facts.documentTimestampCount); facts.signatures lists both, so its length can be larger. When the document is encrypted and the key could not be derived, the three are null with facts.note, POL-CAUTION-UNSIGNED does not fire, and POL-REVIEW-SIGNATURES-NOT-READ (human_review_required) does instead (v0.35.0): \"could not look\" is not \"unsigned\".\n\n  verdict, firedRules (rule IDs with per-rule verdict and reason), advisories (recommendations that do not affect the verdict), and the underlying facts summary.\n\n  Content inventory (v","params":["file_path","response_format","profile","trust_anchors","check_revocation","revocation_freshness","trusted_ocsp_responders","password"]}],"toolsHash":"213e23e4a731b1bc4c23e3b854171ccbf954dcd74f9ca116ea57bc82c3c6e5d1","wrote":[],"host":{"commit":"eaaffffaf52255d1b77dc4aacffdfaf353f0c12c","run":"https://github.com/itsHaddad/bragproof/actions/runs/43857070216"},"network":{"names":["registry.npmjs.org"],"conns":[]}},"summary":{"outcome":"started","needs":[],"contacts":[],"flags":[{"kind":"very-long","tool":"verify_signatures","quote":"3000 characters or more"},{"kind":"very-long","tool":"verify_integrity","quote":"3000 characters or more"},{"kind":"orders","tool":"identify_conformance","quote":"a declaration-level observation, not a validation result. IMPORTANT: This tool only IDENTIFIES the declared conformance — a declaration does not guarantee actual confo"},{"kind":"very-long","tool":"validate_conformance","quote":"3000 characters or more"},{"kind":"very-long","tool":"validate_clauses","quote":"3000 characters or more"},{"kind":"very-long","tool":"evaluate_policy","quote":"3000 characters or more"}],"tools":7,"wrote":0,"callsTried":0,"callsAnswered":0,"callContacts":[]},"history":[{"package":"@shuji-bonji/pdf-verify-mcp","version":"0.35.0","ranAt":"2026-11-16T11:46:11.337Z","outcome":"started","tools":7,"contacts":0,"flags":6,"serious":0,"toolsHash":"213e23e4a731b1bc4c23e3b854171ccbf954dcd74f9ca116ea57bc82c3c6e5d1"}],"page":"https://bragproof.smaverk.com/r/%40shuji-bonji/pdf-verify-mcp"}