data Static interface comparison

PDF Toolkit MCP

0.12.1 0.13.0

FAILPending human review

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.

Tools44 → 51
Added7
Removed0
Schema changes3
Input schema changes0
Output schema changes3
Unclassified schema changes0
Description changes2
New write authority3
New destructive authority1
New unknown authority0
AnalysisFAIL

INTERFACE DIFF

What changed, tool by tool

Classification from the recorded findings · definitions from the published snapshots

10 tools with recorded changes

  1. convert_pdf_to_markdownModifiedSchemaDescriptionREVIEWINFO

    What 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

    PropertyPrevious (0.12.1)Current (0.13.0)Change
    remove_page_furniturenot presentbooleanoptional
    • Added
    17 unchanged entries
    • (schema root)
    • compact
    • emit_table_proposals
    • end_page
    • expected_output_identity
    • expected_output_identity › canonical_path
    • expected_output_identity › sha256
    • expected_output_identity › size_bytes
    • include_page_boundaries
    • max_characters
    • max_items
    • max_markdown_bytes
    • output_path
    • overwrite
    • password
    • pdf_path
    • start_page

    Output schema

    PropertyPrevious (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)

    Exact 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.

    Link to this tool
  2. create_extraction_workspaceAddedAuthorityFAIL

    What 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

    PropertyPrevious (0.12.1)Current (0.13.0)Change
    (schema root)not presentobject, additionalProperties=false
    • Added
    max_pagesnot presentinteger, maximum=200, minimum=1optional
    • Added
    passwordnot presentstringoptional
    • Added
    pdf_pathnot presentstringrequired
    • Added
    schemanot presentobjectrequired
    • Added
    workspace_idnot presentstring, pattern="^[a-z0-9](?:[a-z0-9_-]{0,62}[a-z0-9])?$"required
    • Added

    Output schema

    PropertyPrevious (0.12.1)Current (0.13.0)Change
    (schema root)not presentobject, anyOf (2)
    • Added
    Exact 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.

    Link to this tool
  3. delete_extraction_workspaceAddedAuthorityFAIL

    What 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

    PropertyPrevious (0.12.1)Current (0.13.0)Change
    (schema root)not presentobject, additionalProperties=false
    • Added
    confirmnot presentconst="DELETE"required
    • Added
    current_generation_sha256not presentstring, pattern="^[a-f0-9]{64}$"required
    • Added
    workspace_idnot presentstringrequired
    • Added
    workspace_identity_sha256not presentstring, pattern="^[a-f0-9]{64}$"required
    • Added

    Output schema

    PropertyPrevious (0.12.1)Current (0.13.0)Change
    (schema root)not presentobject, anyOf (2)
    • Added
    Exact 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.

    Link to this tool
  4. inspect_extraction_stateAddedAddedINFO

    What 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

    PropertyPrevious (0.12.1)Current (0.13.0)Change
    (schema root)not presentobject, additionalProperties=false
    • Added
    workspace_idnot presentstringrequired
    • Added
    workspace_identity_sha256not presentstring, pattern="^[a-f0-9]{64}$"required
    • Added

    Output schema

    PropertyPrevious (0.12.1)Current (0.13.0)Change
    (schema root)not presentobject, anyOf (2)
    • Added
    Exact 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.

    Link to this tool
  5. prepare_signing_packetModifiedSchemaDescriptionREVIEWINFO

    What 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

    PropertyPrevious (0.12.1)Current (0.13.0)Change
    (schema root)objectobject, additionalProperties=false
    • Constraint: additionalProperties

    additionalProperties: — → false

    require_provider_readynot presentbooleanoptional
    • Added
    signature_locations › [items]objectobject, additionalProperties=false
    • Constraint: additionalProperties

    additionalProperties: — → false

    signature_locations › [items] › evidence_sourcenot presentstring, enum (3)optional
    • Added
    signature_locations › [items] › field_typenot presentstring, enum (5)optional
    • Added
    signature_locations › [items] › participant_idnot presentstring, pattern="^[A-Za-z0-9][A-Za-z0-9._:-]{0,127}$"optional
    • Added
    signature_locations › [items] › participant_rolenot presentstring, pattern="^[A-Za-z0-9][A-Za-z0-9._:-]{0,127}$"optional
    • Added
    signature_locations › [items] › zone_idnot presentstring, pattern="^[A-Za-z0-9][A-Za-z0-9._:-]{0,127}$"optional
    • Added
    17 unchanged entries
    • allow_resign
    • expected_output_identity
    • expected_output_identity › canonical_path
    • expected_output_identity › sha256
    • expected_output_identity › size_bytes
    • field_values
    • force_xfa
    • output_path
    • password
    • pdf_path
    • signature_locations
    • signature_locations › [items] › height
    • signature_locations › [items] › label
    • signature_locations › [items] › page
    • signature_locations › [items] › width
    • signature_locations › [items] › x
    • signature_locations › [items] › y

    Output schema

    PropertyPrevious (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)

    Exact 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.

    Link to this tool
  6. read_extraction_chunkAddedAddedINFO

    What 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

    PropertyPrevious (0.12.1)Current (0.13.0)Change
    (schema root)not presentobject, additionalProperties=false
    • Added
    chunk_idnot presentstring, pattern="^chunk\\.[a-f0-9]{64}$"required
    • Added
    passwordnot presentstringoptional
    • Added
    pdf_pathnot presentstringrequired
    • Added
    workspace_idnot presentstringrequired
    • Added
    workspace_identity_sha256not presentstring, pattern="^[a-f0-9]{64}$"required
    • Added

    Output schema

    PropertyPrevious (0.12.1)Current (0.13.0)Change
    (schema root)not presentobject, anyOf (2)
    • Added
    Exact 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.

    Link to this tool
  7. read_extraction_workspaceAddedAddedINFO

    What 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

    PropertyPrevious (0.12.1)Current (0.13.0)Change
    (schema root)not presentobject, additionalProperties=false
    • Added
    collectionnot presentstring, enum (5)required
    • Added
    cursornot presentstringoptional
    • Added
    limitnot presentinteger, maximum=100, minimum=1optional
    • Added
    workspace_idnot presentstringrequired
    • Added
    workspace_identity_sha256not presentstring, pattern="^[a-f0-9]{64}$"required
    • Added

    Output schema

    PropertyPrevious (0.12.1)Current (0.13.0)Change
    (schema root)not presentobject, anyOf (2)
    • Added
    Exact 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.

    Link to this tool
  8. read_pdf_layoutModifiedSchemaREVIEW

    What 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_page
    • max_characters
    • max_items
    • max_output_characters
    • password
    • pdf_path
    • start_page

    Output schema

    PropertyPrevious (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)

    Exact 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.

    Link to this tool
  9. submit_extraction_proposalAddedAuthorityFAIL

    What 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

    PropertyPrevious (0.12.1)Current (0.13.0)Change
    (schema root)not presentobject, additionalProperties=false
    • Added
    chunk_idsnot presentarray, maxItems=32, minItems=1required
    • Added
    chunk_ids › [items]not presentstring, pattern="^chunk\\.[a-f0-9]{64}$"
    • Added
    leaf_pointernot presentstringrequired
    • Added
    parent_generation_sha256not presentstring, pattern="^[a-f0-9]{64}$"required
    • Added
    proposed_valuenot present{}required
    • Added
    workspace_idnot presentstringrequired
    • Added
    workspace_identity_sha256not presentstring, pattern="^[a-f0-9]{64}$"required
    • Added

    Output schema

    PropertyPrevious (0.12.1)Current (0.13.0)Change
    (schema root)not presentobject, anyOf (2)
    • Added
    Exact 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.

    Link to this tool
  10. verify_extraction_proposalAddedAuthorityFAIL

    What 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

    PropertyPrevious (0.12.1)Current (0.13.0)Change
    (schema root)not presentobject, additionalProperties=false
    • Added
    citationsnot presentarray, maxItems=32required
    • Added
    citations › [items]not presentobject, additionalProperties=false
    • Added
    citations › [items] › chunk_idnot presentstring, pattern="^chunk\\.[a-f0-9]{64}$"required
    • Added
    citations › [items] › end_utf8_bytenot presentinteger, minimum=1required
    • Added
    citations › [items] › quote_sha256not presentstring, pattern="^[a-f0-9]{64}$"required
    • Added
    citations › [items] › start_utf8_bytenot presentinteger, minimum=0required
    • Added
    methodnot presentobjectrequired
    • Added
    passwordnot presentstringoptional
    • Added
    pdf_pathnot presentstringrequired
    • Added
    proposal_event_idnot presentstring, pattern="^event\\.[a-f0-9]{64}$"required
    • Added
    proposal_generation_sha256not presentstring, pattern="^[a-f0-9]{64}$"required
    • Added
    workspace_idnot presentstringrequired
    • Added
    workspace_identity_sha256not presentstring, pattern="^[a-f0-9]{64}$"required
    • Added

    Output schema

    PropertyPrevious (0.12.1)Current (0.13.0)Change
    (schema root)not presentobject, anyOf (2)
    • Added
    Exact 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.

    Link to this tool
