data Static interface comparison
PDF Toolkit MCP
0.12.1 0.13.0
3 new write capabilities require explicit review.1 new destructive capability requires explicit review.
View the upgrade review as Markdown
A shareable summary of this comparison for an issue, pull request or ticket. Select the text and copy it.
INTERFACE DIFF
What changed, tool by tool
- 7Added tools
- 0Removed tools
- 3Modified tools
- 0Input-schema changes
- 3Output-schema changes
- 4Declared authority changes
10 tools with recorded changes
convert_pdf_to_markdownModifiedWhat changed
- convert_pdf_to_markdown — Schema change: input property added: remove_page_furniture.
- convert_pdf_to_markdown — Output schema: schema keywords changed: anyOf [{"additionalProper… → [{"additionalProper….
- convert_pdf_to_markdown: description changed.
Why it could matter
- Calls or consumers built for the earlier schema may need to change.
- Code or prompts that read this tool’s results may receive a different shape.
- Models choose and call tools partly from their descriptions.
What to verify
- Validate representative existing tool calls against the new argument schema.
- Check consumers of this tool’s output against the new schema.
- Spot-check that agents still select this tool as intended.
- Declared effect
- write → write
- Description
- PreviousConvert a bounded page range of a local PDF into deterministic Markdown from the source-validated PDF Tools Extraction IR. Headings and lists require geometry or literal marker evidence. A table requires a complete recurring text grid, a clean ruled-rectangle grid, or a complete closed painted grid, with every item in one cell and real header evidence. A link requires a source-validated external http or https annotation target covering one contiguous text run. Unsupported tables and link targets, including merged cells, internal destinations, actions, and other schemes, stay escaped text with typed gaps. No OCR or external model. Optionally enable compact mode for counted dot-leader, isolated page-number, and spaced-hyphen normalizations; default output remains unchanged. Optionally saves transactional UTF-8 Markdown. Use absolute or ~/ local paths, not Claude container paths (/mnt/...).
- CurrentConvert a bounded page range of a local PDF into deterministic Markdown from the source-validated PDF Tools Extraction IR. Headings and lists require geometry or literal marker evidence. A table requires a complete recurring text grid, a clean ruled-rectangle grid, or a complete closed painted grid, with every item in one cell and real header evidence. A link requires a source-validated external http or https annotation target covering one contiguous text run. Unsupported tables and link targets, including merged cells, internal destinations, actions, and other schemes, stay escaped text with typed gaps. Compact extreme-margin page numbers and provenance furniture, plus same-band text repeated across selected pages, are removed with typed counts by default; detected headings and all source-evidenced table-region lines are preserved, and removal can be disabled. No OCR or external model. Optionally enable compact mode for counted dot-leader and spaced-hyphen normalizations. Optionally saves transactional UTF-8 Markdown. Use absolute or ~/ local paths, not Claude container paths (/mnt/...).
Input schema
Property Previous (0.12.1) Current (0.13.0) Change remove_page_furniturenot present booleanoptional - Added
17 unchanged entries
(schema root)compactemit_table_proposalsend_pageexpected_output_identityexpected_output_identity › canonical_pathexpected_output_identity › sha256expected_output_identity › size_bytesinclude_page_boundariesmax_charactersmax_itemsmax_markdown_bytesoutput_pathoverwritepasswordpdf_pathstart_page
Output schema
Property Previous (0.12.1) Current (0.13.0) Change (schema root)object, anyOf (4) object, anyOf (4) - Changed: anyOf
anyOf: [{"additionalProperties":false,"properties":{"conversion_status":{"enum":["complete","partial","failed"],"type":"string"},"gaps":{"items":{"additionalProperties":false,"properties":{"code":{"enum":["PAGE_RANGE_INCOMPLETE","SOURCE_ITEM_LIMIT… → [{"additionalProperties":false,"properties":{"conversion_status":{"enum":["complete","partial","failed"],"type":"string"},"gaps":{"items":{"additionalProperties":false,"properties":{"code":{"enum":["PAGE_RANGE_INCOMPLETE","SOURCE_ITEM_LIMIT… (truncated: full value in the exact JSON)Link to this toolExact JSON from the published snapshots
Loads the exact recorded definitions of this tool from both releases. The full snapshots are linked under Evidence and provenance.
create_extraction_workspaceAddedWhat changed
- New tool create_extraction_workspace, declared with write effect.
Why it could matter
- Agents connected to this release can be offered an operation that changes data, which the earlier release did not expose.
What to verify
- Review whether this operation should be exposed through your agent’s tool configuration.
- Declared effect
- — → write
Input schema
Property Previous (0.12.1) Current (0.13.0) Change (schema root)not present object, additionalProperties=false - Added
max_pagesnot present integer, maximum=200, minimum=1optional - Added
passwordnot present stringoptional - Added
pdf_pathnot present stringrequired - Added
schemanot present objectrequired - Added
workspace_idnot present string, pattern="^[a-z0-9](?:[a-z0-9_-]{0,62}[a-z0-9])?$"required - Added
Output schema
Property Previous (0.12.1) Current (0.13.0) Change (schema root)not present object, anyOf (2) - Added
Link to this toolExact JSON from the published snapshots
Loads the exact recorded definitions of this tool from both releases. The full snapshots are linked under Evidence and provenance.
delete_extraction_workspaceAddedWhat changed
- New tool delete_extraction_workspace, declared with destructive effect.
Why it could matter
- Agents connected to this release can be offered an operation declared as able to delete or irreversibly change data.
What to verify
- Review whether this operation should be exposed to agents, and whether it should require explicit approval.
- Declared effect
- — → write
Input schema
Property Previous (0.12.1) Current (0.13.0) Change (schema root)not present object, additionalProperties=false - Added
confirmnot present const="DELETE"required - Added
current_generation_sha256not present string, pattern="^[a-f0-9]{64}$"required - Added
workspace_idnot present stringrequired - Added
workspace_identity_sha256not present string, pattern="^[a-f0-9]{64}$"required - Added
Output schema
Property Previous (0.12.1) Current (0.13.0) Change (schema root)not present object, anyOf (2) - Added
Link to this toolExact JSON from the published snapshots
Loads the exact recorded definitions of this tool from both releases. The full snapshots are linked under Evidence and provenance.
inspect_extraction_stateAddedWhat changed
- New read-only tool inspect_extraction_state.
Why it could matter
- The release adds a capability without declared write authority.
What to verify
- Decide whether agents should be offered this tool.
- Declared effect
- — → read
Input schema
Property Previous (0.12.1) Current (0.13.0) Change (schema root)not present object, additionalProperties=false - Added
workspace_idnot present stringrequired - Added
workspace_identity_sha256not present string, pattern="^[a-f0-9]{64}$"required - Added
Output schema
Property Previous (0.12.1) Current (0.13.0) Change (schema root)not present object, anyOf (2) - Added
Link to this toolExact JSON from the published snapshots
Loads the exact recorded definitions of this tool from both releases. The full snapshots are linked under Evidence and provenance.
prepare_signing_packetModifiedWhat changed
- prepare_signing_packet — Schema change: input property added: require_provider_ready.
- prepare_signing_packet — Schema change: input property signature_locations changed: items {"properties":{"hei… → {"additionalPropert….
- prepare_signing_packet — Schema change: input schema keywords changed: +additionalProperties=false.
- prepare_signing_packet — Output schema: schema keywords changed: anyOf [{"additionalProper… → [{"additionalProper….
- prepare_signing_packet: description changed.
Why it could matter
- Calls or consumers built for the earlier schema may need to change.
- Code or prompts that read this tool’s results may receive a different shape.
- Models choose and call tools partly from their descriptions.
What to verify
- Validate representative existing tool calls against the new argument schema.
- Check consumers of this tool’s output against the new schema.
- Spot-check that agents still select this tool as intended.
- Declared effect
- write → write
- Description
- PreviousOne-shot workflow: fill form fields AND add 'Sign here' placeholder boxes to a PDF in a single pass, saving as a new file. Returns a manifest of all pending signature locations (named by label). Does NOT apply any signatures — that still requires apply_signature with human intent. Use this when an agent has filled out everything it can and is preparing the PDF for the user (or another party) to sign.
- CurrentOne-shot local workflow: fill form fields AND add 'Sign here' placeholder boxes to a PDF in a single pass, saving as a new file. Returns the legacy pending-location manifest plus a provider-neutral, source-bound preparation receipt. Does NOT apply a signature, contact a provider, create an agreement, or prove legal readiness. Set require_provider_ready=true only when every zone has an explicit type and participant binding.
Input schema
Property Previous (0.12.1) Current (0.13.0) Change (schema root)object object, additionalProperties=false - Constraint: additionalProperties
additionalProperties: — → falserequire_provider_readynot present booleanoptional - Added
signature_locations › [items]object object, additionalProperties=false - Constraint: additionalProperties
additionalProperties: — → falsesignature_locations › [items] › evidence_sourcenot present string, enum (3)optional - Added
signature_locations › [items] › field_typenot present string, enum (5)optional - Added
signature_locations › [items] › participant_idnot present string, pattern="^[A-Za-z0-9][A-Za-z0-9._:-]{0,127}$"optional - Added
signature_locations › [items] › participant_rolenot present string, pattern="^[A-Za-z0-9][A-Za-z0-9._:-]{0,127}$"optional - Added
signature_locations › [items] › zone_idnot present string, pattern="^[A-Za-z0-9][A-Za-z0-9._:-]{0,127}$"optional - Added
17 unchanged entries
allow_resignexpected_output_identityexpected_output_identity › canonical_pathexpected_output_identity › sha256expected_output_identity › size_bytesfield_valuesforce_xfaoutput_pathpasswordpdf_pathsignature_locationssignature_locations › [items] › heightsignature_locations › [items] › labelsignature_locations › [items] › pagesignature_locations › [items] › widthsignature_locations › [items] › xsignature_locations › [items] › y
Output schema
Property Previous (0.12.1) Current (0.13.0) Change (schema root)object, anyOf (3) object, anyOf (3) - Changed: anyOf
anyOf: [{"additionalProperties":false,"properties":{"active_path":{"type":"string"},"backup_path":{"anyOf":[{"type":"string"},{"type":"null"}]},"fieldCount":{"type":"integer"},"fields":{"items":{"additionalProperties":false,"properties":{"currentV… → [{"additionalProperties":false,"properties":{"active_path":{"type":"string"},"backup_path":{"anyOf":[{"type":"string"},{"type":"null"}]},"fieldCount":{"type":"integer"},"fields":{"items":{"additionalProperties":false,"properties":{"currentV… (truncated: full value in the exact JSON)Link to this toolExact JSON from the published snapshots
Loads the exact recorded definitions of this tool from both releases. The full snapshots are linked under Evidence and provenance.
read_extraction_chunkAddedWhat changed
- New read-only tool read_extraction_chunk.
Why it could matter
- The release adds a capability without declared write authority.
What to verify
- Decide whether agents should be offered this tool.
- Declared effect
- — → read
Input schema
Property Previous (0.12.1) Current (0.13.0) Change (schema root)not present object, additionalProperties=false - Added
chunk_idnot present string, pattern="^chunk\\.[a-f0-9]{64}$"required - Added
passwordnot present stringoptional - Added
pdf_pathnot present stringrequired - Added
workspace_idnot present stringrequired - Added
workspace_identity_sha256not present string, pattern="^[a-f0-9]{64}$"required - Added
Output schema
Property Previous (0.12.1) Current (0.13.0) Change (schema root)not present object, anyOf (2) - Added
Link to this toolExact JSON from the published snapshots
Loads the exact recorded definitions of this tool from both releases. The full snapshots are linked under Evidence and provenance.
read_extraction_workspaceAddedWhat changed
- New read-only tool read_extraction_workspace.
Why it could matter
- The release adds a capability without declared write authority.
What to verify
- Decide whether agents should be offered this tool.
- Declared effect
- — → read
Input schema
Property Previous (0.12.1) Current (0.13.0) Change (schema root)not present object, additionalProperties=false - Added
collectionnot present string, enum (5)required - Added
cursornot present stringoptional - Added
limitnot present integer, maximum=100, minimum=1optional - Added
workspace_idnot present stringrequired - Added
workspace_identity_sha256not present string, pattern="^[a-f0-9]{64}$"required - Added
Output schema
Property Previous (0.12.1) Current (0.13.0) Change (schema root)not present object, anyOf (2) - Added
Link to this toolExact JSON from the published snapshots
Loads the exact recorded definitions of this tool from both releases. The full snapshots are linked under Evidence and provenance.
read_pdf_layoutModifiedWhat changed
- read_pdf_layout — Output schema: schema keywords changed: anyOf [{"additionalProper… → [{"additionalProper….
Why it could matter
- Code or prompts that read this tool’s results may receive a different shape.
What to verify
- Check consumers of this tool’s output against the new schema.
- Declared effect
- read → read
Input schema
Input schema unchanged.
8 unchanged entries
(schema root)end_pagemax_charactersmax_itemsmax_output_characterspasswordpdf_pathstart_page
Output schema
Property Previous (0.12.1) Current (0.13.0) Change (schema root)object, anyOf (4) object, anyOf (4) - Changed: anyOf
anyOf: [{"additionalProperties":false,"properties":{"extraction_status":{"enum":["complete","partial","failed"],"type":"string"},"id_scope":{"additionalProperties":false,"properties":{"ir_version":{"const":"1.6.0"},"kind":{"const":"source_parser_i… → [{"additionalProperties":false,"properties":{"extraction_status":{"enum":["complete","partial","failed"],"type":"string"},"id_scope":{"additionalProperties":false,"properties":{"ir_version":{"const":"1.6.0"},"kind":{"const":"source_parser_i… (truncated: full value in the exact JSON)Link to this toolExact JSON from the published snapshots
Loads the exact recorded definitions of this tool from both releases. The full snapshots are linked under Evidence and provenance.
submit_extraction_proposalAddedWhat changed
- New tool submit_extraction_proposal, declared with write effect.
Why it could matter
- Agents connected to this release can be offered an operation that changes data, which the earlier release did not expose.
What to verify
- Review whether this operation should be exposed through your agent’s tool configuration.
- Declared effect
- — → write
Input schema
Property Previous (0.12.1) Current (0.13.0) Change (schema root)not present object, additionalProperties=false - Added
chunk_idsnot present array, maxItems=32, minItems=1required - Added
chunk_ids › [items]not present string, pattern="^chunk\\.[a-f0-9]{64}$" - Added
leaf_pointernot present stringrequired - Added
parent_generation_sha256not present string, pattern="^[a-f0-9]{64}$"required - Added
proposed_valuenot present {}required - Added
workspace_idnot present stringrequired - Added
workspace_identity_sha256not present string, pattern="^[a-f0-9]{64}$"required - Added
Output schema
Property Previous (0.12.1) Current (0.13.0) Change (schema root)not present object, anyOf (2) - Added
Link to this toolExact JSON from the published snapshots
Loads the exact recorded definitions of this tool from both releases. The full snapshots are linked under Evidence and provenance.
verify_extraction_proposalAddedWhat changed
- New tool verify_extraction_proposal, declared with write effect.
Why it could matter
- Agents connected to this release can be offered an operation that changes data, which the earlier release did not expose.
What to verify
- Review whether this operation should be exposed through your agent’s tool configuration.
- Declared effect
- — → write
Input schema
Property Previous (0.12.1) Current (0.13.0) Change (schema root)not present object, additionalProperties=false - Added
citationsnot present array, maxItems=32required - Added
citations › [items]not present object, additionalProperties=false - Added
citations › [items] › chunk_idnot present string, pattern="^chunk\\.[a-f0-9]{64}$"required - Added
citations › [items] › end_utf8_bytenot present integer, minimum=1required - Added
citations › [items] › quote_sha256not present string, pattern="^[a-f0-9]{64}$"required - Added
citations › [items] › start_utf8_bytenot present integer, minimum=0required - Added
methodnot present objectrequired - Added
passwordnot present stringoptional - Added
pdf_pathnot present stringrequired - Added
proposal_event_idnot present string, pattern="^event\\.[a-f0-9]{64}$"required - Added
proposal_generation_sha256not present string, pattern="^[a-f0-9]{64}$"required - Added
workspace_idnot present stringrequired - Added
workspace_identity_sha256not present string, pattern="^[a-f0-9]{64}$"required - Added
Output schema
Property Previous (0.12.1) Current (0.13.0) Change (schema root)not present object, anyOf (2) - Added
Link to this toolExact JSON from the published snapshots
Loads the exact recorded definitions of this tool from both releases. The full snapshots are linked under Evidence and provenance.
No tools match these filters.
41 tools with no recorded change
add_signature_fieldapply_page_planapply_signatureapply_textbulk_fill_from_csvcompare_pdfscreate_signaturedetect_signature_zonesdisplay_pdfextract_to_csvfetch_pdf_from_urlfill_pdffill_with_profileget_active_documentget_allowed_directoriesget_page_analysisget_pdf_identityget_pdf_infoget_pdf_resource_uriinspect_pdf_accessibilitylist_pdfslist_profileslist_signaturesload_profileload_signaturemerge_pdfsread_pdf_bytesread_pdf_contentread_pdf_fieldsread_pdf_pagesrender_pdf_pagerender_pdf_regionreorder_pdf_pagesreveal_in_finderrotate_pdf_pagessave_profilesearch_pdf_textset_active_documentsplit_pdfvalidate_pdfverify_table_proposal
Evidence and provenance
- Static findings
- FAIL from Modelara’s automated analysis of the two declared interfaces. A policy outcome, not a security rating or a runtime test.
- Human review
- Pending human review. No reviewer decision is recorded for this comparison.
- Published evidence
- Part of Valyd’s published data generation listed in valyd-data-source.json. Published records are not rewritten.
Show provenance and exact files
- Comparison
pdf-toolkit/0.12.1~0.13.0The published comparison identifier.- Analyzer
modelara v0.1.8Policy version not recorded.Analyzed Nov 5, 2026, 2:35 AM UTC.- Distribution
mcpb- Previous release
github.com/Open-Document-Alliance/PDF-Tools@0.12.144 tools · published by the registry Sep 1, 2026, 11:57 PM UTC · upstream v0.12.1Artifact integritysha256-ytJX9lIsuVvAwSV1Nt9DoPJ3rC5P8LkkQfJP5rwWh/w=Artifactpdf-toolkit-mcp.mcpbInterface fingerprintsha256:499d357e8c6f80e4037e0dfd76c350836a0559e5d7e4efdc21db6b76d5b107e7Exact interface snapshot (JSON)- Current release
github.com/Open-Document-Alliance/PDF-Tools@0.13.051 tools · published by the registry Sep 3, 2026, 12:20 AM UTC · upstream v0.13.0Artifact integritysha256-aB6P/UX8FHY77Io5x7iGzKbSBosVFgs84rktNGlCWZM=Artifactpdf-toolkit-mcp.mcpbInterface fingerprintsha256:7e3fb8db60ff359870a18bde398fe9927ffc894e24d51b2c5031ec94ee44b3d0Exact interface snapshot (JSON)- Comparison record
- Exact comparison record (JSON)
The integrity value or digest identifies the exact artifact that was inspected; it does not show that the package is safe. The interface fingerprint identifies the declared tools and schemas Modelara recorded for that release.
MODELARA ANALYSIS OUTPUT
Interface findings
Policy failures
4 findingscreate_extraction_workspaceFAILAddeddelete_extraction_workspaceFAILAddedsubmit_extraction_proposalFAILAddedverify_extraction_proposalFAILAdded
Requires review
3 findingsconvert_pdf_to_markdownREVIEWChangedShow details
input property added: remove_page_furnitureoutput schema keywords changed: anyOf [{"additionalProper… → [{"additionalProper…
prepare_signing_packetREVIEWChangedShow details
input property added: require_provider_readyinput property signature_locations changed: items {"properties":{"hei… → {"additionalPropert…input schema keywords changed: +additionalProperties=falseoutput schema keywords changed: anyOf [{"additionalProper… → [{"additionalProper…
read_pdf_layoutREVIEWChangedShow details
output schema keywords changed: anyOf [{"additionalProper… → [{"additionalProper…
Informational
5 findingsinspect_extraction_stateINFOAddedread_extraction_chunkINFOAddedread_extraction_workspaceINFOAddedconvert_pdf_to_markdownINFOChangedprepare_signing_packetINFOChanged
What do these results mean?
- PASS
- No policy-significant interface change detected.
- REVIEW
- Interface changes require inspection.
- FAIL
- A policy-significant change was detected.
- INVALID
- The comparison could not be evaluated reliably.