41 tools with no recorded change
  • add_signature_field
  • apply_page_plan
  • apply_signature
  • apply_text
  • bulk_fill_from_csv
  • compare_pdfs
  • create_signature
  • detect_signature_zones
  • display_pdf
  • extract_to_csv
  • fetch_pdf_from_url
  • fill_pdf
  • fill_with_profile
  • get_active_document
  • get_allowed_directories
  • get_page_analysis
  • get_pdf_identity
  • get_pdf_info
  • get_pdf_resource_uri
  • inspect_pdf_accessibility
  • list_pdfs
  • list_profiles
  • list_signatures
  • load_profile
  • load_signature
  • merge_pdfs
  • read_pdf_bytes
  • read_pdf_content
  • read_pdf_fields
  • read_pdf_pages
  • render_pdf_page
  • render_pdf_region
  • reorder_pdf_pages
  • reveal_in_finder
  • rotate_pdf_pages
  • save_profile
  • search_pdf_text
  • set_active_document
  • split_pdf
  • validate_pdf
  • verify_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)

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

Analyzed with Modelara v0.1.8 · Nov 5, 2026

Policy failures

4 findings
  • create_extraction_workspaceFAILAdded

    New capability with write effect

    Authority
    —WRITE
  • delete_extraction_workspaceFAILAdded

    New capability with destructive effect

    Authority
    —DESTRUCTIVE
  • submit_extraction_proposalFAILAdded

    New capability with write effect

    Authority
    —WRITE
  • verify_extraction_proposalFAILAdded

    New capability with write effect

    Authority
    —WRITE

Requires review

3 findings
  • convert_pdf_to_markdownREVIEWChanged

    Input and output schema changed

    Show details
    • input property added: remove_page_furniture
    • output schema keywords changed: anyOf [{"additionalProper… → [{"additionalProper…
    Authority
    DESTRUCTIVEDESTRUCTIVE
    Authority unchanged
  • prepare_signing_packetREVIEWChanged

    Input and output schema changed

    Show details
    • input property added: require_provider_ready
    • input property signature_locations changed: items {"properties":{"hei… → {"additionalPropert…
    • input schema keywords changed: +additionalProperties=false
    • output schema keywords changed: anyOf [{"additionalProper… → [{"additionalProper…
    Authority
    DESTRUCTIVEDESTRUCTIVE
    Authority unchanged
  • read_pdf_layoutREVIEWChanged

    Output schema changed

    Show details
    • output schema keywords changed: anyOf [{"additionalProper… → [{"additionalProper…
    Authority
    READREAD
    Authority unchanged

Informational

5 findings
  • inspect_extraction_stateINFOAdded

    New read-only capability

    Authority
    —READ
  • read_extraction_chunkINFOAdded

    New read-only capability

    Authority
    —READ
  • read_extraction_workspaceINFOAdded

    New read-only capability

    Authority
    —READ
  • convert_pdf_to_markdownINFOChanged

    Description changed

    Authority
    DESTRUCTIVEDESTRUCTIVE
    Authority unchanged
  • prepare_signing_packetINFOChanged

    Description changed

    Authority
    DESTRUCTIVEDESTRUCTIVE
    Authority unchanged
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.
← Back to PDF Toolkit MCP release history