Data MCP server

PDF Toolkit MCP

Version history of discovered tools, schemas, and declared agent authority.

View watchlist

DistributionDistribution: MCPB
Packagegithub.com/Open-Document-Alliance/PDF-Tools
Latest analyzed version0.14.0
Current tool count57
Latest analysisNov 5, 2026
Package source

OBSERVED INTERFACE

Capability surface

Modelara’s observed declarations are shown separately from its derived effect classifications.

3 releases analyzed0.12.1 → 0.14.0Latest: 0.14.0
  • read27
  • write11
  • destructive19
  • unknown0

Unknown means Valyd could not determine the capability's effect confidently from the declared interface and static evidence. It is not treated as safe.

Package
github.com/Open-Document-Alliance/PDF-Tools@0.14.0
Registry
mcpb
Published
Sep 22, 2026
Integrity
sha256-QuJkWB0IsmRbi7IizFfUgbYz7x297F7J26j9c/yORw4=
Analyzer
modelara v0.1.8 · policy not recorded
Repository
https://github.com/Open-Document-Alliance/PDF-Tools

57 capabilities

CapabilityTypeDerived effectFirst observed in Valyd coverageLast changed
add_signature_fieldpdf-toolkit:tool:add_signature_field
Observed interface and hashes

Draw a visible 'Sign here' placeholder box on a PDF page and save as a new file. Marks where a signature should go — does NOT sign the document. Useful when preparing a PDF to send to another party for signing. Coordinates are in points (72pt = 1 inch), TOP-LEFT origin: x=distance from left, y=distance from top.

Input schema

{
  "properties": {
    "allow_resign": {
      "description": "Proceed even if the PDF already contains cryptographic signature fields (default: false). Warning: saving will invalidate any existing signatures.",
      "type": "boolean"
    },
    "expected_output_identity": {
      "additionalProperties": false,
      "description": "Exact current identity returned by get_pdf_identity. Required when replacing a distinct existing output_path, optional for the separately guarded same-document backup workflow, and omitted for a new destination.",
      "properties": {
        "canonical_path": {
          "description": "Exact canonical_path returned by get_pdf_identity for the existing destination.",
          "type": "string"
        },
        "sha256": {
          "description": "Exact SHA-256 returned by get_pdf_identity for the existing destination.",
          "pattern": "^[a-f0-9]{64}$",
          "type": "string"
        },
        "size_bytes": {
          "description": "Exact size_bytes returned by get_pdf_identity for the existing destination.",
          "minimum": 0,
          "type": "integer"
        }
      },
      "required": [
        "canonical_path",
        "size_bytes",
        "sha256"
      ],
      "type": "object"
    },
    "force_xfa": {
      "description": "Proceed even if the PDF uses XFA forms (default: false). Warning: the XFA data will be stripped by pdf-lib.",
      "type": "boolean"
    },
    "height": {
      "description": "Height of the signature box, in points (e.g. 36 for a typical signature line)",
      "type": "number"
    },
    "label": {
      "description": "Text shown inside the box (default: 'Sign here')",
      "type": "string"
    },
    "output_path": {
      "description": "Path to save the output PDF. May be the same as pdf_path for in-place editing; the original will be backed up on the first mutation.",
      "type": "string"
    },
    "page": {
      "description": "Page number (1-indexed)",
      "type": "integer"
    },
    "password": {
      "description": "Password for an encrypted PDF. Supply the user or owner password and the document is decrypted in memory, changed, and then saved with exactly the encryption and permissions it already had (encrypted inputs are limited to 16 MiB). The protection is never removed, changed, or added by this tool. Leave it unset for an unencrypted document. If the document's own permissions deny the change being made, the owner password is required, because that is the credential which authorises overriding them.",
      "type": "string"
    },
    "pdf_path": {
      "description": "Path to the input PDF",
      "type": "string"
    },
    "width": {
      "description": "Width of the signature box, in points (e.g. 150 for a typical signature line)",
      "type": "number"
    },
    "x": {
      "description": "Left edge of the signature box, in points from the left of the page",
      "type": "number"
    },
    "y": {
      "description": "Top edge of the signature box, in points from the TOP of the page",
      "type": "number"
    }
  },
  "required": [
    "pdf_path",
    "output_path",
    "page",
    "x",
    "y",
    "width",
    "height"
  ],
  "type": "object"
}
sha256:70b55dc61349fb73696a5010bac7507c18d582498df83b4ec6006eac242c1b9d

Output schema

{
  "anyOf": [
    {
      "additionalProperties": false,
      "properties": {
        "active_path": {
          "type": "string"
        },
        "backup_path": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ]
        },
        "fieldCount": {
          "type": "integer"
        },
        "fields": {
          "items": {
            "additionalProperties": false,
            "properties": {
              "currentValue": {
                "anyOf": [
                  {
                    "type": "string"
                  },
                  {
                    "type": "boolean"
                  },
                  {
                    "items": {
                      "type": "string"
                    },
                    "type": "array"
                  }
                ]
              },
              "name": {
                "type": "string"
              },
              "options": {
                "items": {
                  "type": "string"
                },
                "type": "array"
              },
              "type": {
                "enum": [
                  "text",
                  "checkbox",
                  "radio",
                  "dropdown",
                  "unknown"
                ],
                "type": "string"
              }
            },
            "required": [
              "name",
              "type",
              "options",
              "currentValue"
            ],
            "type": "object"
          },
          "type": "array"
        },
        "hasFormFields": {
          "type": "boolean"
        },
        "height": {
          "type": "number"
        },
        "initialPage": {
          "type": "integer"
        },
        "label": {
          "type": "string"
        },
        "last_mutation_at": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ]
        },
        "last_mutation_tool": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ]
        },
        "page": {
          "type": "integer"
        },
        "pdfPath": {
          "type": "string"
        },
        "pdf_path": {
          "type": "string"
        },
        "totalBytes": {
          "type": "integer"
        },
        "width": {
          "type": "number"
        },
        "x": {
          "type": "number"
        },
        "y": {
          "type": "number"
        }
      },
      "required": [
        "pdfPath",
        "totalBytes",
        "initialPage",
        "fields",
        "fieldCount",
        "hasFormFields",
        "active_path",
        "backup_path",
        "last_mutation_tool",
        "last_mutation_at",
        "pdf_path",
        "page",
        "x",
        "y",
        "width",
        "height",
        "label"
      ],
      "type": "object"
    },
    {
      "additionalProperties": false,
      "properties": {
        "error": {
          "additionalProperties": false,
          "properties": {
            "code": {
              "enum": [
                "internal_validation_error",
                "path_policy_denied",
                "tool_execution_failed"
              ],
              "type": "string"
            },
            "error_schema_version": {
              "const": 1
            }
          },
          "required": [
            "error_schema_version",
            "code"
          ],
          "type": "object"
        },
        "status": {
          "const": "failed"
        }
      },
      "required": [
        "status",
        "error"
      ],
      "type": "object"
    },
    {
      "additionalProperties": false,
      "properties": {
        "error": {
          "additionalProperties": false,
          "properties": {
            "code": {
              "const": "PDF_RESOURCE_LIMIT_EXCEEDED"
            },
            "error_schema_version": {
              "const": 1
            }
          },
          "required": [
            "error_schema_version",
            "code"
          ],
          "type": "object"
        },
        "status": {
          "const": "failed"
        }
      },
      "required": [
        "status",
        "error"
      ],
      "type": "object"
    }
  ],
  "type": "object"
}
sha256:1bfaeda2b48c6cad130b379e6c326011cd74672c79bfbb9f8b0e1dc15f642a4b

Description hash: sha256:250dfb3e5a741de76b0fa6bda785983660fb4f5a8f605aeba8f007ac6b7e95ae

Interface hash: sha256:9cec4374b28e165daf18e05a9c6ce163da5b92335304b98ae35965c054d98273

Other observed Modelara metadata
{
  "id": "mcp:pdf-tools/add_signature_field",
  "title": "Add Signature Field",
  "source": {
    "type": "mcp",
    "server": "pdf-tools",
    "operation": "add_signature_field"
  },
  "declared": {
    "read_only": "false",
    "destructive": "true",
    "idempotent": "false",
    "open_world": "false"
  },
  "safety": {
    "idempotent": "false",
    "retry_safe": "false"
  },
  "metadata": {
    "mcp.annotations": "present"
  },
  "fingerprint": "sha256:fe9a28a99fffd37ebf11951249ad13faf6b4c5034dead2da9e8efbf912ea2ec6"
}
tooldestructive0.12.1No change observed
apply_page_planpdf-toolkit:tool:apply_page_plan
Observed interface and hashes

Apply a page plan to a PDF: reorder, rotate, and delete pages in one pass. Pages not listed in page_order are excluded (deleted). The source is never modified. Replacing a distinct existing output requires its exact current expected_output_identity. All paths must be absolute.

Input schema

{
  "properties": {
    "expected_output_identity": {
      "additionalProperties": false,
      "description": "Exact current identity returned by get_pdf_identity. Required when replacing a distinct existing output_path, optional for the separately guarded same-document backup workflow, and omitted for a new destination.",
      "properties": {
        "canonical_path": {
          "description": "Exact canonical_path returned by get_pdf_identity for the existing destination.",
          "type": "string"
        },
        "sha256": {
          "description": "Exact SHA-256 returned by get_pdf_identity for the existing destination.",
          "pattern": "^[a-f0-9]{64}$",
          "type": "string"
        },
        "size_bytes": {
          "description": "Exact size_bytes returned by get_pdf_identity for the existing destination.",
          "minimum": 0,
          "type": "integer"
        }
      },
      "required": [
        "canonical_path",
        "size_bytes",
        "sha256"
      ],
      "type": "object"
    },
    "force_xfa": {
      "description": "Proceed even if the PDF is a DYNAMIC XFA form, whose pages are built from the XFA layer that saving drops (default: false). Static XFA needs no flag: its values live in the AcroForm and survive, and the result says the layer was removed.",
      "type": "boolean"
    },
    "input_path": {
      "description": "Path to the source PDF file",
      "type": "string"
    },
    "output_path": {
      "description": "Path where the new PDF will be saved (must differ from input_path)",
      "type": "string"
    },
    "password": {
      "description": "Password for an encrypted PDF. Supply the user or owner password and the document is decrypted in memory, changed, and then saved with exactly the encryption and permissions it already had (encrypted inputs are limited to 16 MiB). The protection is never removed, changed, or added by this tool. Leave it unset for an unencrypted document. If the document's own permissions deny the change being made, the owner password is required, because that is the credential which authorises overriding them.",
      "type": "string"
    },
    "plan": {
      "description": "Page plan object",
      "properties": {
        "page_order": {
          "description": "1-indexed page numbers in desired order. Pages not listed are excluded (deleted).",
          "items": {
            "type": "integer"
          },
          "type": "array"
        },
        "rotations": {
          "additionalProperties": {
            "type": "number"
          },
          "description": "Map of original page number (string) to rotation degrees (90, 180, or 270). Entries for excluded pages are silently ignored.",
          "type": "object"
        }
      },
      "required": [
        "page_order"
      ],
      "type": "object"
    }
  },
  "required": [
    "input_path",
    "output_path",
    "plan"
  ],
  "type": "object"
}
sha256:e9fbf893f1de2bdd0a13f3ccd67de4a2410bea67c02ca71e9e6a87c48114ef2a

Output schema

{
  "anyOf": [
    {
      "additionalProperties": false,
      "properties": {
        "active_path": {
          "type": "string"
        },
        "backup_path": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ]
        },
        "deleted_pages": {
          "type": "integer"
        },
        "fieldCount": {
          "type": "integer"
        },
        "fields": {
          "items": {
            "additionalProperties": false,
            "properties": {
              "currentValue": {
                "anyOf": [
                  {
                    "type": "string"
                  },
                  {
                    "type": "boolean"
                  },
                  {
                    "items": {
                      "type": "string"
                    },
                    "type": "array"
                  }
                ]
              },
              "name": {
                "type": "string"
              },
              "options": {
                "items": {
                  "type": "string"
                },
                "type": "array"
              },
              "type": {
                "enum": [
                  "text",
                  "checkbox",
                  "radio",
                  "dropdown",
                  "unknown"
                ],
                "type": "string"
              }
            },
            "required": [
              "name",
              "type",
              "options",
              "currentValue"
            ],
            "type": "object"
          },
          "type": "array"
        },
        "hasFormFields": {
          "type": "boolean"
        },
        "initialPage": {
          "type": "integer"
        },
        "last_mutation_at": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ]
        },
        "last_mutation_tool": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ]
        },
        "page_order": {
          "items": {
            "type": "integer"
          },
          "type": "array"
        },
        "pdfPath": {
          "type": "string"
        },
        "rotated_pages": {
          "type": "integer"
        },
        "rotations": {
          "additionalProperties": {
            "enum": [
              0,
              90,
              180,
              270
            ],
            "type": "number"
          },
          "type": "object"
        },
        "totalBytes": {
          "type": "integer"
        }
      },
      "required": [
        "pdfPath",
        "totalBytes",
        "initialPage",
        "fields",
        "fieldCount",
        "hasFormFields",
        "active_path",
        "backup_path",
        "last_mutation_tool",
        "last_mutation_at",
        "deleted_pages",
        "rotated_pages",
        "page_order",
        "rotations"
      ],
      "type": "object"
    },
    {
      "additionalProperties": false,
      "properties": {
        "error": {
          "additionalProperties": false,
          "properties": {
            "code": {
              "enum": [
                "internal_validation_error",
                "path_policy_denied",
                "tool_execution_failed"
              ],
              "type": "string"
            },
            "error_schema_version": {
              "const": 1
            }
          },
          "required": [
            "error_schema_version",
            "code"
          ],
          "type": "object"
        },
        "status": {
          "const": "failed"
        }
      },
      "required": [
        "status",
        "error"
      ],
      "type": "object"
    },
    {
      "additionalProperties": false,
      "properties": {
        "error": {
          "additionalProperties": false,
          "properties": {
            "code": {
              "const": "PDF_RESOURCE_LIMIT_EXCEEDED"
            },
            "error_schema_version": {
              "const": 1
            }
          },
          "required": [
            "error_schema_version",
            "code"
          ],
          "type": "object"
        },
        "status": {
          "const": "failed"
        }
      },
      "required": [
        "status",
        "error"
      ],
      "type": "object"
    }
  ],
  "type": "object"
}
sha256:bba9fb0cc89e77f060ab9d9aad73c17ac970de93785d64159db787a6bfcc313a

Description hash: sha256:f2ebd33e0a9c972a1dd01e84c7ac71f0b90ffa22d7235c0f2a7dad1e1ee8a253

Interface hash: sha256:72956ba4df92c7cf28804a8caac7a2244d72f3f688eef4a0d568120e04e43794

Other observed Modelara metadata
{
  "id": "mcp:pdf-tools/apply_page_plan",
  "title": "Apply Page Plan",
  "source": {
    "type": "mcp",
    "server": "pdf-tools",
    "operation": "apply_page_plan"
  },
  "declared": {
    "read_only": "false",
    "destructive": "true",
    "idempotent": "true",
    "open_world": "false"
  },
  "safety": {
    "idempotent": "true",
    "retry_safe": "unknown"
  },
  "metadata": {
    "mcp.annotations": "present"
  },
  "fingerprint": "sha256:38c05ef7c7437d801e4da196af8fb7239ba255a34af6ae4907eeabee2568411d"
}
tooldestructive0.12.10.14.0
apply_signaturepdf-toolkit:tool:apply_signature
Observed interface and hashes

NEVER FABRICATE user_intent_statement OR user_confirmed_at. Both values MUST come directly from the user — ask them, get their answer, pass it through verbatim. Fabricating these is a hard violation of the human-intent requirement this tool ships under; every agent calling apply_signature does so on behalf of a user who has the legal responsibility for the signature. This stamps a saved signature onto a PDF as a BASIC visible image — NOT legally-binding cryptographic signing. REQUIRED WORKFLOW: 1. Call detect_signature_zones(pdf_path) first. Never guess coordinates — guessing places signatures on the wrong content (body text, section headers, etc.). 2. Pick the zone that matches what the user is signing (by type, label, and page). 3. Ask the user for a sentence describing their intent (e.g. "I, {name}, sign this {document} on {date}") and the ISO-8601 timestamp at which they confirmed. Pass both to apply_signature. 4. Call apply_signature with the zone's x/y/width/height + the intent values. Coordinates use TOP-LEFT origin in points (72pt = 1 inch), in the page's NATIVE (pre-rotation) coordinate space — same space returned by detect_signature_zones. Both intent values are written into the PDF's Keywords metadata as an audit trail.

Input schema

{
  "properties": {
    "allow_resign": {
      "description": "Proceed even if the PDF already contains cryptographic signature fields (default: false). Warning: saving will invalidate any existing signatures. Only enable if the user explicitly wants to re-sign a previously-signed document.",
      "type": "boolean"
    },
    "draw_audit_line": {
      "description": "Also draw a small visible timestamp/signer line below the signature (default: false). Useful for printable audit trails.",
      "type": "boolean"
    },
    "expected_output_identity": {
      "additionalProperties": false,
      "description": "Exact current identity returned by get_pdf_identity. Required when replacing a distinct existing output_path, optional for the separately guarded same-document backup workflow, and omitted for a new destination.",
      "properties": {
        "canonical_path": {
          "description": "Exact canonical_path returned by get_pdf_identity for the existing destination.",
          "type": "string"
        },
        "sha256": {
          "description": "Exact SHA-256 returned by get_pdf_identity for the existing destination.",
          "pattern": "^[a-f0-9]{64}$",
          "type": "string"
        },
        "size_bytes": {
          "description": "Exact size_bytes returned by get_pdf_identity for the existing destination.",
          "minimum": 0,
          "type": "integer"
        }
      },
      "required": [
        "canonical_path",
        "size_bytes",
        "sha256"
      ],
      "type": "object"
    },
    "force_xfa": {
      "description": "Proceed even if the PDF is a DYNAMIC XFA form, whose pages are built from the XFA layer that saving drops (default: false). Static XFA needs no flag: its values live in the AcroForm and survive, and the result says the layer was removed.",
      "type": "boolean"
    },
    "height": {
      "description": "Height in points",
      "type": "number"
    },
    "output_path": {
      "description": "Path to save the signed PDF. May be the same as pdf_path for in-place signing; the original will be backed up on the first mutation.",
      "type": "string"
    },
    "overwrite": {
      "description": "Deprecated compatibility field. true is accepted as a no-op when the destination does not exist or output_path identifies the same canonical document as pdf_path. It never authorizes replacing a distinct existing output; that requires expected_output_identity.",
      "type": "boolean"
    },
    "page": {
      "description": "Page number (1-indexed)",
      "type": "integer"
    },
    "password": {
      "description": "Password for an encrypted PDF. Supply the user or owner password and the document is decrypted in memory, changed, and then saved with exactly the encryption and permissions it already had (encrypted inputs are limited to 16 MiB). The protection is never removed, changed, or added by this tool. Leave it unset for an unencrypted document. If the document's own permissions deny the change being made, the owner password is required, because that is the credential which authorises overriding them.",
      "type": "string"
    },
    "pdf_path": {
      "description": "Path to the input PDF",
      "type": "string"
    },
    "signature_name": {
      "description": "Name of a previously-saved signature (see create_signature / list_signatures)",
      "type": "string"
    },
    "signing_mode": {
      "description": "Optional semantic label for the visible mark. Use 'initials' when applying a mark to an initials zone so results and audit metadata say 'initialed' instead of 'signed'.",
      "enum": [
        "signature",
        "initials"
      ],
      "type": "string"
    },
    "user_confirmed_at": {
      "description": "REQUIRED. ISO-8601 timestamp of when the user confirmed signing, e.g. \"2026-04-16T19:32:00Z\". Must be within the last 24 hours. Ask the user; do not fabricate.",
      "type": "string"
    },
    "user_intent_statement": {
      "description": "REQUIRED. The user's own sentence confirming intent to sign — e.g. \"I, Mat Silverstein, sign this W-9 application on 2026-04-16.\" Ask the user for this verbatim; do not invent it.",
      "type": "string"
    },
    "width": {
      "description": "Width in points",
      "type": "number"
    },
    "x": {
      "description": "Left edge in points, TOP-LEFT origin",
      "type": "number"
    },
    "y": {
      "description": "Top edge in points, TOP-LEFT origin",
      "type": "number"
    }
  },
  "required": [
    "pdf_path",
    "output_path",
    "signature_name",
    "page",
    "x",
    "y",
    "width",
    "height",
    "user_intent_statement",
    "user_confirmed_at"
  ],
  "type": "object"
}
sha256:104123af8edc76ddc450aeb0364cad6b96316f6807b72eeaeb08994e96871d7b

Output schema

{
  "anyOf": [
    {
      "additionalProperties": false,
      "properties": {
        "active_path": {
          "type": "string"
        },
        "backup_path": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ]
        },
        "confirmed_at": {
          "type": "string"
        },
        "fieldCount": {
          "type": "integer"
        },
        "fields": {
          "items": {
            "additionalProperties": false,
            "properties": {
              "currentValue": {
                "anyOf": [
                  {
                    "type": "string"
                  },
                  {
                    "type": "boolean"
                  },
                  {
                    "items": {
                      "type": "string"
                    },
                    "type": "array"
                  }
                ]
              },
              "name": {
                "type": "string"
              },
              "options": {
                "items": {
                  "type": "string"
                },
                "type": "array"
              },
              "type": {
                "enum": [
                  "text",
                  "checkbox",
                  "radio",
                  "dropdown",
                  "unknown"
                ],
                "type": "string"
              }
            },
            "required": [
              "name",
              "type",
              "options",
              "currentValue"
            ],
            "type": "object"
          },
          "type": "array"
        },
        "hasFormFields": {
          "type": "boolean"
        },
        "height": {
          "type": "number"
        },
        "initialPage": {
          "type": "integer"
        },
        "intent_statement": {
          "type": "string"
        },
        "last_mutation_at": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ]
        },
        "last_mutation_tool": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ]
        },
        "page": {
          "type": "integer"
        },
        "pdfPath": {
          "type": "string"
        },
        "pdf_path": {
          "type": "string"
        },
        "signature_name": {
          "type": "string"
        },
        "signer": {
          "type": "string"
        },
        "signing_mode": {
          "enum": [
            "signature",
            "initials"
          ],
          "type": "string"
        },
        "tier": {
          "const": "basic-local-stamp"
        },
        "totalBytes": {
          "type": "integer"
        },
        "width": {
          "type": "number"
        },
        "x": {
          "type": "number"
        },
        "y": {
          "type": "number"
        }
      },
      "required": [
        "pdfPath",
        "totalBytes",
        "initialPage",
        "fields",
        "fieldCount",
        "hasFormFields",
        "active_path",
        "backup_path",
        "last_mutation_tool",
        "last_mutation_at",
        "pdf_path",
        "signature_name",
        "page",
        "x",
        "y",
        "width",
        "height",
        "signer",
        "confirmed_at",
        "intent_statement",
        "signing_mode",
        "tier"
      ],
      "type": "object"
    },
    {
      "additionalProperties": false,
      "properties": {
        "error": {
          "additionalProperties": false,
          "properties": {
            "code": {
              "enum": [
                "internal_validation_error",
                "path_policy_denied",
                "tool_execution_failed"
              ],
              "type": "string"
            },
            "error_schema_version": {
              "const": 1
            }
          },
          "required": [
            "error_schema_version",
            "code"
          ],
          "type": "object"
        },
        "status": {
          "const": "failed"
        }
      },
      "required": [
        "status",
        "error"
      ],
      "type": "object"
    },
    {
      "additionalProperties": false,
      "properties": {
        "error": {
          "additionalProperties": false,
          "properties": {
            "code": {
              "const": "PDF_RESOURCE_LIMIT_EXCEEDED"
            },
            "error_schema_version": {
              "const": 1
            }
          },
          "required": [
            "error_schema_version",
            "code"
          ],
          "type": "object"
        },
        "status": {
          "const": "failed"
        }
      },
      "required": [
        "status",
        "error"
      ],
      "type": "object"
    }
  ],
  "type": "object"
}
sha256:90c3e36d019714fdfc0571bd61dd532a841a5a309e8bd884ffda688499213d51

Description hash: sha256:812b01ae8ebc5589610f4cad8b2da508bf316c835983dadaa84a29d207b16d37

Interface hash: sha256:db84f0e63b5c1b0f6d0e55859d3774c4eb67b528935ca55f217d3bde2b7eb00a

Other observed Modelara metadata
{
  "id": "mcp:pdf-tools/apply_signature",
  "title": "Apply Signature",
  "source": {
    "type": "mcp",
    "server": "pdf-tools",
    "operation": "apply_signature"
  },
  "declared": {
    "read_only": "false",
    "destructive": "true",
    "idempotent": "false",
    "open_world": "false"
  },
  "safety": {
    "idempotent": "false",
    "retry_safe": "false"
  },
  "metadata": {
    "mcp.annotations": "present"
  },
  "fingerprint": "sha256:18634bc4d1013ddd938d464a8d18e1e9bc113e86267a356597fd2079d789f365"
}
tooldestructive0.12.10.14.0
apply_textpdf-toolkit:tool:apply_text
Observed interface and hashes

Stamp a plain text string at a location on a PDF, saving the result as a new file. Use this for date zones (stamp today's date), or any other "put these characters here" operation that isn't a signature. NO user_intent_statement required — text is not a signature. Coordinates use TOP-LEFT origin in points, same as apply_signature. Writes a one-line audit entry to the PDF's Keywords metadata.

Input schema

{
  "properties": {
    "allow_resign": {
      "description": "Proceed even if the PDF has existing cryptographic signatures (default: false — saving would invalidate them)",
      "type": "boolean"
    },
    "expected_output_identity": {
      "additionalProperties": false,
      "description": "Exact current identity returned by get_pdf_identity. Required when replacing a distinct existing output_path, optional for the separately guarded same-document backup workflow, and omitted for a new destination.",
      "properties": {
        "canonical_path": {
          "description": "Exact canonical_path returned by get_pdf_identity for the existing destination.",
          "type": "string"
        },
        "sha256": {
          "description": "Exact SHA-256 returned by get_pdf_identity for the existing destination.",
          "pattern": "^[a-f0-9]{64}$",
          "type": "string"
        },
        "size_bytes": {
          "description": "Exact size_bytes returned by get_pdf_identity for the existing destination.",
          "minimum": 0,
          "type": "integer"
        }
      },
      "required": [
        "canonical_path",
        "size_bytes",
        "sha256"
      ],
      "type": "object"
    },
    "font_style": {
      "description": "Font style (default: normal)",
      "enum": [
        "normal",
        "italic"
      ],
      "type": "string"
    },
    "force_xfa": {
      "description": "Proceed even if the PDF uses XFA forms (default: false — the XFA layer will be stripped)",
      "type": "boolean"
    },
    "height": {
      "description": "Height in points",
      "type": "number"
    },
    "output_path": {
      "description": "Path to save the stamped PDF. May be the same as pdf_path for in-place editing; the original will be backed up on the first mutation.",
      "type": "string"
    },
    "overwrite": {
      "description": "Deprecated compatibility field. true is accepted as a no-op when the destination does not exist or output_path identifies the same canonical document as pdf_path. It never authorizes replacing a distinct existing output; that requires expected_output_identity.",
      "type": "boolean"
    },
    "page": {
      "description": "Page number (1-indexed)",
      "type": "integer"
    },
    "password": {
      "description": "Password for an encrypted PDF. Supply the user or owner password and the document is decrypted in memory, changed, and then saved with exactly the encryption and permissions it already had (encrypted inputs are limited to 16 MiB). The protection is never removed, changed, or added by this tool. Leave it unset for an unencrypted document. If the document's own permissions deny the change being made, the owner password is required, because that is the credential which authorises overriding them.",
      "type": "string"
    },
    "pdf_path": {
      "description": "Path to the input PDF",
      "type": "string"
    },
    "text": {
      "description": "Text to stamp (max 200 chars)",
      "type": "string"
    },
    "width": {
      "description": "Width in points",
      "type": "number"
    },
    "x": {
      "description": "Left edge in points, TOP-LEFT origin",
      "type": "number"
    },
    "y": {
      "description": "Top edge in points, TOP-LEFT origin",
      "type": "number"
    }
  },
  "required": [
    "pdf_path",
    "output_path",
    "page",
    "x",
    "y",
    "width",
    "height",
    "text"
  ],
  "type": "object"
}
sha256:ceb63400838d91c495e04ba20634efa1887b3afad31eccd33fe939bf30016646

Output schema

{
  "anyOf": [
    {
      "additionalProperties": false,
      "properties": {
        "active_path": {
          "type": "string"
        },
        "backup_path": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ]
        },
        "fieldCount": {
          "type": "integer"
        },
        "fields": {
          "items": {
            "additionalProperties": false,
            "properties": {
              "currentValue": {
                "anyOf": [
                  {
                    "type": "string"
                  },
                  {
                    "type": "boolean"
                  },
                  {
                    "items": {
                      "type": "string"
                    },
                    "type": "array"
                  }
                ]
              },
              "name": {
                "type": "string"
              },
              "options": {
                "items": {
                  "type": "string"
                },
                "type": "array"
              },
              "type": {
                "enum": [
                  "text",
                  "checkbox",
                  "radio",
                  "dropdown",
                  "unknown"
                ],
                "type": "string"
              }
            },
            "required": [
              "name",
              "type",
              "options",
              "currentValue"
            ],
            "type": "object"
          },
          "type": "array"
        },
        "hasFormFields": {
          "type": "boolean"
        },
        "height": {
          "type": "number"
        },
        "initialPage": {
          "type": "integer"
        },
        "last_mutation_at": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ]
        },
        "last_mutation_tool": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ]
        },
        "page": {
          "type": "integer"
        },
        "pdfPath": {
          "type": "string"
        },
        "pdf_path": {
          "type": "string"
        },
        "text": {
          "type": "string"
        },
        "totalBytes": {
          "type": "integer"
        },
        "width": {
          "type": "number"
        },
        "x": {
          "type": "number"
        },
        "y": {
          "type": "number"
        }
      },
      "required": [
        "pdfPath",
        "totalBytes",
        "initialPage",
        "fields",
        "fieldCount",
        "hasFormFields",
        "active_path",
        "backup_path",
        "last_mutation_tool",
        "last_mutation_at",
        "pdf_path",
        "page",
        "x",
        "y",
        "width",
        "height",
        "text"
      ],
      "type": "object"
    },
    {
      "additionalProperties": false,
      "properties": {
        "error": {
          "additionalProperties": false,
          "properties": {
            "code": {
              "enum": [
                "internal_validation_error",
                "path_policy_denied",
                "tool_execution_failed"
              ],
              "type": "string"
            },
            "error_schema_version": {
              "const": 1
            }
          },
          "required": [
            "error_schema_version",
            "code"
          ],
          "type": "object"
        },
        "status": {
          "const": "failed"
        }
      },
      "required": [
        "status",
        "error"
      ],
      "type": "object"
    },
    {
      "additionalProperties": false,
      "properties": {
        "error": {
          "additionalProperties": false,
          "properties": {
            "code": {
              "const": "PDF_RESOURCE_LIMIT_EXCEEDED"
            },
            "error_schema_version": {
              "const": 1
            }
          },
          "required": [
            "error_schema_version",
            "code"
          ],
          "type": "object"
        },
        "status": {
          "const": "failed"
        }
      },
      "required": [
        "status",
        "error"
      ],
      "type": "object"
    }
  ],
  "type": "object"
}
sha256:53da95c7550d74929bfb9e4e708bb5ae75adfacb2aac96249a4fb1ef774be064

Description hash: sha256:d8287340a08a52712a54c7cf9a47e5907861d139827458710360d3fcf87c3b86

Interface hash: sha256:e38cd3e3b37dd2b04ade1bbf8568b186649fad4c4f082d892f5b0782bab4539e

Other observed Modelara metadata
{
  "id": "mcp:pdf-tools/apply_text",
  "title": "Apply Text",
  "source": {
    "type": "mcp",
    "server": "pdf-tools",
    "operation": "apply_text"
  },
  "declared": {
    "read_only": "false",
    "destructive": "true",
    "idempotent": "false",
    "open_world": "false"
  },
  "safety": {
    "idempotent": "false",
    "retry_safe": "false"
  },
  "metadata": {
    "mcp.annotations": "present"
  },
  "fingerprint": "sha256:e7f2f275dce534fc77b698563edc0d677d247337457c31ae792c618282a4c8bc"
}
tooldestructive0.12.1No change observed
bulk_fill_from_csvpdf-toolkit:tool:bulk_fill_from_csv
Observed interface and hashes

Fill multiple PDFs using data from a CSV file. Output filenames must be unique. New outputs need no identity; every existing destination requires one exact entry in expected_output_identities. Any missing, stale, unrelated, or duplicate identity or any row failure aborts the whole batch.

Input schema

{
  "properties": {
    "csv_path": {
      "description": "Path to CSV file with data (first row should be field names)",
      "type": "string"
    },
    "expected_output_identities": {
      "description": "Exact identities for generated batch destinations that already exist. Omit new destinations. Any stale, duplicate, unrelated, or missing entry aborts the whole batch.",
      "items": {
        "additionalProperties": false,
        "properties": {
          "canonical_path": {
            "description": "Exact canonical_path returned by get_pdf_identity for the existing destination.",
            "type": "string"
          },
          "output_path": {
            "description": "Computed absolute output path this identity authorizes replacing.",
            "type": "string"
          },
          "sha256": {
            "description": "Exact SHA-256 returned by get_pdf_identity for the existing destination.",
            "pattern": "^[a-f0-9]{64}$",
            "type": "string"
          },
          "size_bytes": {
            "description": "Exact size_bytes returned by get_pdf_identity for the existing destination.",
            "minimum": 0,
            "type": "integer"
          }
        },
        "required": [
          "output_path",
          "canonical_path",
          "size_bytes",
          "sha256"
        ],
        "type": "object"
      },
      "maxItems": 1000,
      "type": "array"
    },
    "filename_column": {
      "description": "CSV column to use for output filenames (optional)",
      "type": "string"
    },
    "force_xfa": {
      "description": "Proceed even if the PDF is a DYNAMIC XFA form, whose pages are built from the XFA layer that saving drops (default: false). Static XFA needs no flag: its values live in the AcroForm and survive, and the result says the layer was removed.",
      "type": "boolean"
    },
    "output_directory": {
      "description": "Directory where filled PDFs will be saved",
      "type": "string"
    },
    "password": {
      "description": "Password for an encrypted PDF. Supply the user or owner password and the document is decrypted in memory, changed, and then saved with exactly the encryption and permissions it already had (encrypted inputs are limited to 16 MiB). The protection is never removed, changed, or added by this tool. Leave it unset for an unencrypted document. If the document's own permissions deny the change being made, the owner password is required, because that is the credential which authorises overriding them.",
      "type": "string"
    },
    "pdf_path": {
      "description": "Path to the template PDF file",
      "type": "string"
    }
  },
  "required": [
    "pdf_path",
    "csv_path",
    "output_directory"
  ],
  "type": "object"
}
sha256:fca74158277ad107d656eb1cfbf743df6cb35ca3078731a8ad05ea0fa6b72825

Output schema

{
  "anyOf": [
    {
      "additionalProperties": false,
      "properties": {
        "preview_records": {
          "items": {
            "additionalProperties": {
              "type": "string"
            },
            "type": "object"
          },
          "type": "array"
        },
        "results": {
          "items": {
            "additionalProperties": false,
            "properties": {
              "errors": {
                "items": {
                  "type": "string"
                },
                "type": "array"
              },
              "fields_filled": {
                "type": "integer"
              },
              "filename": {
                "type": "string"
              },
              "output_path": {
                "type": "string"
              },
              "status": {
                "enum": [
                  "ok",
                  "warning",
                  "error"
                ],
                "type": "string"
              }
            },
            "required": [
              "filename",
              "output_path",
              "fields_filled",
              "errors",
              "status"
            ],
            "type": "object"
          },
          "type": "array"
        },
        "row_count": {
          "type": "integer"
        }
      },
      "required": [
        "row_count",
        "results",
        "preview_records"
      ],
      "type": "object"
    },
    {
      "additionalProperties": false,
      "properties": {
        "error": {
          "additionalProperties": false,
          "properties": {
            "code": {
              "enum": [
                "internal_validation_error",
                "path_policy_denied",
                "tool_execution_failed"
              ],
              "type": "string"
            },
            "error_schema_version": {
              "const": 1
            }
          },
          "required": [
            "error_schema_version",
            "code"
          ],
          "type": "object"
        },
        "status": {
          "const": "failed"
        }
      },
      "required": [
        "status",
        "error"
      ],
      "type": "object"
    },
    {
      "additionalProperties": false,
      "properties": {
        "error": {
          "additionalProperties": false,
          "properties": {
            "code": {
              "const": "PDF_RESOURCE_LIMIT_EXCEEDED"
            },
            "error_schema_version": {
              "const": 1
            }
          },
          "required": [
            "error_schema_version",
            "code"
          ],
          "type": "object"
        },
        "status": {
          "const": "failed"
        }
      },
      "required": [
        "status",
        "error"
      ],
      "type": "object"
    }
  ],
  "type": "object"
}
sha256:551f3947966d3d8edd6871f55d8bfa65a47a00681f4f7f61bb505266f9b1ebd2

Description hash: sha256:fff847ecd56c045cb5345b0244146110a6dd85138273d909bec5f66ce8aedc40

Interface hash: sha256:c90d1d396bd844836172aae8002a681b88b30821e3f51c0758446099ed938cba

Other observed Modelara metadata
{
  "id": "mcp:pdf-tools/bulk_fill_from_csv",
  "title": "Bulk Fill PDFs from CSV",
  "source": {
    "type": "mcp",
    "server": "pdf-tools",
    "operation": "bulk_fill_from_csv"
  },
  "declared": {
    "read_only": "false",
    "destructive": "true",
    "idempotent": "true",
    "open_world": "false"
  },
  "safety": {
    "idempotent": "true",
    "retry_safe": "unknown"
  },
  "metadata": {
    "mcp.annotations": "present"
  },
  "fingerprint": "sha256:05adc0c8855f12c063924d64a3c2e9c45f8cc321a37fbff2fba5a00b8082cc9e"
}
tooldestructive0.12.10.14.0
check_lumin_statuspdf-toolkit:tool:check_lumin_status
Observed interface and hashes

Check an existing Lumin signing request and retain a local, digest-bound status observation. This cannot create or retry a signing request. A failed read may be retried safely.

Input schema

{
  "additionalProperties": false,
  "properties": {
    "authority_sha256": {
      "pattern": "^[a-f0-9]{64}$",
      "type": "string"
    },
    "authorization_session_id": {
      "type": "string"
    }
  },
  "required": [
    "authority_sha256",
    "authorization_session_id"
  ],
  "type": "object"
}
sha256:10b51a2cbfd3d6fca5e02280c39a1730bd6ac277bad13a76573489260781318c

Output schema

{
  "anyOf": [
    {
      "additionalProperties": false,
      "properties": {
        "access_token_persisted": {
          "const": false
        },
        "authority_sha256": {
          "pattern": "^[a-f0-9]{64}$",
          "type": "string"
        },
        "create_retry_allowed": {
          "const": false
        },
        "observation_sha256": {
          "pattern": "^[a-f0-9]{64}$",
          "type": "string"
        },
        "observed_at": {
          "type": "string"
        },
        "provider": {
          "const": "lumin_sign"
        },
        "provider_status": {
          "type": "string"
        },
        "read_retry_safe": {
          "const": true
        },
        "signature_request_id": {
          "type": "string"
        },
        "status": {
          "const": "observed"
        }
      },
      "required": [
        "status",
        "provider",
        "authority_sha256",
        "signature_request_id",
        "provider_status",
        "observed_at",
        "observation_sha256",
        "read_retry_safe",
        "create_retry_allowed",
        "access_token_persisted"
      ],
      "type": "object"
    },
    {
      "additionalProperties": false,
      "properties": {
        "error": {
          "additionalProperties": false,
          "properties": {
            "code": {
              "enum": [
                "internal_validation_error",
                "path_policy_denied",
                "tool_execution_failed"
              ],
              "type": "string"
            },
            "error_schema_version": {
              "const": 1
            }
          },
          "required": [
            "error_schema_version",
            "code"
          ],
          "type": "object"
        },
        "status": {
          "const": "failed"
        }
      },
      "required": [
        "status",
        "error"
      ],
      "type": "object"
    },
    {
      "additionalProperties": false,
      "properties": {
        "error": {
          "additionalProperties": false,
          "properties": {
            "code": {
              "pattern": "^LUMIN_[A-Z0-9_]+$",
              "type": "string"
            },
            "error_schema_version": {
              "const": 1
            }
          },
          "required": [
            "error_schema_version",
            "code"
          ],
          "type": "object"
        },
        "status": {
          "const": "failed"
        }
      },
      "required": [
        "status",
        "error"
      ],
      "type": "object"
    }
  ],
  "type": "object"
}
sha256:81e1272d316661457a097c6bbda353582fa70afd5c828162c43cd9dd9f909e44

Description hash: sha256:de54cc69b3338e99f0a85c51e16df2930b864c46cce35df88dc7b3110342d9bf

Interface hash: sha256:abddabbf79707d5e8493cf018cf77d30823580450280de55e46a9a5280b3c17d

Other observed Modelara metadata
{
  "id": "mcp:pdf-tools/check_lumin_status",
  "title": "Check Lumin Signing Status",
  "source": {
    "type": "mcp",
    "server": "pdf-tools",
    "operation": "check_lumin_status"
  },
  "declared": {
    "read_only": "false",
    "destructive": "false",
    "idempotent": "true",
    "open_world": "true"
  },
  "safety": {
    "idempotent": "true",
    "retry_safe": "true"
  },
  "metadata": {
    "mcp.annotations": "present"
  },
  "fingerprint": "sha256:785142f0cfe53f17998a55f95f9ad2ba386c98d7851dad75a90a12ba106760ed"
}
toolwrite0.14.00.14.0
compare_pdfspdf-toolkit:tool:compare_pdfs
Observed interface and hashes

Deterministically compare two complete bounded local PDFs through source-bound parser observations, Extraction IR text geometry, forms, ordinary annotations, metadata, and optional raw-RGBA visual evidence. Page alignment never guesses across unresolved repeated-page ambiguity. Default mode suppresses only typed presentation noise while retaining every detected change. A no-reported-changes result is never an equivalence claim and is emitted only when every requested channel is supported and complete. Both inputs are re-hashed after comparison and any source mutation discards all claims. No links or actions are followed and no network access or persistent output is used.

Input schema

{
  "additionalProperties": false,
  "properties": {
    "after_password": {
      "description": "Optional password for the later PDF. Password for encrypted PDFs. PDF.js uses it, but this operation also loads page geometry with pdf-lib, which cannot decrypt PDFs, so an encrypted document still fails with the correct password.",
      "maxLength": 4096,
      "type": "string"
    },
    "after_pdf_path": {
      "description": "Absolute path to the later PDF.",
      "type": "string"
    },
    "before_password": {
      "description": "Optional password for the earlier PDF. Password for encrypted PDFs. PDF.js uses it, but this operation also loads page geometry with pdf-lib, which cannot decrypt PDFs, so an encrypted document still fails with the correct password.",
      "maxLength": 4096,
      "type": "string"
    },
    "before_pdf_path": {
      "description": "Absolute path to the earlier PDF.",
      "type": "string"
    },
    "include_visual": {
      "description": "Request canonical raw-pixel visual comparison. Default: true.",
      "type": "boolean"
    },
    "max_output_characters": {
      "description": "Maximum serialized structured-output characters. Default: 100000.",
      "maximum": 200000,
      "minimum": 20000,
      "type": "integer"
    },
    "max_pages": {
      "description": "Whole-document page ceiling for each input. Default: 10.",
      "maximum": 20,
      "minimum": 1,
      "type": "integer"
    },
    "mode": {
      "description": "Presentation mode. Default: default_material.",
      "enum": [
        "default_material",
        "forensic"
      ],
      "type": "string"
    }
  },
  "required": [
    "before_pdf_path",
    "after_pdf_path"
  ],
  "type": "object"
}
sha256:e8741ffac204e9105da3b130c99888593dc34499a381f8c8edcd1c2062a02e72

Output schema

{
  "anyOf": [
    {
      "additionalProperties": false,
      "properties": {
        "after_source": {
          "additionalProperties": false,
          "properties": {
            "canonical_path": {
              "type": "string"
            },
            "file_name": {
              "type": "string"
            },
            "identity_method": {
              "const": "race_aware_descriptor_sha256"
            },
            "observation_sha256": {
              "pattern": "^[a-f0-9]{64}$",
              "type": "string"
            },
            "page_count": {
              "type": "integer"
            },
            "parser": {
              "additionalProperties": false,
              "properties": {
                "name": {
                  "const": "pdfjs-dist"
                },
                "version": {
                  "const": "5.4.624"
                }
              },
              "required": [
                "name",
                "version"
              ],
              "type": "object"
            },
            "sha256": {
              "pattern": "^[a-f0-9]{64}$",
              "type": "string"
            },
            "size_bytes": {
              "type": "integer"
            }
          },
          "required": [
            "canonical_path",
            "file_name",
            "size_bytes",
            "sha256",
            "page_count",
            "identity_method",
            "parser",
            "observation_sha256"
          ],
          "type": "object"
        },
        "before_source": {
          "additionalProperties": false,
          "properties": {
            "canonical_path": {
              "type": "string"
            },
            "file_name": {
              "type": "string"
            },
            "identity_method": {
              "const": "race_aware_descriptor_sha256"
            },
            "observation_sha256": {
              "pattern": "^[a-f0-9]{64}$",
              "type": "string"
            },
            "page_count": {
              "type": "integer"
            },
            "parser": {
              "additionalProperties": false,
              "properties": {
                "name": {
                  "const": "pdfjs-dist"
                },
                "version": {
                  "const": "5.4.624"
                }
              },
              "required": [
                "name",
                "version"
              ],
              "type": "object"
            },
            "sha256": {
              "pattern": "^[a-f0-9]{64}$",
              "type": "string"
            },
            "size_bytes": {
              "type": "integer"
            }
          },
          "required": [
            "canonical_path",
            "file_name",
            "size_bytes",
            "sha256",
            "page_count",
            "identity_method",
            "parser",
            "observation_sha256"
          ],
          "type": "object"
        },
        "changes": {
          "items": {
            "additionalProperties": false,
            "properties": {
              "facets": {
                "items": {
                  "additionalProperties": false,
                  "properties": {
                    "after_evidence_id": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "before_evidence_id": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "channel": {
                      "enum": [
                        "semantic",
                        "text",
                        "structure",
                        "form_field",
                        "annotation",
                        "metadata",
                        "visual"
                      ],
                      "type": "string"
                    },
                    "operation": {
                      "enum": [
                        "added",
                        "removed",
                        "modified",
                        "moved"
                      ],
                      "type": "string"
                    }
                  },
                  "required": [
                    "channel",
                    "operation",
                    "before_evidence_id",
                    "after_evidence_id"
                  ],
                  "type": "object"
                },
                "type": "array"
              },
              "id": {
                "pattern": "^change\\.[0-9]{6}$",
                "type": "string"
              },
              "kind": {
                "enum": [
                  "semantic_text",
                  "text",
                  "structure",
                  "form_field",
                  "widget",
                  "annotation",
                  "metadata",
                  "visual"
                ],
                "type": "string"
              },
              "operation": {
                "enum": [
                  "added",
                  "removed",
                  "modified",
                  "moved"
                ],
                "type": "string"
              },
              "presentation": {
                "additionalProperties": false,
                "properties": {
                  "disposition": {
                    "enum": [
                      "report",
                      "suppress"
                    ],
                    "type": "string"
                  },
                  "mode": {
                    "enum": [
                      "default_material",
                      "forensic"
                    ],
                    "type": "string"
                  },
                  "reversible_reason_code": {
                    "anyOf": [
                      {
                        "type": "string"
                      },
                      {
                        "type": "null"
                      }
                    ]
                  }
                },
                "required": [
                  "mode",
                  "disposition",
                  "reversible_reason_code"
                ],
                "type": "object"
              },
              "salience": {
                "enum": [
                  "material",
                  "minor",
                  "noise",
                  "unknown"
                ],
                "type": "string"
              },
              "summary": {
                "type": "string"
              }
            },
            "required": [
              "id",
              "kind",
              "operation",
              "salience",
              "summary",
              "facets",
              "presentation"
            ],
            "type": "object"
          },
          "type": "array"
        },
        "comparison_sha256": {
          "pattern": "^[a-f0-9]{64}$",
          "type": "string"
        },
        "coverage": {
          "additionalProperties": false,
          "properties": {
            "annotation": {
              "additionalProperties": false,
              "properties": {
                "reason_codes": {
                  "items": {
                    "type": "string"
                  },
                  "type": "array"
                },
                "status": {
                  "enum": [
                    "supported",
                    "partial",
                    "unavailable"
                  ],
                  "type": "string"
                }
              },
              "required": [
                "status",
                "reason_codes"
              ],
              "type": "object"
            },
            "form_field": {
              "additionalProperties": false,
              "properties": {
                "reason_codes": {
                  "items": {
                    "type": "string"
                  },
                  "type": "array"
                },
                "status": {
                  "enum": [
                    "supported",
                    "partial",
                    "unavailable"
                  ],
                  "type": "string"
                }
              },
              "required": [
                "status",
                "reason_codes"
              ],
              "type": "object"
            },
            "metadata": {
              "additionalProperties": false,
              "properties": {
                "reason_codes": {
                  "items": {
                    "type": "string"
                  },
                  "type": "array"
                },
                "status": {
                  "enum": [
                    "supported",
                    "partial",
                    "unavailable"
                  ],
                  "type": "string"
                }
              },
              "required": [
                "status",
                "reason_codes"
              ],
              "type": "object"
            },
            "semantic": {
              "additionalProperties": false,
              "properties": {
                "reason_codes": {
                  "items": {
                    "type": "string"
                  },
                  "type": "array"
                },
                "status": {
                  "enum": [
                    "supported",
                    "partial",
                    "unavailable"
                  ],
                  "type": "string"
                }
              },
              "required": [
                "status",
                "reason_codes"
              ],
              "type": "object"
            },
            "structure": {
              "additionalProperties": false,
              "properties": {
                "reason_codes": {
                  "items": {
                    "type": "string"
                  },
                  "type": "array"
                },
                "status": {
                  "enum": [
                    "supported",
                    "partial",
                    "unavailable"
                  ],
                  "type": "string"
                }
              },
              "required": [
                "status",
                "reason_codes"
              ],
              "type": "object"
            },
            "text": {
              "additionalProperties": false,
              "properties": {
                "reason_codes": {
                  "items": {
                    "type": "string"
                  },
                  "type": "array"
                },
                "status": {
                  "enum": [
                    "supported",
                    "partial",
                    "unavailable"
                  ],
                  "type": "string"
                }
              },
              "required": [
                "status",
                "reason_codes"
              ],
              "type": "object"
            },
            "visual": {
              "additionalProperties": false,
              "properties": {
                "reason_codes": {
                  "items": {
                    "type": "string"
                  },
                  "type": "array"
                },
                "status": {
                  "enum": [
                    "supported",
                    "partial",
                    "unavailable"
                  ],
                  "type": "string"
                }
              },
              "required": [
                "status",
                "reason_codes"
              ],
              "type": "object"
            }
          },
          "required": [
            "semantic",
            "text",
            "structure",
            "form_field",
            "annotation",
            "metadata",
            "visual"
          ],
          "type": "object"
        },
        "engine": {
          "additionalProperties": false,
          "properties": {
            "alignment_policy": {
              "const": "pdf-tools.page-alignment.v1"
            },
            "name": {
              "const": "pdf-tools.deterministic-comparison"
            },
            "parser": {
              "additionalProperties": false,
              "properties": {
                "name": {
                  "const": "pdfjs-dist"
                },
                "version": {
                  "const": "5.4.624"
                }
              },
              "required": [
                "name",
                "version"
              ],
              "type": "object"
            },
            "presentation_policy": {
              "const": "pdf-tools.material-presentation.v1"
            },
            "renderer": {
              "additionalProperties": false,
              "properties": {
                "connected_components": {
                  "const": 8
                },
                "mask_dilation_pixels": {
                  "const": 1
                },
                "minimum_component_area_pixels": {
                  "const": 4
                },
                "name": {
                  "const": "native-canvas"
                },
                "pixel_delta_threshold": {
                  "const": 8
                },
                "resizing": {
                  "const": false
                },
                "scale": {
                  "const": 1.5
                }
              },
              "required": [
                "name",
                "scale",
                "pixel_delta_threshold",
                "mask_dilation_pixels",
                "connected_components",
                "minimum_component_area_pixels",
                "resizing"
              ],
              "type": "object"
            },
            "text_policy": {
              "const": "pdf-tools.extraction-ir-lines.v1"
            },
            "version": {
              "const": "0.2.0"
            },
            "visual_policy": {
              "const": "pdf-tools.rgba-delta.v1"
            }
          },
          "required": [
            "name",
            "version",
            "parser",
            "renderer",
            "alignment_policy",
            "text_policy",
            "visual_policy",
            "presentation_policy"
          ],
          "type": "object"
        },
        "limitations": {
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        "mode": {
          "enum": [
            "default_material",
            "forensic"
          ],
          "type": "string"
        },
        "observations": {
          "items": {
            "additionalProperties": false,
            "properties": {
              "canonical_value": {},
              "channel": {
                "enum": [
                  "semantic",
                  "text",
                  "structure",
                  "form_field",
                  "annotation",
                  "metadata",
                  "visual"
                ],
                "type": "string"
              },
              "coordinate_space": {
                "const": "pdfjs_viewport_top_left_points"
              },
              "display_region": {
                "items": {
                  "type": "number"
                },
                "maxItems": 4,
                "minItems": 4,
                "type": "array"
              },
              "document_sha256": {
                "pattern": "^[a-f0-9]{64}$",
                "type": "string"
              },
              "id": {
                "pattern": "^evidence\\.[a-z_]+\\.[0-9]{6}$",
                "type": "string"
              },
              "native_region": {
                "anyOf": [
                  {
                    "items": {
                      "type": "number"
                    },
                    "maxItems": 4,
                    "minItems": 4,
                    "type": "array"
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "observation_sha256": {
                "pattern": "^[a-f0-9]{64}$",
                "type": "string"
              },
              "page": {
                "type": "integer"
              },
              "page_box": {
                "items": {
                  "type": "number"
                },
                "maxItems": 4,
                "minItems": 4,
                "type": "array"
              },
              "raw_result_sha256": {
                "pattern": "^[a-f0-9]{64}$",
                "type": "string"
              },
              "rotation": {
                "type": "number"
              },
              "side": {
                "enum": [
                  "before",
                  "after"
                ],
                "type": "string"
              },
              "value_sha256": {
                "pattern": "^[a-f0-9]{64}$",
                "type": "string"
              }
            },
            "required": [
              "id",
              "channel",
              "side",
              "document_sha256",
              "page",
              "page_box",
              "rotation",
              "coordinate_space",
              "native_region",
              "display_region",
              "canonical_value",
              "value_sha256",
              "raw_result_sha256",
              "observation_sha256"
            ],
            "type": "object"
          },
          "type": "array"
        },
        "page_alignments": {
          "items": {
            "additionalProperties": false,
            "properties": {
              "after_page": {
                "anyOf": [
                  {
                    "type": "integer"
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "ambiguity_group": {
                "anyOf": [
                  {
                    "type": "string"
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "anchor_digest": {
                "pattern": "^[a-f0-9]{64}$",
                "type": "string"
              },
              "before_page": {
                "anyOf": [
                  {
                    "type": "integer"
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "match_basis": {
                "enum": [
                  "exact_composite_anchor",
                  "unique_normalized_text",
                  "weighted_assignment",
                  "repeated_ambiguous",
                  "unmatched"
                ],
                "type": "string"
              },
              "relation": {
                "enum": [
                  "same",
                  "moved",
                  "inserted",
                  "deleted"
                ],
                "type": "string"
              },
              "score": {
                "type": "number"
              }
            },
            "required": [
              "before_page",
              "after_page",
              "relation",
              "anchor_digest",
              "match_basis",
              "score",
              "ambiguity_group"
            ],
            "type": "object"
          },
          "type": "array"
        },
        "resource_usage": {
          "additionalProperties": false,
          "properties": {
            "aligned_page_visual_comparisons_completed": {
              "type": "integer"
            },
            "aligned_page_visual_comparisons_requested": {
              "type": "integer"
            },
            "duration_ms": {
              "type": "number"
            },
            "external_persistence_writes": {
              "const": 0
            },
            "network_requests": {
              "const": 0
            },
            "rendered_pixels": {
              "type": "integer"
            },
            "source_bytes": {
              "type": "integer"
            }
          },
          "required": [
            "duration_ms",
            "source_bytes",
            "rendered_pixels",
            "aligned_page_visual_comparisons_requested",
            "aligned_page_visual_comparisons_completed",
            "network_requests",
            "external_persistence_writes"
          ],
          "type": "object"
        },
        "schema_version": {
          "const": "1.1"
        },
        "source_immutability": {
          "additionalProperties": false,
          "properties": {
            "after": {
              "additionalProperties": false,
              "properties": {
                "final_sha256": {
                  "pattern": "^[a-f0-9]{64}$",
                  "type": "string"
                },
                "final_size_bytes": {
                  "type": "integer"
                },
                "initial_sha256": {
                  "pattern": "^[a-f0-9]{64}$",
                  "type": "string"
                },
                "initial_size_bytes": {
                  "type": "integer"
                },
                "unchanged": {
                  "const": true
                }
              },
              "required": [
                "initial_sha256",
                "final_sha256",
                "initial_size_bytes",
                "final_size_bytes",
                "unchanged"
              ],
              "type": "object"
            },
            "before": {
              "additionalProperties": false,
              "properties": {
                "final_sha256": {
                  "pattern": "^[a-f0-9]{64}$",
                  "type": "string"
                },
                "final_size_bytes": {
                  "type": "integer"
                },
                "initial_sha256": {
                  "pattern": "^[a-f0-9]{64}$",
                  "type": "string"
                },
                "initial_size_bytes": {
                  "type": "integer"
                },
                "unchanged": {
                  "const": true
                }
              },
              "required": [
                "initial_sha256",
                "final_sha256",
                "initial_size_bytes",
                "final_size_bytes",
                "unchanged"
              ],
              "type": "object"
            }
          },
          "required": [
            "before",
            "after"
          ],
          "type": "object"
        },
        "status": {
          "enum": [
            "complete",
            "partial"
          ],
          "type": "string"
        },
        "summary": {
          "additionalProperties": false,
          "properties": {
            "detected_change_count": {
              "type": "integer"
            },
            "equivalence_claim": {
              "const": false
            },
            "no_reported_changes": {
              "type": "boolean"
            },
            "reported_change_count": {
              "type": "integer"
            },
            "suppressed_change_count": {
              "type": "integer"
            }
          },
          "required": [
            "detected_change_count",
            "reported_change_count",
            "suppressed_change_count",
            "no_reported_changes",
            "equivalence_claim"
          ],
          "type": "object"
        }
      },
      "required": [
        "schema_version",
        "engine",
        "status",
        "mode",
        "before_source",
        "after_source",
        "source_immutability",
        "coverage",
        "page_alignments",
        "observations",
        "changes",
        "summary",
        "limitations",
        "resource_usage",
        "comparison_sha256"
      ],
      "type": "object"
    },
    {
      "additionalProperties": false,
      "properties": {
        "error": {
          "additionalProperties": false,
          "properties": {
            "code": {
              "enum": [
                "internal_validation_error",
                "path_policy_denied",
                "tool_execution_failed"
              ],
              "type": "string"
            },
            "error_schema_version": {
              "const": 1
            }
          },
          "required": [
            "error_schema_version",
            "code"
          ],
          "type": "object"
        },
        "status": {
          "const": "failed"
        }
      },
      "required": [
        "status",
        "error"
      ],
      "type": "object"
    },
    {
      "additionalProperties": false,
      "properties": {
        "error": {
          "additionalProperties": false,
          "properties": {
            "code": {
              "enum": [
                "PASSWORD_REQUIRED",
                "PASSWORD_INCORRECT"
              ],
              "type": "string"
            },
            "error_schema_version": {
              "const": 1
            }
          },
          "required": [
            "error_schema_version",
            "code"
          ],
          "type": "object"
        },
        "status": {
          "const": "failed"
        }
      },
      "required": [
        "status",
        "error"
      ],
      "type": "object"
    },
    {
      "additionalProperties": false,
      "properties": {
        "error": {
          "additionalProperties": false,
          "properties": {
            "code": {
              "const": "PDF_RESOURCE_LIMIT_EXCEEDED"
            },
            "error_schema_version": {
              "const": 1
            }
          },
          "required": [
            "error_schema_version",
            "code"
          ],
          "type": "object"
        },
        "status": {
          "const": "failed"
        }
      },
      "required": [
        "status",
        "error"
      ],
      "type": "object"
    },
    {
      "additionalProperties": false,
      "properties": {
        "error": {
          "additionalProperties": false,
          "properties": {
            "code": {
              "enum": [
                "PDF_CHANGED_DURING_READ",
                "PDF_INPUT_TOO_LARGE",
                "PDF_INVALID_HEADER",
                "PDF_UNAVAILABLE"
              ],
              "type": "string"
            },
            "error_schema_version": {
              "const": 1
            }
          },
          "required": [
            "error_schema_version",
            "code"
          ],
          "type": "object"
        },
        "status": {
          "const": "failed"
        }
      },
      "required": [
        "status",
        "error"
      ],
      "type": "object"
    },
    {
      "additionalProperties": false,
      "properties": {
        "error": {
          "additionalProperties": false,
          "properties": {
            "code": {
              "enum": [
                "COMPARISON_OUTPUT_LIMIT_EXCEEDED",
                "COMPARISON_PAGE_LIMIT_EXCEEDED",
                "COMPARISON_SOURCE_BINDING_MISMATCH",
                "COMPARISON_SOURCE_CHANGED",
                "PDF_ENCRYPTED_COMPARISON_UNSUPPORTED",
                "PDF_PARSE_FAILED",
                "invalid_input"
              ],
              "type": "string"
            },
            "error_schema_version": {
              "const": 1
            }
          },
          "required": [
            "error_schema_version",
            "code"
          ],
          "type": "object"
        },
        "status": {
          "const": "failed"
        }
      },
      "required": [
        "status",
        "error"
      ],
      "type": "object"
    }
  ],
  "type": "object"
}
sha256:facb66f9afd5807687d18248e6efcd8c56302e35aecbc12ec2298edcac4c60d5

Description hash: sha256:5f5f1a23e24b8c34c37d72daeafbe6f977dd9766e34f5a789893501a65221056

Interface hash: sha256:8c26b7dcecf99fe4af620ba3c9d72a387bd44170657ec23efef89bf9204b5378

Other observed Modelara metadata
{
  "id": "mcp:pdf-tools/compare_pdfs",
  "title": "Compare PDFs",
  "source": {
    "type": "mcp",
    "server": "pdf-tools",
    "operation": "compare_pdfs"
  },
  "declared": {
    "read_only": "true",
    "destructive": "false",
    "idempotent": "true",
    "open_world": "false"
  },
  "safety": {
    "idempotent": "true",
    "retry_safe": "true"
  },
  "metadata": {
    "mcp.annotations": "present"
  },
  "fingerprint": "sha256:ed64189847d73890e927fecdfbc1889fb5e496fb5b03fb970d44ddb85ccc93db"
}
toolread0.12.10.14.0
convert_pdf_to_markdownpdf-toolkit:tool:convert_pdf_to_markdown
Observed interface and hashes

Convert 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

{
  "additionalProperties": false,
  "properties": {
    "compact": {
      "description": "Opt into counted dot-leader, isolated page-number, and Unicode-letter spaced-hyphen normalizations. Default: false.",
      "type": "boolean"
    },
    "emit_table_proposals": {
      "description": "Opt into emitting one bounded, deterministic table_proposals packet per abandoned table region (TABLE_TOPOLOGY_UNKNOWN or TABLE_RULING_UNSUPPORTED), carrying the region's text items, ruled and painted evidence, header hints, page, bbox, coordinate_space, and a source-and-IR-bound proposal_token so a host model can propose a structure for later read-only verification. Additive: the abstention gap is unchanged and default output stays byte-identical. Default: false.",
      "type": "boolean"
    },
    "end_page": {
      "description": "Last page to convert, inclusive. Default: start_page. At most 10 pages per call.",
      "minimum": 1,
      "type": "integer"
    },
    "expected_output_identity": {
      "additionalProperties": false,
      "description": "Exact current identity of the existing .md output_path: canonical path, byte length, and SHA-256. get_pdf_identity cannot supply it, because it requires a PDF header; the convert_pdf_to_markdown result that wrote the file reports these values as saved_output.path, saved_output.bytes, and saved_output.sha256. Required with overwrite=true; omit it for a new destination.",
      "properties": {
        "canonical_path": {
          "description": "Exact canonical path of the existing destination, as reported in saved_output.path.",
          "type": "string"
        },
        "sha256": {
          "description": "Exact SHA-256 of the existing destination, as reported in saved_output.sha256.",
          "pattern": "^[a-f0-9]{64}$",
          "type": "string"
        },
        "size_bytes": {
          "description": "Exact byte length of the existing destination, as reported in saved_output.bytes.",
          "minimum": 0,
          "type": "integer"
        }
      },
      "required": [
        "canonical_path",
        "size_bytes",
        "sha256"
      ],
      "type": "object"
    },
    "include_page_boundaries": {
      "description": "Include deterministic HTML comments marking page boundaries. Default: true.",
      "type": "boolean"
    },
    "max_characters": {
      "description": "Maximum retained PDF text characters across the requested range. Default: 50000.",
      "maximum": 100000,
      "minimum": 1,
      "type": "integer"
    },
    "max_items": {
      "description": "Maximum retained PDF text items across the requested range. Default: 1000.",
      "maximum": 5000,
      "minimum": 1,
      "type": "integer"
    },
    "max_markdown_bytes": {
      "description": "Maximum UTF-8 Markdown bytes. The conversion fails rather than cutting a line or Unicode sequence. Default: 50000.",
      "maximum": 200000,
      "minimum": 256,
      "type": "integer"
    },
    "output_path": {
      "description": "Optional absolute .md path, or ~/ path. The file is written only after complete bytes are staged and verified.",
      "type": "string"
    },
    "overwrite": {
      "description": "Replace an existing output_path only when its exact expected_output_identity is also supplied. Default: false.",
      "type": "boolean"
    },
    "password": {
      "description": "Password for an encrypted PDF, when required.",
      "type": "string"
    },
    "pdf_path": {
      "description": "Absolute path to the local PDF file.",
      "type": "string"
    },
    "remove_page_furniture": {
      "description": "Remove only source-evidenced extreme-margin page furniture and report every removed line by typed gap and counts. Set false to preserve all source lines. Default: true.",
      "type": "boolean"
    },
    "start_page": {
      "description": "First page to convert, 1-indexed. Default: 1.",
      "minimum": 1,
      "type": "integer"
    }
  },
  "required": [
    "pdf_path"
  ],
  "type": "object"
}
sha256:6cc53ac5a2934bdd76d7c2f2b6c20b2ad6de721e358f264e35d90eeaebfc8bfb

Output schema

{
  "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_REACHED",
                  "SOURCE_CHARACTER_LIMIT_REACHED",
                  "TEXT_LAYER_FAILED",
                  "TEXT_LAYER_EMPTY",
                  "OCR_NOT_PERFORMED",
                  "PAGE_FURNITURE_REMOVED",
                  "IMAGE_CONTENT_NOT_RENDERED",
                  "VECTOR_CONTENT_NOT_INTERPRETED",
                  "RAW_PAGE_GEOMETRY_UNAVAILABLE",
                  "INVALID_TEXT_GEOMETRY",
                  "LINK_ANNOTATIONS_UNAVAILABLE",
                  "LINK_MAPPING_AMBIGUOUS",
                  "UNSUPPORTED_LINK_TARGET",
                  "TABLE_RULING_UNSUPPORTED",
                  "TABLE_TOPOLOGY_UNKNOWN",
                  "TEXT_INTEGRITY_SUSPECT",
                  "MATH_NOT_RECONSTRUCTED",
                  "CONTROL_CHARACTERS_SANITIZED"
                ],
                "type": "string"
              },
              "message": {
                "type": "string"
              },
              "page": {
                "anyOf": [
                  {
                    "type": "integer"
                  },
                  {
                    "type": "null"
                  }
                ]
              }
            },
            "required": [
              "code",
              "page",
              "message"
            ],
            "type": "object"
          },
          "type": "array"
        },
        "limitations": {
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        "limits": {
          "additionalProperties": false,
          "properties": {
            "max_markdown_bytes": {
              "maximum": 200000,
              "minimum": 1,
              "type": "integer"
            }
          },
          "required": [
            "max_markdown_bytes"
          ],
          "type": "object"
        },
        "markdown": {
          "type": "string"
        },
        "markdown_bytes": {
          "minimum": 0,
          "type": "integer"
        },
        "markdown_sha256": {
          "pattern": "^[a-f0-9]{64}$",
          "type": "string"
        },
        "normalizations": {
          "additionalProperties": false,
          "properties": {
            "dot_leaders_collapsed": {
              "minimum": 0,
              "type": "integer"
            },
            "normalized_pages": {
              "items": {
                "type": "integer"
              },
              "type": "array"
            },
            "page_furniture_characters_removed": {
              "minimum": 0,
              "type": "integer"
            },
            "page_furniture_pages": {
              "items": {
                "type": "integer"
              },
              "type": "array"
            },
            "page_number_lines_removed": {
              "minimum": 0,
              "type": "integer"
            },
            "running_footer_lines_removed": {
              "minimum": 0,
              "type": "integer"
            },
            "running_header_lines_removed": {
              "minimum": 0,
              "type": "integer"
            },
            "spaced_hyphens_joined": {
              "minimum": 0,
              "type": "integer"
            }
          },
          "required": [
            "dot_leaders_collapsed",
            "page_number_lines_removed",
            "running_header_lines_removed",
            "running_footer_lines_removed",
            "page_furniture_characters_removed",
            "page_furniture_pages",
            "spaced_hyphens_joined",
            "normalized_pages"
          ],
          "type": "object"
        },
        "options": {
          "additionalProperties": false,
          "properties": {
            "compact": {
              "type": "boolean"
            },
            "include_page_boundaries": {
              "type": "boolean"
            },
            "remove_page_furniture": {
              "type": "boolean"
            }
          },
          "required": [
            "include_page_boundaries",
            "compact",
            "remove_page_furniture"
          ],
          "type": "object"
        },
        "pages": {
          "items": {
            "additionalProperties": false,
            "properties": {
              "conversion_status": {
                "enum": [
                  "complete",
                  "partial",
                  "failed"
                ],
                "type": "string"
              },
              "gaps": {
                "items": {
                  "additionalProperties": false,
                  "properties": {
                    "code": {
                      "enum": [
                        "PAGE_RANGE_INCOMPLETE",
                        "SOURCE_ITEM_LIMIT_REACHED",
                        "SOURCE_CHARACTER_LIMIT_REACHED",
                        "TEXT_LAYER_FAILED",
                        "TEXT_LAYER_EMPTY",
                        "OCR_NOT_PERFORMED",
                        "PAGE_FURNITURE_REMOVED",
                        "IMAGE_CONTENT_NOT_RENDERED",
                        "VECTOR_CONTENT_NOT_INTERPRETED",
                        "RAW_PAGE_GEOMETRY_UNAVAILABLE",
                        "INVALID_TEXT_GEOMETRY",
                        "LINK_ANNOTATIONS_UNAVAILABLE",
                        "LINK_MAPPING_AMBIGUOUS",
                        "UNSUPPORTED_LINK_TARGET",
                        "TABLE_RULING_UNSUPPORTED",
                        "TABLE_TOPOLOGY_UNKNOWN",
                        "TEXT_INTEGRITY_SUSPECT",
                        "MATH_NOT_RECONSTRUCTED",
                        "CONTROL_CHARACTERS_SANITIZED"
                      ],
                      "type": "string"
                    },
                    "message": {
                      "type": "string"
                    },
                    "page": {
                      "anyOf": [
                        {
                          "type": "integer"
                        },
                        {
                          "type": "null"
                        }
                      ]
                    }
                  },
                  "required": [
                    "code",
                    "page",
                    "message"
                  ],
                  "type": "object"
                },
                "type": "array"
              },
              "line_count": {
                "minimum": 0,
                "type": "integer"
              },
              "markdown_bytes": {
                "minimum": 0,
                "type": "integer"
              },
              "page": {
                "minimum": 1,
                "type": "integer"
              },
              "rendered_line_count": {
                "minimum": 0,
                "type": "integer"
              }
            },
            "required": [
              "page",
              "conversion_status",
              "markdown_bytes",
              "line_count",
              "rendered_line_count",
              "gaps"
            ],
            "type": "object"
          },
          "type": "array"
        },
        "pages_needing_vision": {
          "items": {
            "additionalProperties": false,
            "properties": {
              "page": {
                "type": "integer"
              },
              "reasons": {
                "items": {
                  "enum": [
                    "invisible_text_layer",
                    "text_visibility_unavailable",
                    "no_text_layer",
                    "image_dominated",
                    "vector_only_text",
                    "suspected_text_integrity",
                    "analysis_unavailable"
                  ],
                  "type": "string"
                },
                "type": "array"
              }
            },
            "required": [
              "page",
              "reasons"
            ],
            "type": "object"
          },
          "type": "array"
        },
        "provenance": {
          "additionalProperties": false,
          "properties": {
            "layout": {
              "additionalProperties": false,
              "properties": {
                "name": {
                  "const": "pdf-tools.extraction-ir"
                },
                "page_range": {
                  "additionalProperties": false,
                  "properties": {
                    "end_page": {
                      "type": "integer"
                    },
                    "start_page": {
                      "type": "integer"
                    },
                    "total_pages": {
                      "type": "integer"
                    }
                  },
                  "required": [
                    "start_page",
                    "end_page",
                    "total_pages"
                  ],
                  "type": "object"
                },
                "parser_name": {
                  "const": "pdfjs-dist"
                },
                "parser_version": {
                  "const": "5.4.624"
                },
                "version": {
                  "const": "1.6.0"
                }
              },
              "required": [
                "name",
                "version",
                "parser_name",
                "parser_version",
                "page_range"
              ],
              "type": "object"
            },
            "source": {
              "additionalProperties": false,
              "properties": {
                "file_name": {
                  "type": "string"
                },
                "sha256": {
                  "pattern": "^[a-f0-9]{64}$",
                  "type": "string"
                },
                "size_bytes": {
                  "type": "integer"
                }
              },
              "required": [
                "file_name",
                "sha256",
                "size_bytes"
              ],
              "type": "object"
            }
          },
          "required": [
            "source",
            "layout"
          ],
          "type": "object"
        },
        "renderer": {
          "additionalProperties": false,
          "properties": {
            "name": {
              "const": "pdf-tools.layout-markdown-renderer"
            },
            "version": {
              "const": "1.21.0"
            }
          },
          "required": [
            "name",
            "version"
          ],
          "type": "object"
        },
        "saved_output": {
          "anyOf": [
            {
              "additionalProperties": false,
              "properties": {
                "bytes": {
                  "minimum": 0,
                  "type": "integer"
                },
                "commit_method": {
                  "const": "same_directory_atomic"
                },
                "encoding": {
                  "const": "utf-8"
                },
                "overwritten": {
                  "type": "boolean"
                },
                "path": {
                  "type": "string"
                },
                "reopened_verified": {
                  "const": true
                },
                "sha256": {
                  "pattern": "^[a-f0-9]{64}$",
                  "type": "string"
                }
              },
              "required": [
                "path",
                "encoding",
                "bytes",
                "sha256",
                "commit_method",
                "reopened_verified",
                "overwritten"
              ],
              "type": "object"
            },
            {
              "type": "null"
            }
          ]
        },
        "table_proposals": {
          "items": {
            "additionalProperties": false,
            "properties": {
              "bbox": {
                "additionalProperties": false,
                "properties": {
                  "height": {
                    "type": "number"
                  },
                  "width": {
                    "type": "number"
                  },
                  "x": {
                    "type": "number"
                  },
                  "y": {
                    "type": "number"
                  }
                },
                "required": [
                  "x",
                  "y",
                  "width",
                  "height"
                ],
                "type": "object"
              },
              "coordinate_space": {
                "const": "pdfjs_viewport_top_left_points"
              },
              "header_hints": {
                "additionalProperties": false,
                "properties": {
                  "body_median_height": {
                    "anyOf": [
                      {
                        "type": "number"
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "first_row_band": {
                    "enum": [
                      "taller_than_body",
                      "not_distinguished",
                      "unavailable"
                    ],
                    "type": "string"
                  },
                  "first_row_height": {
                    "anyOf": [
                      {
                        "type": "number"
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "status": {
                    "enum": [
                      "available",
                      "unavailable"
                    ],
                    "type": "string"
                  }
                },
                "required": [
                  "status",
                  "first_row_height",
                  "body_median_height",
                  "first_row_band"
                ],
                "type": "object"
              },
              "page": {
                "minimum": 1,
                "type": "integer"
              },
              "painted_rectangles": {
                "items": {
                  "additionalProperties": false,
                  "properties": {
                    "bbox": {
                      "additionalProperties": false,
                      "properties": {
                        "height": {
                          "type": "number"
                        },
                        "width": {
                          "type": "number"
                        },
                        "x": {
                          "type": "number"
                        },
                        "y": {
                          "type": "number"
                        }
                      },
                      "required": [
                        "x",
                        "y",
                        "width",
                        "height"
                      ],
                      "type": "object"
                    },
                    "id": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "id",
                    "bbox"
                  ],
                  "type": "object"
                },
                "type": "array"
              },
              "proposal_token": {
                "pattern": "^[a-f0-9]{64}$",
                "type": "string"
              },
              "reason": {
                "enum": [
                  "TABLE_TOPOLOGY_UNKNOWN",
                  "TABLE_RULING_UNSUPPORTED"
                ],
                "type": "string"
              },
              "region_id": {
                "pattern": "^p[0-9]+-t[0-9]+$",
                "type": "string"
              },
              "ruled_rects": {
                "items": {
                  "additionalProperties": false,
                  "properties": {
                    "height": {
                      "type": "number"
                    },
                    "verb": {
                      "enum": [
                        "fill",
                        "stroke",
                        "clip",
                        "none"
                      ],
                      "type": "string"
                    },
                    "width": {
                      "type": "number"
                    },
                    "x": {
                      "type": "number"
                    },
                    "y": {
                      "type": "number"
                    }
                  },
                  "required": [
                    "x",
                    "y",
                    "width",
                    "height",
                    "verb"
                  ],
                  "type": "object"
                },
                "type": "array"
              },
              "ruling_segments": {
                "items": {
                  "additionalProperties": false,
                  "properties": {
                    "orientation": {
                      "enum": [
                        "horizontal",
                        "vertical"
                      ],
                      "type": "string"
                    },
                    "source_operator_index": {
                      "minimum": 0,
                      "type": "integer"
                    },
                    "x1": {
                      "type": "number"
                    },
                    "x2": {
                      "type": "number"
                    },
                    "y1": {
                      "type": "number"
                    },
                    "y2": {
                      "type": "number"
                    }
                  },
                  "required": [
                    "orientation",
                    "x1",
                    "y1",
                    "x2",
                    "y2",
                    "source_operator_index"
                  ],
                  "type": "object"
                },
                "type": "array"
              },
              "text_items": {
                "items": {
                  "additionalProperties": false,
                  "properties": {
                    "bbox": {
                      "anyOf": [
                        {
                          "additionalProperties": false,
                          "properties": {
                            "height": {
                              "type": "number"
                            },
                            "width": {
                              "type": "number"
                            },
                            "x": {
                              "type": "number"
                            },
                            "y": {
                              "type": "number"
                            }
                          },
                          "required": [
                            "x",
                            "y",
                            "width",
                            "height"
                          ],
                          "type": "object"
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "column_index": {
                      "anyOf": [
                        {
                          "type": "integer"
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "id": {
                      "type": "string"
                    },
                    "line_id": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "quad": {
                      "anyOf": [
                        {
                          "items": {
                            "additionalProperties": false,
                            "properties": {
                              "x": {
                                "type": "number"
                              },
                              "y": {
                                "type": "number"
                              }
                            },
                            "required": [
                              "x",
                              "y"
                            ],
                            "type": "object"
                          },
                          "maxItems": 4,
                          "minItems": 4,
                          "type": "array"
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "raw_transform": {
                      "items": {
                        "anyOf": [
                          {
                            "type": "number"
                          },
                          {
                            "type": "null"
                          }
                        ]
                      },
                      "maxItems": 6,
                      "minItems": 6,
                      "type": "array"
                    },
                    "reading_order_index": {
                      "minimum": 0,
                      "type": "integer"
                    },
                    "text": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "id",
                    "text",
                    "reading_order_index",
                    "line_id",
                    "column_index",
                    "bbox",
                    "quad",
                    "raw_transform"
                  ],
                  "type": "object"
                },
                "type": "array"
              },
              "truncation": {
                "additionalProperties": false,
                "properties": {
                  "painted_rectangles": {
                    "enum": [
                      "complete",
                      "truncated"
                    ],
                    "type": "string"
                  },
                  "ruled_rects": {
                    "enum": [
                      "complete",
                      "truncated"
                    ],
                    "type": "string"
                  },
                  "ruling_segments": {
                    "enum": [
                      "complete",
                      "truncated"
                    ],
                    "type": "string"
                  },
                  "text_items": {
                    "enum": [
                      "complete",
                      "truncated"
                    ],
                    "type": "string"
                  }
                },
                "required": [
                  "text_items",
                  "ruled_rects",
                  "ruling_segments",
                  "painted_rectangles"
                ],
                "type": "object"
              }
            },
            "required": [
              "region_id",
              "page",
              "reason",
              "coordinate_space",
              "bbox",
              "text_items",
              "ruled_rects",
              "ruling_segments",
              "painted_rectangles",
              "header_hints",
              "truncation",
              "proposal_token"
            ],
            "type": "object"
          },
          "type": "array"
        },
        "table_proposals_truncation": {
          "additionalProperties": false,
          "properties": {
            "observed_regions": {
              "type": "integer"
            },
            "omitted_regions": {
              "type": "integer"
            },
            "returned_regions": {
              "type": "integer"
            },
            "status": {
              "enum": [
                "complete",
                "truncated"
              ],
              "type": "string"
            }
          },
          "required": [
            "status",
            "observed_regions",
            "returned_regions",
            "omitted_regions"
          ],
          "type": "object"
        }
      },
      "required": [
        "renderer",
        "conversion_status",
        "markdown",
        "markdown_sha256",
        "markdown_bytes",
        "options",
        "limits",
        "pages",
        "pages_needing_vision",
        "gaps",
        "limitations",
        "normalizations",
        "provenance",
        "saved_output"
      ],
      "type": "object"
    },
    {
      "additionalProperties": false,
      "properties": {
        "error": {
          "additionalProperties": false,
          "properties": {
            "code": {
              "enum": [
                "internal_validation_error",
                "path_policy_denied",
                "tool_execution_failed"
              ],
              "type": "string"
            },
            "error_schema_version": {
              "const": 1
            }
          },
          "required": [
            "error_schema_version",
            "code"
          ],
          "type": "object"
        },
        "status": {
          "const": "failed"
        }
      },
      "required": [
        "status",
        "error"
      ],
      "type": "object"
    },
    {
      "additionalProperties": false,
      "properties": {
        "error": {
          "additionalProperties": false,
          "properties": {
            "code": {
              "enum": [
                "PASSWORD_REQUIRED",
                "PASSWORD_INCORRECT"
              ],
              "type": "string"
            },
            "error_schema_version": {
              "const": 1
            }
          },
          "required": [
            "error_schema_version",
            "code"
          ],
          "type": "object"
        },
        "status": {
          "const": "failed"
        }
      },
      "required": [
        "status",
        "error"
      ],
      "type": "object"
    },
    {
      "additionalProperties": false,
      "properties": {
        "error": {
          "additionalProperties": false,
          "properties": {
            "code": {
              "const": "PDF_RESOURCE_LIMIT_EXCEEDED"
            },
            "error_schema_version": {
              "const": 1
            }
          },
          "required": [
            "error_schema_version",
            "code"
          ],
          "type": "object"
        },
        "status": {
          "const": "failed"
        }
      },
      "required": [
        "status",
        "error"
      ],
      "type": "object"
    }
  ],
  "type": "object"
}
sha256:ab58cfbf23fc74fcf62342466e66cb201affc73dda1fe4f83fb13bc354ffb130

Description hash: sha256:faff516c9b51c5e7ca4e71dae4e50631a84c99f592fd38ec0aab5f0638d04c6d

Interface hash: sha256:8d8e8b40e4722b5d6d7f303b70354d5ff372cefd5688434c6e787ffb53298b20

Other observed Modelara metadata
{
  "id": "mcp:pdf-tools/convert_pdf_to_markdown",
  "title": "Convert PDF to Markdown",
  "source": {
    "type": "mcp",
    "server": "pdf-tools",
    "operation": "convert_pdf_to_markdown"
  },
  "declared": {
    "read_only": "false",
    "destructive": "true",
    "idempotent": "true",
    "open_world": "false"
  },
  "safety": {
    "idempotent": "true",
    "retry_safe": "unknown"
  },
  "metadata": {
    "mcp.annotations": "present"
  },
  "fingerprint": "sha256:e80b0144822a7193c521f1e4d5350e5392150b0f76fcd4e1474f0f12f730afaf"
}
tooldestructive0.12.10.14.0
create_extraction_workspacepdf-toolkit:tool:create_extraction_workspace
Observed interface and hashes

Create a private local workspace bound to the exact PDF bytes and JSON Schema. The server maps every page with the local PDF parser, compiles the schema leaves, and stores no model output. Experimental and model-free.

Input schema

{
  "additionalProperties": false,
  "properties": {
    "max_pages": {
      "maximum": 200,
      "minimum": 1,
      "type": "integer"
    },
    "password": {
      "type": "string"
    },
    "pdf_path": {
      "type": "string"
    },
    "schema": {
      "type": "object"
    },
    "workspace_id": {
      "pattern": "^[a-z0-9](?:[a-z0-9_-]{0,62}[a-z0-9])?$",
      "type": "string"
    }
  },
  "required": [
    "pdf_path",
    "workspace_id",
    "schema"
  ],
  "type": "object"
}
sha256:65c945c2be517289a40d94f855fb70f71cf27bfcce4af940aba4d65e0f873c3a

Output schema

{
  "anyOf": [
    {
      "additionalProperties": false,
      "properties": {
        "creator_claim_sha256": {
          "pattern": "^[a-f0-9]{64}$",
          "type": "string"
        },
        "document_map_sha256": {
          "pattern": "^[a-f0-9]{64}$",
          "type": "string"
        },
        "generation_sequence": {
          "const": 0
        },
        "generation_sha256": {
          "pattern": "^[a-f0-9]{64}$",
          "type": "string"
        },
        "leaf_obligations": {
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        "state": {
          "const": "complete"
        },
        "workspace_id": {
          "type": "string"
        },
        "workspace_identity_sha256": {
          "pattern": "^[a-f0-9]{64}$",
          "type": "string"
        },
        "workspace_path": {
          "type": "string"
        },
        "workspace_pointer_sha256": {
          "pattern": "^[a-f0-9]{64}$",
          "type": "string"
        }
      },
      "required": [
        "workspace_id",
        "workspace_path",
        "workspace_identity_sha256",
        "workspace_pointer_sha256",
        "creator_claim_sha256",
        "generation_sha256",
        "generation_sequence",
        "state",
        "leaf_obligations",
        "document_map_sha256"
      ],
      "type": "object"
    },
    {
      "additionalProperties": false,
      "properties": {
        "error": {
          "additionalProperties": false,
          "properties": {
            "code": {
              "enum": [
                "internal_validation_error",
                "path_policy_denied",
                "tool_execution_failed"
              ],
              "type": "string"
            },
            "error_schema_version": {
              "const": 1
            }
          },
          "required": [
            "error_schema_version",
            "code"
          ],
          "type": "object"
        },
        "status": {
          "const": "failed"
        }
      },
      "required": [
        "status",
        "error"
      ],
      "type": "object"
    }
  ],
  "type": "object"
}
sha256:8a36a167009e7f86b3b40884a509b57a2aad1bd453d5b42e07193a3f1cbf7878

Description hash: sha256:4fb6538f184f1d04de91caf1406cf0a64112fcf6696e57faaa49ca6723a6254c

Interface hash: sha256:90921fc3594b5a6dfecc196b82301a3896b2887e03b513f74b89544f21296553

Other observed Modelara metadata
{
  "id": "mcp:pdf-tools/create_extraction_workspace",
  "title": "Create Verified Extraction Workspace",
  "source": {
    "type": "mcp",
    "server": "pdf-tools",
    "operation": "create_extraction_workspace"
  },
  "declared": {
    "read_only": "false",
    "destructive": "false",
    "idempotent": "false",
    "open_world": "false"
  },
  "safety": {
    "idempotent": "false",
    "retry_safe": "false"
  },
  "metadata": {
    "mcp.annotations": "present"
  },
  "fingerprint": "sha256:1cbcf9640f31503c736e7821bedfd8cda1793ac3b6653a26c745f3079c1c6b24"
}
toolwrite0.13.00.13.0
create_signaturepdf-toolkit:tool:create_signature
Observed interface and hashes

Save a reusable signature the user can apply to PDFs. Two styles: 'typed' uses the user's display name rendered in italic script on apply, 'image' uses a PNG/JPEG the user provides (a scan or photo of their actual signature, or a drawn signature as a data URL). Signatures are stored locally at ~/.pdf-toolkit-files/signatures/. This tool is agent-safe — it does NOT sign any document; it just saves the signature asset for later use by apply_signature.

Input schema

{
  "properties": {
    "display_name": {
      "description": "The user's name as it should appear in attestations, e.g. 'Mat Silverstein'. If provided without an image source, creates a typed signature. If provided with image_path or image_data_url, it is stored as metadata alongside the image signature.",
      "type": "string"
    },
    "image_data_url": {
      "description": "[Image style] Base64 data URL of the signature image, e.g. 'data:image/png;base64,iVBOR...'. Use when the signature was drawn in the viewer or captured from another source.",
      "type": "string"
    },
    "image_path": {
      "description": "[Image style] Local path to a PNG or JPEG image of the signature (a scan/photo of a handwritten signature). Must be an absolute path on the user's machine.",
      "type": "string"
    },
    "name": {
      "description": "Short identifier for this signature (letters, numbers, hyphens, underscores, spaces, dots). Used to look it up later — e.g. 'mat-default', 'business'.",
      "type": "string"
    },
    "overwrite": {
      "description": "If a signature with this name already exists, overwrite it (default: false).",
      "type": "boolean"
    }
  },
  "required": [
    "name"
  ],
  "type": "object"
}
sha256:b92c6f3299835a5f7e6dbe44784b2b5028c9e9958e0c2e5ca346ec70fc29f71a

Output schema

{
  "anyOf": [
    {
      "additionalProperties": false,
      "properties": {
        "bytes": {
          "type": "integer"
        },
        "name": {
          "type": "string"
        },
        "path": {
          "type": "string"
        },
        "style": {
          "enum": [
            "typed",
            "image"
          ],
          "type": "string"
        }
      },
      "required": [
        "name",
        "style",
        "path",
        "bytes"
      ],
      "type": "object"
    },
    {
      "additionalProperties": false,
      "properties": {
        "error": {
          "additionalProperties": false,
          "properties": {
            "code": {
              "enum": [
                "internal_validation_error",
                "path_policy_denied",
                "tool_execution_failed"
              ],
              "type": "string"
            },
            "error_schema_version": {
              "const": 1
            }
          },
          "required": [
            "error_schema_version",
            "code"
          ],
          "type": "object"
        },
        "status": {
          "const": "failed"
        }
      },
      "required": [
        "status",
        "error"
      ],
      "type": "object"
    }
  ],
  "type": "object"
}
sha256:36fa9c4f28cdf6446a86aba39dd0728af874bd7d15b70c1e26f86abc75885ba4

Description hash: sha256:4ca691e6643cad42423439dc600ccdd94aab348ca402c03131f2a0a5e66d5b98

Interface hash: sha256:7a15b0c77cdc40383b6f6b50f5285ca197479e6104968bc3ce4d7602a597c7c0

Other observed Modelara metadata
{
  "id": "mcp:pdf-tools/create_signature",
  "title": "Create Signature",
  "source": {
    "type": "mcp",
    "server": "pdf-tools",
    "operation": "create_signature"
  },
  "declared": {
    "read_only": "false",
    "destructive": "true",
    "idempotent": "false",
    "open_world": "false"
  },
  "safety": {
    "idempotent": "false",
    "retry_safe": "false"
  },
  "metadata": {
    "mcp.annotations": "present"
  },
  "fingerprint": "sha256:c3b3b3f8d0c10378674b78c735b54495db2ccec7c436b6b30ead40388bd113ac"
}
tooldestructive0.12.1No change observed
delete_extraction_workspacepdf-toolkit:tool:delete_extraction_workspace
Observed interface and hashes

Permanently delete one private workspace only when both its exact identity and exact current generation match. Requires the literal confirmation DELETE.

Input schema

{
  "additionalProperties": false,
  "properties": {
    "confirm": {
      "const": "DELETE"
    },
    "current_generation_sha256": {
      "pattern": "^[a-f0-9]{64}$",
      "type": "string"
    },
    "workspace_id": {
      "type": "string"
    },
    "workspace_identity_sha256": {
      "pattern": "^[a-f0-9]{64}$",
      "type": "string"
    }
  },
  "required": [
    "workspace_id",
    "workspace_identity_sha256",
    "current_generation_sha256",
    "confirm"
  ],
  "type": "object"
}
sha256:5d02ff95509eb13de9af018baf80f5662850c319af7d41b1c2027ac2405a3752

Output schema

{
  "anyOf": [
    {
      "additionalProperties": false,
      "properties": {
        "final_generation_sha256": {
          "pattern": "^[a-f0-9]{64}$",
          "type": "string"
        },
        "recoverable": {
          "const": false
        },
        "state": {
          "const": "deleted"
        },
        "workspace_id": {
          "type": "string"
        },
        "workspace_identity_sha256": {
          "pattern": "^[a-f0-9]{64}$",
          "type": "string"
        }
      },
      "required": [
        "state",
        "workspace_id",
        "workspace_identity_sha256",
        "final_generation_sha256",
        "recoverable"
      ],
      "type": "object"
    },
    {
      "additionalProperties": false,
      "properties": {
        "error": {
          "additionalProperties": false,
          "properties": {
            "code": {
              "enum": [
                "internal_validation_error",
                "path_policy_denied",
                "tool_execution_failed"
              ],
              "type": "string"
            },
            "error_schema_version": {
              "const": 1
            }
          },
          "required": [
            "error_schema_version",
            "code"
          ],
          "type": "object"
        },
        "status": {
          "const": "failed"
        }
      },
      "required": [
        "status",
        "error"
      ],
      "type": "object"
    }
  ],
  "type": "object"
}
sha256:2dccee04477dbd2a8ecafe611947e616ee81b7a54e1c3355791f1aa1a083e19c

Description hash: sha256:ba6923d6ca52acf64f3d44fbd946cff3f65aef66b3b5f69879ec71ef20421ce4

Interface hash: sha256:d66a5aa4f7151e1f4f9765299c9bab14b178d333c4c3960100bc4753ac4db4bf

Other observed Modelara metadata
{
  "id": "mcp:pdf-tools/delete_extraction_workspace",
  "title": "Delete Verified Extraction Workspace",
  "source": {
    "type": "mcp",
    "server": "pdf-tools",
    "operation": "delete_extraction_workspace"
  },
  "declared": {
    "read_only": "false",
    "destructive": "true",
    "idempotent": "false",
    "open_world": "false"
  },
  "safety": {
    "idempotent": "false",
    "retry_safe": "false"
  },
  "metadata": {
    "mcp.annotations": "present"
  },
  "fingerprint": "sha256:230a7171e2030cc018a8620a9c11c4873229d37522dfdf686e819c4e463e8f39"
}
tooldestructive0.13.00.13.0
detect_signature_zonespdf-toolkit:tool:detect_signature_zones
Observed interface and hashes

Find places in a PDF where a signature, initials, printed name, or date should go. Returns typed zones with top-left coordinates in points. Use this before apply_signature and never guess coordinates. Apply signatures and initials with apply_signature. Apply names and dates with apply_text. Detection uses AcroForm widgets and text labels such as 'Signature', 'Witness', 'Print Name', and 'Dated'. Encrypted PDFs use the authenticated PDF.js text layer and report that AcroForm widgets were not scanned. Any widget whose page cannot be resolved is skipped with a warning instead of being assigned a fabricated location.

Input schema

{
  "properties": {
    "password": {
      "description": "Password for encrypted PDFs. PDF.js uses it, but this operation also loads page geometry with pdf-lib, which cannot decrypt PDFs, so an encrypted document still fails with the correct password.",
      "type": "string"
    },
    "pdf_path": {
      "description": "Path to the PDF file",
      "type": "string"
    }
  },
  "required": [
    "pdf_path"
  ],
  "type": "object"
}
sha256:6e3d28546ab97c6ed0b489971a3cfc357d3b2a826cf16bea4ce27d3a992afb2a

Output schema

{
  "anyOf": [
    {
      "additionalProperties": false,
      "properties": {
        "detection_status": {
          "enum": [
            "complete",
            "partial"
          ],
          "type": "string"
        },
        "page_geometry": {
          "items": {
            "additionalProperties": false,
            "properties": {
              "height": {
                "type": "number"
              },
              "origin_x": {
                "type": "number"
              },
              "origin_y": {
                "type": "number"
              },
              "page": {
                "type": "integer"
              },
              "width": {
                "type": "number"
              }
            },
            "required": [
              "page",
              "origin_x",
              "origin_y",
              "width",
              "height"
            ],
            "type": "object"
          },
          "type": "array"
        },
        "warnings": {
          "items": {
            "additionalProperties": false,
            "properties": {
              "code": {
                "enum": [
                  "ACROFORM_WIDGET_PAGE_UNRESOLVED",
                  "ENCRYPTED_ACROFORM_SCAN_UNAVAILABLE",
                  "TEXT_EXTRACTION_UNAVAILABLE"
                ],
                "type": "string"
              },
              "message": {
                "type": "string"
              },
              "occurrences": {
                "minimum": 1,
                "type": "integer"
              }
            },
            "required": [
              "code",
              "message",
              "occurrences"
            ],
            "type": "object"
          },
          "type": "array"
        },
        "zones": {
          "items": {
            "additionalProperties": false,
            "properties": {
              "confidence": {
                "type": "number"
              },
              "height": {
                "type": "number"
              },
              "label": {
                "type": "string"
              },
              "page": {
                "type": "integer"
              },
              "source": {
                "enum": [
                  "text-heuristic",
                  "acroform-signature",
                  "acroform-named-field"
                ],
                "type": "string"
              },
              "type": {
                "enum": [
                  "signature",
                  "initials",
                  "name",
                  "date"
                ],
                "type": "string"
              },
              "width": {
                "type": "number"
              },
              "x": {
                "type": "number"
              },
              "y": {
                "type": "number"
              }
            },
            "required": [
              "type",
              "label",
              "page",
              "x",
              "y",
              "width",
              "height",
              "confidence",
              "source"
            ],
            "type": "object"
          },
          "type": "array"
        }
      },
      "required": [
        "detection_status",
        "zones",
        "warnings",
        "page_geometry"
      ],
      "type": "object"
    },
    {
      "additionalProperties": false,
      "properties": {
        "error": {
          "additionalProperties": false,
          "properties": {
            "code": {
              "enum": [
                "internal_validation_error",
                "path_policy_denied",
                "tool_execution_failed"
              ],
              "type": "string"
            },
            "error_schema_version": {
              "const": 1
            }
          },
          "required": [
            "error_schema_version",
            "code"
          ],
          "type": "object"
        },
        "status": {
          "const": "failed"
        }
      },
      "required": [
        "status",
        "error"
      ],
      "type": "object"
    },
    {
      "additionalProperties": false,
      "properties": {
        "error": {
          "additionalProperties": false,
          "properties": {
            "code": {
              "enum": [
                "PASSWORD_REQUIRED",
                "PASSWORD_INCORRECT"
              ],
              "type": "string"
            },
            "error_schema_version": {
              "const": 1
            }
          },
          "required": [
            "error_schema_version",
            "code"
          ],
          "type": "object"
        },
        "status": {
          "const": "failed"
        }
      },
      "required": [
        "status",
        "error"
      ],
      "type": "object"
    },
    {
      "additionalProperties": false,
      "properties": {
        "error": {
          "additionalProperties": false,
          "properties": {
            "code": {
              "const": "PDF_RESOURCE_LIMIT_EXCEEDED"
            },
            "error_schema_version": {
              "const": 1
            }
          },
          "required": [
            "error_schema_version",
            "code"
          ],
          "type": "object"
        },
        "status": {
          "const": "failed"
        }
      },
      "required": [
        "status",
        "error"
      ],
      "type": "object"
    }
  ],
  "type": "object"
}
sha256:23eebe8d9cac299ada04b81d46f7e2cbb229ef7cadf6895706d5ec2f10dd70d4

Description hash: sha256:04da58c4ad36ebba353143ccc8053d2fb7698492d2570af48ad5bdd68fbad973

Interface hash: sha256:0bbdcde5a7afc9bf1828c5ac9b09a53ef989c6f364b93bc4e7f0deda32e77996

Other observed Modelara metadata
{
  "id": "mcp:pdf-tools/detect_signature_zones",
  "title": "Detect Signature Zones",
  "source": {
    "type": "mcp",
    "server": "pdf-tools",
    "operation": "detect_signature_zones"
  },
  "declared": {
    "read_only": "true",
    "destructive": "false",
    "idempotent": "true",
    "open_world": "false"
  },
  "safety": {
    "idempotent": "true",
    "retry_safe": "true"
  },
  "metadata": {
    "mcp.annotations": "present"
  },
  "fingerprint": "sha256:b767f3e73d33fb7db17e875ab27666162a9cbc1d803b031f434a2949276de1df"
}
toolread0.12.1No change observed
display_pdfpdf-toolkit:tool:display_pdf
Observed interface and hashes

Open the interactive PDF viewer with page navigation, zoom, in-document search, text selection, form-field sidebar, and Sign mode. This is the primary tool for visually working with a PDF. If the user gave you a URL instead of a local path, call fetch_pdf_from_url first, then pass the downloaded local path here. Automatically detects form fields, so you usually do not need to also call read_pdf_fields. All paths must be absolute paths on the user's local machine, NOT Claude container paths (/mnt/...).

Input schema

{
  "examples": [
    {
      "page": 2,
      "pdf_path": "/Users/alice/Documents/w9.pdf"
    }
  ],
  "properties": {
    "page": {
      "description": "Initial page number to display (default: 1).",
      "type": "number"
    },
    "pdf_path": {
      "description": "Absolute path to the PDF file.",
      "type": "string"
    }
  },
  "required": [
    "pdf_path"
  ],
  "type": "object"
}
sha256:3828bca26ad5beed579b7b43f950b57e7338069cf84490329a73555cedf2686d

Output schema

{
  "anyOf": [
    {
      "additionalProperties": false,
      "properties": {
        "active_path": {
          "type": "string"
        },
        "backup_path": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ]
        },
        "fieldCount": {
          "type": "integer"
        },
        "fields": {
          "items": {
            "additionalProperties": false,
            "properties": {
              "currentValue": {
                "anyOf": [
                  {
                    "type": "string"
                  },
                  {
                    "type": "boolean"
                  },
                  {
                    "items": {
                      "type": "string"
                    },
                    "type": "array"
                  }
                ]
              },
              "name": {
                "type": "string"
              },
              "options": {
                "items": {
                  "type": "string"
                },
                "type": "array"
              },
              "type": {
                "enum": [
                  "text",
                  "checkbox",
                  "radio",
                  "dropdown",
                  "unknown"
                ],
                "type": "string"
              }
            },
            "required": [
              "name",
              "type",
              "options",
              "currentValue"
            ],
            "type": "object"
          },
          "type": "array"
        },
        "hasFormFields": {
          "type": "boolean"
        },
        "initialPage": {
          "type": "integer"
        },
        "last_mutation_at": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ]
        },
        "last_mutation_tool": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ]
        },
        "pdfPath": {
          "type": "string"
        },
        "totalBytes": {
          "type": "integer"
        }
      },
      "required": [
        "pdfPath",
        "totalBytes",
        "initialPage",
        "fields",
        "fieldCount",
        "hasFormFields",
        "active_path",
        "backup_path",
        "last_mutation_tool",
        "last_mutation_at"
      ],
      "type": "object"
    },
    {
      "additionalProperties": false,
      "properties": {
        "error": {
          "additionalProperties": false,
          "properties": {
            "code": {
              "enum": [
                "internal_validation_error",
                "path_policy_denied",
                "tool_execution_failed"
              ],
              "type": "string"
            },
            "error_schema_version": {
              "const": 1
            }
          },
          "required": [
            "error_schema_version",
            "code"
          ],
          "type": "object"
        },
        "status": {
          "const": "failed"
        }
      },
      "required": [
        "status",
        "error"
      ],
      "type": "object"
    }
  ],
  "type": "object"
}
sha256:8228bb9d4087430cab91d0d0d44e3dcd935f4aba97580ee9cf3d99c339c9e135

Description hash: sha256:42e8acb350d4ace75ff5b1a28349aacb402170b7086b5cd3e4cc3c95bd9ce925

Interface hash: sha256:c21ceb4b887583150e23ef121b82c6f8e82047f769290d5da56333f9531fb240

Other observed Modelara metadata
{
  "id": "mcp:pdf-tools/display_pdf",
  "title": "Display PDF Viewer",
  "source": {
    "type": "mcp",
    "server": "pdf-tools",
    "operation": "display_pdf"
  },
  "declared": {
    "read_only": "false",
    "destructive": "false",
    "idempotent": "false",
    "open_world": "false"
  },
  "safety": {
    "idempotent": "false",
    "retry_safe": "false"
  },
  "metadata": {
    "mcp.annotations": "present"
  },
  "fingerprint": "sha256:bfb5cfba0fdb1d869ab2df6f84d338e8e8798d2d09d231f98f1fa967bbd83c51"
}
toolwrite0.12.1No change observed
download_lumin_artifactpdf-toolkit:tool:download_lumin_artifact
Observed interface and hashes

Download an existing Lumin signing artifact to an allowed local folder without overwriting a file. The temporary signed download URL is consumed internally and is never returned, logged, or persisted. This cannot create or retry a signing request.

Input schema

{
  "additionalProperties": false,
  "properties": {
    "authority_sha256": {
      "pattern": "^[a-f0-9]{64}$",
      "type": "string"
    },
    "authorization_session_id": {
      "type": "string"
    },
    "file_type": {
      "enum": [
        "agreement",
        "coc",
        "merged"
      ],
      "type": "string"
    },
    "output_path": {
      "description": "Preferred local PDF path. Existing files are never replaced.",
      "type": "string"
    }
  },
  "required": [
    "authority_sha256",
    "authorization_session_id",
    "file_type",
    "output_path"
  ],
  "type": "object"
}
sha256:4f9750378bafbd77ac53b527e88149622880deb17e8c52aeaefcfcadeadd53bd

Output schema

{
  "anyOf": [
    {
      "additionalProperties": false,
      "properties": {
        "access_token_persisted": {
          "const": false
        },
        "access_url_persisted": {
          "const": false
        },
        "access_url_returned": {
          "const": false
        },
        "artifact_observation_sha256": {
          "pattern": "^[a-f0-9]{64}$",
          "type": "string"
        },
        "authority_sha256": {
          "pattern": "^[a-f0-9]{64}$",
          "type": "string"
        },
        "create_retry_allowed": {
          "const": false
        },
        "file_type": {
          "enum": [
            "agreement",
            "coc",
            "merged"
          ],
          "type": "string"
        },
        "pdf_path": {
          "type": "string"
        },
        "provider": {
          "const": "lumin_sign"
        },
        "sha256": {
          "pattern": "^[a-f0-9]{64}$",
          "type": "string"
        },
        "size_bytes": {
          "type": "integer"
        },
        "status": {
          "const": "downloaded"
        }
      },
      "required": [
        "status",
        "provider",
        "authority_sha256",
        "file_type",
        "pdf_path",
        "size_bytes",
        "sha256",
        "artifact_observation_sha256",
        "access_url_persisted",
        "access_url_returned",
        "access_token_persisted",
        "create_retry_allowed"
      ],
      "type": "object"
    },
    {
      "additionalProperties": false,
      "properties": {
        "error": {
          "additionalProperties": false,
          "properties": {
            "code": {
              "enum": [
                "internal_validation_error",
                "path_policy_denied",
                "tool_execution_failed"
              ],
              "type": "string"
            },
            "error_schema_version": {
              "const": 1
            }
          },
          "required": [
            "error_schema_version",
            "code"
          ],
          "type": "object"
        },
        "status": {
          "const": "failed"
        }
      },
      "required": [
        "status",
        "error"
      ],
      "type": "object"
    },
    {
      "additionalProperties": false,
      "properties": {
        "error": {
          "additionalProperties": false,
          "properties": {
            "code": {
              "pattern": "^LUMIN_[A-Z0-9_]+$",
              "type": "string"
            },
            "error_schema_version": {
              "const": 1
            }
          },
          "required": [
            "error_schema_version",
            "code"
          ],
          "type": "object"
        },
        "status": {
          "const": "failed"
        }
      },
      "required": [
        "status",
        "error"
      ],
      "type": "object"
    }
  ],
  "type": "object"
}
sha256:1eeeebfcc3e8f87655e1198ac382ffe89658ae8dacc5809cdc199284f7f00c48

Description hash: sha256:afef9745285d5f87f95b4728b4e89b7e00b5115469b56966cfaf1776ccc24477

Interface hash: sha256:f94e271a7cdb2e4e7d5df9eaeba8111c9562791d0b8932fa711030af9bb4422e

Other observed Modelara metadata
{
  "id": "mcp:pdf-tools/download_lumin_artifact",
  "title": "Download Lumin Signing Artifact",
  "source": {
    "type": "mcp",
    "server": "pdf-tools",
    "operation": "download_lumin_artifact"
  },
  "declared": {
    "read_only": "false",
    "destructive": "false",
    "idempotent": "false",
    "open_world": "true"
  },
  "safety": {
    "idempotent": "false",
    "retry_safe": "false"
  },
  "metadata": {
    "mcp.annotations": "present"
  },
  "fingerprint": "sha256:7fa09004c67f950e520ec6b9788287e56d36e3977d012f4e2c59c50f245a4f52"
}
toolwrite0.14.00.14.0
extract_to_csvpdf-toolkit:tool:extract_to_csv
Observed interface and hashes

Extract form data from filled PDFs to a CSV file

Input schema

{
  "properties": {
    "output_csv": {
      "description": "Path where the CSV file will be saved",
      "type": "string"
    },
    "pdf_paths": {
      "description": "Array of PDF file paths to extract data from",
      "items": {
        "type": "string"
      },
      "type": "array"
    }
  },
  "required": [
    "pdf_paths",
    "output_csv"
  ],
  "type": "object"
}
sha256:f8b546f99ed554bbb4cb74609a2473b130a1b6439f85d3a50d95b60811def0d5

Output schema

{
  "anyOf": [
    {
      "additionalProperties": false,
      "properties": {
        "field_count": {
          "type": "integer"
        },
        "headers": {
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        "output_csv": {
          "type": "string"
        },
        "preview_row_count": {
          "type": "integer"
        },
        "preview_rows": {
          "items": {
            "additionalProperties": {
              "type": "string"
            },
            "type": "object"
          },
          "type": "array"
        },
        "row_count": {
          "type": "integer"
        },
        "source_pdf_count": {
          "type": "integer"
        }
      },
      "required": [
        "output_csv",
        "source_pdf_count",
        "field_count",
        "row_count",
        "preview_row_count",
        "headers",
        "preview_rows"
      ],
      "type": "object"
    },
    {
      "additionalProperties": false,
      "properties": {
        "error": {
          "additionalProperties": false,
          "properties": {
            "code": {
              "enum": [
                "internal_validation_error",
                "path_policy_denied",
                "tool_execution_failed"
              ],
              "type": "string"
            },
            "error_schema_version": {
              "const": 1
            }
          },
          "required": [
            "error_schema_version",
            "code"
          ],
          "type": "object"
        },
        "status": {
          "const": "failed"
        }
      },
      "required": [
        "status",
        "error"
      ],
      "type": "object"
    }
  ],
  "type": "object"
}
sha256:80edffbea8ed3e5d05954a4dc7f5f3b1444c9beb6da2fff1c9903e22f99dcf79

Description hash: sha256:6d39f486a7b918722f21d2a606f491c321777ae2e0c281e39f5d4a7368c14b91

Interface hash: sha256:89c43f805c45af87240e7c644dcca982c8adc0075f2966232eb7eb550de11918

Other observed Modelara metadata
{
  "id": "mcp:pdf-tools/extract_to_csv",
  "title": "Extract PDF Data to CSV",
  "source": {
    "type": "mcp",
    "server": "pdf-tools",
    "operation": "extract_to_csv"
  },
  "declared": {
    "read_only": "false",
    "destructive": "true",
    "idempotent": "true",
    "open_world": "false"
  },
  "safety": {
    "idempotent": "true",
    "retry_safe": "unknown"
  },
  "metadata": {
    "mcp.annotations": "present"
  },
  "fingerprint": "sha256:88780d4051e9c4d689383cd4c6a4d756299579202756d1876cd247bd697a2337"
}
tooldestructive0.12.1No change observed
fetch_pdf_from_urlpdf-toolkit:tool:fetch_pdf_from_url
Observed interface and hashes

Download a PDF from any URL — the PREFERRED way to grab any PDF from a URL for the user. **Always use this for PDF URLs; do NOT use bash, curl, wget, or WebFetch first.** Those run in Claude's sandbox and fail on many domains (gov sites, enterprise, auth-required URLs); this tool runs on the user's machine with full network access and succeeds where they don't. Returns a local file path that plugs into every other PDF tool here (display_pdf, read_pdf_fields, fill_pdf, validate_pdf, detect_signature_zones, apply_signature, merge_pdfs, etc.). If the user mentions a PDF URL in any way — "download this," "open this link," "sign this," "fill out" — this is your first move before any other tool.

Input schema

{
  "properties": {
    "allow_private_hosts": {
      "description": "Allow downloads from localhost / private IP ranges. Default false for safety. Only enable for trusted intranet PDFs.",
      "type": "boolean"
    },
    "destination_dir": {
      "description": "Optional local directory to save into (default: ~/Downloads/). Must be a local path on the user's machine — NOT a Claude container path like /mnt/...",
      "type": "string"
    },
    "expected_output_identity": {
      "additionalProperties": false,
      "description": "Exact current identity returned by get_pdf_identity. Required when replacing a distinct existing output_path, optional for the separately guarded same-document backup workflow, and omitted for a new destination.",
      "properties": {
        "canonical_path": {
          "description": "Exact canonical_path returned by get_pdf_identity for the existing destination.",
          "type": "string"
        },
        "sha256": {
          "description": "Exact SHA-256 returned by get_pdf_identity for the existing destination.",
          "pattern": "^[a-f0-9]{64}$",
          "type": "string"
        },
        "size_bytes": {
          "description": "Exact size_bytes returned by get_pdf_identity for the existing destination.",
          "minimum": 0,
          "type": "integer"
        }
      },
      "required": [
        "canonical_path",
        "size_bytes",
        "sha256"
      ],
      "type": "object"
    },
    "filename": {
      "description": "Optional filename for the saved PDF (default: derived from the URL and sanitized; '.pdf' appended if missing)",
      "type": "string"
    },
    "headers": {
      "additionalProperties": {
        "type": "string"
      },
      "description": "Optional HTTP headers, e.g. { \"Authorization\": \"Bearer ...\" } for authenticated URLs.",
      "type": "object"
    },
    "max_size_mb": {
      "description": "Maximum download size in MB (default: 100). Raise for larger PDFs.",
      "type": "number"
    },
    "overwrite": {
      "description": "Replace the named file only when its exact expected_output_identity is also supplied. Default: false, which appends ' (2)', ' (3)', etc.",
      "type": "boolean"
    },
    "url": {
      "description": "HTTP or HTTPS URL of a PDF to download",
      "type": "string"
    }
  },
  "required": [
    "url"
  ],
  "type": "object"
}
sha256:098cfb6dde2a5e0377b61d39c749865f902a8835972adadd6a695dc1cb85d098

Output schema

{
  "anyOf": [
    {
      "additionalProperties": false,
      "properties": {
        "active_path": {
          "type": "string"
        },
        "backup_path": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ]
        },
        "bytes": {
          "type": "integer"
        },
        "content_type": {
          "type": "string"
        },
        "fieldCount": {
          "type": "integer"
        },
        "fields": {
          "items": {
            "additionalProperties": false,
            "properties": {
              "currentValue": {
                "anyOf": [
                  {
                    "type": "string"
                  },
                  {
                    "type": "boolean"
                  },
                  {
                    "items": {
                      "type": "string"
                    },
                    "type": "array"
                  }
                ]
              },
              "name": {
                "type": "string"
              },
              "options": {
                "items": {
                  "type": "string"
                },
                "type": "array"
              },
              "type": {
                "enum": [
                  "text",
                  "checkbox",
                  "radio",
                  "dropdown",
                  "unknown"
                ],
                "type": "string"
              }
            },
            "required": [
              "name",
              "type",
              "options",
              "currentValue"
            ],
            "type": "object"
          },
          "type": "array"
        },
        "hasFormFields": {
          "type": "boolean"
        },
        "initialPage": {
          "type": "integer"
        },
        "last_mutation_at": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ]
        },
        "last_mutation_tool": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ]
        },
        "pdfPath": {
          "type": "string"
        },
        "pdf_path": {
          "type": "string"
        },
        "source_url": {
          "type": "string"
        },
        "totalBytes": {
          "type": "integer"
        }
      },
      "required": [
        "pdfPath",
        "totalBytes",
        "initialPage",
        "fields",
        "fieldCount",
        "hasFormFields",
        "active_path",
        "backup_path",
        "last_mutation_tool",
        "last_mutation_at",
        "pdf_path",
        "bytes",
        "content_type",
        "source_url"
      ],
      "type": "object"
    },
    {
      "additionalProperties": false,
      "properties": {
        "error": {
          "additionalProperties": false,
          "properties": {
            "code": {
              "enum": [
                "internal_validation_error",
                "path_policy_denied",
                "tool_execution_failed"
              ],
              "type": "string"
            },
            "error_schema_version": {
              "const": 1
            }
          },
          "required": [
            "error_schema_version",
            "code"
          ],
          "type": "object"
        },
        "status": {
          "const": "failed"
        }
      },
      "required": [
        "status",
        "error"
      ],
      "type": "object"
    }
  ],
  "type": "object"
}
sha256:d489069d70521f2d57c349fde6b34100fc1c0432b10b3be8e7aa711cf4e8fd03

Description hash: sha256:2ad5a2f75d52d13925f3265ddcb223acfc529bd88ed1fea387afc3691104d898

Interface hash: sha256:0258ea5e25f2d8049460a43d1f0a361b5a9c3c240f903dcd129ef96f18c21d00

Other observed Modelara metadata
{
  "id": "mcp:pdf-tools/fetch_pdf_from_url",
  "title": "Fetch PDF from URL",
  "source": {
    "type": "mcp",
    "server": "pdf-tools",
    "operation": "fetch_pdf_from_url"
  },
  "declared": {
    "read_only": "false",
    "destructive": "true",
    "idempotent": "false",
    "open_world": "true"
  },
  "safety": {
    "idempotent": "false",
    "retry_safe": "false"
  },
  "metadata": {
    "mcp.annotations": "present"
  },
  "fingerprint": "sha256:9a1534332d773fa75a532d4fdc03c3670343ce846bf886d0460216b8b5fe4733"
}
tooldestructive0.12.1No change observed
fill_pdfpdf-toolkit:tool:fill_pdf
Observed interface and hashes

Fill a PDF form with provided data and save it. output_path may be the same as pdf_path for in-place editing; the original is backed up on the first same-path mutation. All paths must be absolute paths on the user's local machine, NOT Claude container paths (/mnt/...).

Input schema

{
  "properties": {
    "expected_output_identity": {
      "additionalProperties": false,
      "description": "Exact current identity returned by get_pdf_identity. Required when replacing a distinct existing output_path, optional for the separately guarded same-document backup workflow, and omitted for a new destination.",
      "properties": {
        "canonical_path": {
          "description": "Exact canonical_path returned by get_pdf_identity for the existing destination.",
          "type": "string"
        },
        "sha256": {
          "description": "Exact SHA-256 returned by get_pdf_identity for the existing destination.",
          "pattern": "^[a-f0-9]{64}$",
          "type": "string"
        },
        "size_bytes": {
          "description": "Exact size_bytes returned by get_pdf_identity for the existing destination.",
          "minimum": 0,
          "type": "integer"
        }
      },
      "required": [
        "canonical_path",
        "size_bytes",
        "sha256"
      ],
      "type": "object"
    },
    "field_data": {
      "description": "Object with field names as keys and values to fill",
      "type": "object"
    },
    "force_xfa": {
      "description": "Proceed even if the PDF is a DYNAMIC XFA form, whose pages are built from the XFA layer that saving drops (default: false). Static XFA needs no flag: its values live in the AcroForm and survive, and the result says the layer was removed.",
      "type": "boolean"
    },
    "output_path": {
      "description": "Path where the filled PDF will be saved",
      "type": "string"
    },
    "password": {
      "description": "Password for an encrypted PDF. Supply the user or owner password and the document is decrypted in memory, changed, and then saved with exactly the encryption and permissions it already had (encrypted inputs are limited to 16 MiB). The protection is never removed, changed, or added by this tool. Leave it unset for an unencrypted document. If the document's own permissions deny the change being made, the owner password is required, because that is the credential which authorises overriding them.",
      "type": "string"
    },
    "pdf_path": {
      "description": "Path to the source PDF file",
      "type": "string"
    }
  },
  "required": [
    "pdf_path",
    "output_path",
    "field_data"
  ],
  "type": "object"
}
sha256:4a6aac7f5a0f356c2543867a9cf8c86352a61d224b56c636f230774d2dc3f085

Output schema

{
  "anyOf": [
    {
      "additionalProperties": false,
      "properties": {
        "active_path": {
          "type": "string"
        },
        "backup_path": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ]
        },
        "fieldCount": {
          "type": "integer"
        },
        "fields": {
          "items": {
            "additionalProperties": false,
            "properties": {
              "currentValue": {
                "anyOf": [
                  {
                    "type": "string"
                  },
                  {
                    "type": "boolean"
                  },
                  {
                    "items": {
                      "type": "string"
                    },
                    "type": "array"
                  }
                ]
              },
              "name": {
                "type": "string"
              },
              "options": {
                "items": {
                  "type": "string"
                },
                "type": "array"
              },
              "type": {
                "enum": [
                  "text",
                  "checkbox",
                  "radio",
                  "dropdown",
                  "unknown"
                ],
                "type": "string"
              }
            },
            "required": [
              "name",
              "type",
              "options",
              "currentValue"
            ],
            "type": "object"
          },
          "type": "array"
        },
        "fill_errors": {
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        "filled_fields": {
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        "hasFormFields": {
          "type": "boolean"
        },
        "initialPage": {
          "type": "integer"
        },
        "last_mutation_at": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ]
        },
        "last_mutation_tool": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ]
        },
        "pdfPath": {
          "type": "string"
        },
        "totalBytes": {
          "type": "integer"
        }
      },
      "required": [
        "pdfPath",
        "totalBytes",
        "initialPage",
        "fields",
        "fieldCount",
        "hasFormFields",
        "active_path",
        "backup_path",
        "last_mutation_tool",
        "last_mutation_at",
        "filled_fields",
        "fill_errors"
      ],
      "type": "object"
    },
    {
      "additionalProperties": false,
      "properties": {
        "error": {
          "additionalProperties": false,
          "properties": {
            "code": {
              "enum": [
                "internal_validation_error",
                "path_policy_denied",
                "tool_execution_failed"
              ],
              "type": "string"
            },
            "error_schema_version": {
              "const": 1
            }
          },
          "required": [
            "error_schema_version",
            "code"
          ],
          "type": "object"
        },
        "status": {
          "const": "failed"
        }
      },
      "required": [
        "status",
        "error"
      ],
      "type": "object"
    },
    {
      "additionalProperties": false,
      "properties": {
        "error": {
          "additionalProperties": false,
          "properties": {
            "code": {
              "const": "PDF_RESOURCE_LIMIT_EXCEEDED"
            },
            "error_schema_version": {
              "const": 1
            }
          },
          "required": [
            "error_schema_version",
            "code"
          ],
          "type": "object"
        },
        "status": {
          "const": "failed"
        }
      },
      "required": [
        "status",
        "error"
      ],
      "type": "object"
    }
  ],
  "type": "object"
}
sha256:01b5362adf8670b570b1f2910eca4fe60577be8bac86c8e9719a783c29710496

Description hash: sha256:0c6d61d6d582a7b9461d1becf266e7986d697af33f4bd3a67fbe65bc77eca045

Interface hash: sha256:5fc2e50cf2554cfa16f2bf7bde23ed932784b469a17e44fc972a12c5e2334e7b

Other observed Modelara metadata
{
  "id": "mcp:pdf-tools/fill_pdf",
  "title": "Fill PDF Form",
  "source": {
    "type": "mcp",
    "server": "pdf-tools",
    "operation": "fill_pdf"
  },
  "declared": {
    "read_only": "false",
    "destructive": "true",
    "idempotent": "true",
    "open_world": "false"
  },
  "safety": {
    "idempotent": "true",
    "retry_safe": "unknown"
  },
  "metadata": {
    "mcp.annotations": "present"
  },
  "fingerprint": "sha256:bdd573509433417c1ed48f909f6c11b77106776c442f2e23863a684a29548408"
}
tooldestructive0.12.10.14.0
fill_with_profilepdf-toolkit:tool:fill_with_profile
Observed interface and hashes

Fill a PDF using a saved profile

Input schema

{
  "properties": {
    "additional_data": {
      "description": "Additional fields to fill/override (optional)",
      "type": "object"
    },
    "expected_output_identity": {
      "additionalProperties": false,
      "description": "Exact current identity returned by get_pdf_identity. Required when replacing a distinct existing output_path, optional for the separately guarded same-document backup workflow, and omitted for a new destination.",
      "properties": {
        "canonical_path": {
          "description": "Exact canonical_path returned by get_pdf_identity for the existing destination.",
          "type": "string"
        },
        "sha256": {
          "description": "Exact SHA-256 returned by get_pdf_identity for the existing destination.",
          "pattern": "^[a-f0-9]{64}$",
          "type": "string"
        },
        "size_bytes": {
          "description": "Exact size_bytes returned by get_pdf_identity for the existing destination.",
          "minimum": 0,
          "type": "integer"
        }
      },
      "required": [
        "canonical_path",
        "size_bytes",
        "sha256"
      ],
      "type": "object"
    },
    "output_path": {
      "description": "Path where the filled PDF will be saved",
      "type": "string"
    },
    "password": {
      "description": "Password for an encrypted PDF. Supply the user or owner password and the document is decrypted in memory, changed, and then saved with exactly the encryption and permissions it already had (encrypted inputs are limited to 16 MiB). The protection is never removed, changed, or added by this tool. Leave it unset for an unencrypted document. If the document's own permissions deny the change being made, the owner password is required, because that is the credential which authorises overriding them.",
      "type": "string"
    },
    "pdf_path": {
      "description": "Path to the PDF file",
      "type": "string"
    },
    "profile_name": {
      "description": "Name of the profile to use",
      "type": "string"
    }
  },
  "required": [
    "pdf_path",
    "output_path",
    "profile_name"
  ],
  "type": "object"
}
sha256:e77bf0c7b6ef75f183ded4d8c158bbc2451c60838138245eb7ab9503156f94a0

Output schema

{
  "anyOf": [
    {
      "additionalProperties": false,
      "properties": {
        "active_path": {
          "type": "string"
        },
        "backup_path": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ]
        },
        "fieldCount": {
          "type": "integer"
        },
        "fields": {
          "items": {
            "additionalProperties": false,
            "properties": {
              "currentValue": {
                "anyOf": [
                  {
                    "type": "string"
                  },
                  {
                    "type": "boolean"
                  },
                  {
                    "items": {
                      "type": "string"
                    },
                    "type": "array"
                  }
                ]
              },
              "name": {
                "type": "string"
              },
              "options": {
                "items": {
                  "type": "string"
                },
                "type": "array"
              },
              "type": {
                "enum": [
                  "text",
                  "checkbox",
                  "radio",
                  "dropdown",
                  "unknown"
                ],
                "type": "string"
              }
            },
            "required": [
              "name",
              "type",
              "options",
              "currentValue"
            ],
            "type": "object"
          },
          "type": "array"
        },
        "fill_errors": {
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        "filled_fields": {
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        "hasFormFields": {
          "type": "boolean"
        },
        "initialPage": {
          "type": "integer"
        },
        "last_mutation_at": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ]
        },
        "last_mutation_tool": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ]
        },
        "pdfPath": {
          "type": "string"
        },
        "profile_name": {
          "type": "string"
        },
        "totalBytes": {
          "type": "integer"
        }
      },
      "required": [
        "pdfPath",
        "totalBytes",
        "initialPage",
        "fields",
        "fieldCount",
        "hasFormFields",
        "active_path",
        "backup_path",
        "last_mutation_tool",
        "last_mutation_at",
        "profile_name",
        "filled_fields",
        "fill_errors"
      ],
      "type": "object"
    },
    {
      "additionalProperties": false,
      "properties": {
        "error": {
          "additionalProperties": false,
          "properties": {
            "code": {
              "enum": [
                "internal_validation_error",
                "path_policy_denied",
                "tool_execution_failed"
              ],
              "type": "string"
            },
            "error_schema_version": {
              "const": 1
            }
          },
          "required": [
            "error_schema_version",
            "code"
          ],
          "type": "object"
        },
        "status": {
          "const": "failed"
        }
      },
      "required": [
        "status",
        "error"
      ],
      "type": "object"
    },
    {
      "additionalProperties": false,
      "properties": {
        "error": {
          "additionalProperties": false,
          "properties": {
            "code": {
              "const": "PDF_RESOURCE_LIMIT_EXCEEDED"
            },
            "error_schema_version": {
              "const": 1
            }
          },
          "required": [
            "error_schema_version",
            "code"
          ],
          "type": "object"
        },
        "status": {
          "const": "failed"
        }
      },
      "required": [
        "status",
        "error"
      ],
      "type": "object"
    }
  ],
  "type": "object"
}
sha256:323b2967e1be73a392c6770e308e0043dbf6b13168e69272fd1950761667bc6a

Description hash: sha256:d64b56a7d541db1d33b4249153463b2d732e01409f2bc713cb3c8c6ef1278cf8

Interface hash: sha256:31cb81442194b3657ff0b3fcd855142af9c1f5a8e20db766303e038fb5d4bd69

Other observed Modelara metadata
{
  "id": "mcp:pdf-tools/fill_with_profile",
  "title": "Fill PDF with Profile",
  "source": {
    "type": "mcp",
    "server": "pdf-tools",
    "operation": "fill_with_profile"
  },
  "declared": {
    "read_only": "false",
    "destructive": "true",
    "idempotent": "true",
    "open_world": "false"
  },
  "safety": {
    "idempotent": "true",
    "retry_safe": "unknown"
  },
  "metadata": {
    "mcp.annotations": "present"
  },
  "fingerprint": "sha256:44400b914c93a7848ef9757f8cdb28718605e9df9daf20cb474b6fd7291e4f84"
}
tooldestructive0.12.1No change observed
finish_lumin_authorizationpdf-toolkit:tool:finish_lumin_authorization
Observed interface and hashes

Finish a browser login started by start_lumin_authorization. The Lumin access token is held only in this running PDF Tools process and is never returned, logged, or written to disk. Restarting PDF Tools requires connecting again.

Input schema

{
  "additionalProperties": false,
  "properties": {
    "authorization_session_id": {
      "description": "Opaque session ID returned by start_lumin_authorization.",
      "type": "string"
    }
  },
  "required": [
    "authorization_session_id"
  ],
  "type": "object"
}
sha256:eaaa1cf16e0e259e517cf73050e47dd7f31c564d37eb83bd37bbd0d89a1eaacd

Output schema

{
  "anyOf": [
    {
      "additionalProperties": false,
      "properties": {
        "access_token_persisted": {
          "const": false
        },
        "authorization_session_id": {
          "type": "string"
        },
        "next_step": {
          "type": "string"
        },
        "pdf_sent": {
          "const": false
        },
        "provider": {
          "const": "lumin_sign"
        },
        "refresh_token_persisted": {
          "const": false
        },
        "status": {
          "const": "connected"
        },
        "token_expires_at": {
          "type": "string"
        }
      },
      "required": [
        "status",
        "next_step",
        "provider",
        "authorization_session_id",
        "token_expires_at",
        "access_token_persisted",
        "refresh_token_persisted",
        "pdf_sent"
      ],
      "type": "object"
    },
    {
      "additionalProperties": false,
      "properties": {
        "error": {
          "additionalProperties": false,
          "properties": {
            "code": {
              "enum": [
                "internal_validation_error",
                "path_policy_denied",
                "tool_execution_failed"
              ],
              "type": "string"
            },
            "error_schema_version": {
              "const": 1
            }
          },
          "required": [
            "error_schema_version",
            "code"
          ],
          "type": "object"
        },
        "status": {
          "const": "failed"
        }
      },
      "required": [
        "status",
        "error"
      ],
      "type": "object"
    },
    {
      "additionalProperties": false,
      "properties": {
        "error": {
          "additionalProperties": false,
          "properties": {
            "code": {
              "pattern": "^LUMIN_[A-Z0-9_]+$",
              "type": "string"
            },
            "error_schema_version": {
              "const": 1
            }
          },
          "required": [
            "error_schema_version",
            "code"
          ],
          "type": "object"
        },
        "status": {
          "const": "failed"
        }
      },
      "required": [
        "status",
        "error"
      ],
      "type": "object"
    }
  ],
  "type": "object"
}
sha256:13a86d93ced7ebc24ed53200d74ab3571f6f66e18d59d99625fc16901da32949

Description hash: sha256:26ce9b30c58380ca0519c6aed50011a8e67536c38f26c847196d9ec4f4a222ae

Interface hash: sha256:2785f729257eb77ac6c4f2e22bd5ddbbba16a93125cf9a6f5e8e44ddc83ae05c

Other observed Modelara metadata
{
  "id": "mcp:pdf-tools/finish_lumin_authorization",
  "title": "Finish Lumin Connection",
  "source": {
    "type": "mcp",
    "server": "pdf-tools",
    "operation": "finish_lumin_authorization"
  },
  "declared": {
    "read_only": "false",
    "destructive": "false",
    "idempotent": "false",
    "open_world": "true"
  },
  "safety": {
    "idempotent": "false",
    "retry_safe": "false"
  },
  "metadata": {
    "mcp.annotations": "present"
  },
  "fingerprint": "sha256:fd114d376af313fc69a95f2e84b6c459f4ec94accc0520f8cb1a521b02dafb52"
}
toolwrite0.14.00.14.0
get_active_documentpdf-toolkit:tool:get_active_document
Observed interface and hashes

Return the toolkit's current active PDF document, including its canonical active_path, any backup_path created on first mutation, and the last mutation metadata. Use this when an agent needs to resume work on the current document without guessing which file is canonical.

Input schema

{
  "properties": {},
  "type": "object"
}
sha256:3178d649f32f96ea850da50c27c062f5c20cbef86dec2f5af0587dff56ebdb67

Output schema

{
  "anyOf": [
    {
      "anyOf": [
        {
          "additionalProperties": false,
          "properties": {
            "active_path": {
              "type": "null"
            },
            "backup_path": {
              "type": "null"
            },
            "last_mutation_at": {
              "type": "null"
            },
            "last_mutation_tool": {
              "type": "null"
            }
          },
          "required": [
            "active_path",
            "backup_path",
            "last_mutation_tool",
            "last_mutation_at"
          ],
          "type": "object"
        },
        {
          "additionalProperties": false,
          "properties": {
            "active_path": {
              "type": "string"
            },
            "backup_path": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ]
            },
            "fieldCount": {
              "type": "integer"
            },
            "fields": {
              "items": {
                "additionalProperties": false,
                "properties": {
                  "currentValue": {
                    "anyOf": [
                      {
                        "type": "string"
                      },
                      {
                        "type": "boolean"
                      },
                      {
                        "items": {
                          "type": "string"
                        },
                        "type": "array"
                      }
                    ]
                  },
                  "name": {
                    "type": "string"
                  },
                  "options": {
                    "items": {
                      "type": "string"
                    },
                    "type": "array"
                  },
                  "type": {
                    "enum": [
                      "text",
                      "checkbox",
                      "radio",
                      "dropdown",
                      "unknown"
                    ],
                    "type": "string"
                  }
                },
                "required": [
                  "name",
                  "type",
                  "options",
                  "currentValue"
                ],
                "type": "object"
              },
              "type": "array"
            },
            "hasFormFields": {
              "type": "boolean"
            },
            "initialPage": {
              "type": "integer"
            },
            "last_mutation_at": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ]
            },
            "last_mutation_tool": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ]
            },
            "pdfPath": {
              "type": "string"
            },
            "totalBytes": {
              "type": "integer"
            }
          },
          "required": [
            "pdfPath",
            "totalBytes",
            "initialPage",
            "fields",
            "fieldCount",
            "hasFormFields",
            "active_path",
            "backup_path",
            "last_mutation_tool",
            "last_mutation_at"
          ],
          "type": "object"
        }
      ],
      "type": "object"
    },
    {
      "additionalProperties": false,
      "properties": {
        "error": {
          "additionalProperties": false,
          "properties": {
            "code": {
              "enum": [
                "internal_validation_error",
                "path_policy_denied",
                "tool_execution_failed"
              ],
              "type": "string"
            },
            "error_schema_version": {
              "const": 1
            }
          },
          "required": [
            "error_schema_version",
            "code"
          ],
          "type": "object"
        },
        "status": {
          "const": "failed"
        }
      },
      "required": [
        "status",
        "error"
      ],
      "type": "object"
    }
  ],
  "type": "object"
}
sha256:2d0a0d1f4a69d9987da24db68c90e27ac4dbbc0da65735b72581e81baa831ed3

Description hash: sha256:8cb295c1e27b4e51ceced61aed3228a437d855cddf90d9e10ab56b5426ea3837

Interface hash: sha256:10263707c82720d84416b42f1bbcbd322f42d8464c4466c418101a96cecde494

Other observed Modelara metadata
{
  "id": "mcp:pdf-tools/get_active_document",
  "title": "Get Active Document",
  "source": {
    "type": "mcp",
    "server": "pdf-tools",
    "operation": "get_active_document"
  },
  "declared": {
    "read_only": "true",
    "destructive": "false",
    "idempotent": "true",
    "open_world": "false"
  },
  "safety": {
    "idempotent": "true",
    "retry_safe": "true"
  },
  "metadata": {
    "mcp.annotations": "present"
  },
  "fingerprint": "sha256:c0e817254655cf1180841b19d169701a131e87a13f77c5510dc51b05ff7e739e"
}
toolread0.12.1No change observed
get_allowed_directoriespdf-toolkit:tool:get_allowed_directories
Observed interface and hashes

Report which folders this server may read and write, which configuration layer supplied them, and where the stored configuration file lives. Answers without touching the filesystem, so it works before anything is configured. Use it to explain a path refusal or to tell the user where to change the boundary. It reports the boundary; it cannot change it.

Input schema

{
  "properties": {},
  "type": "object"
}
sha256:3178d649f32f96ea850da50c27c062f5c20cbef86dec2f5af0587dff56ebdb67

Output schema

{
  "anyOf": [
    {
      "additionalProperties": false,
      "properties": {
        "config_path": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ]
        },
        "configured": {
          "type": "boolean"
        },
        "directories": {
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        "source": {
          "enum": [
            "argument",
            "environment",
            "config_file",
            "home_config_file",
            "plugin_workspace",
            "none",
            "refused_self_granting"
          ],
          "type": "string"
        }
      },
      "required": [
        "directories",
        "configured",
        "source",
        "config_path"
      ],
      "type": "object"
    },
    {
      "additionalProperties": false,
      "properties": {
        "error": {
          "additionalProperties": false,
          "properties": {
            "code": {
              "enum": [
                "internal_validation_error",
                "path_policy_denied",
                "tool_execution_failed"
              ],
              "type": "string"
            },
            "error_schema_version": {
              "const": 1
            }
          },
          "required": [
            "error_schema_version",
            "code"
          ],
          "type": "object"
        },
        "status": {
          "const": "failed"
        }
      },
      "required": [
        "status",
        "error"
      ],
      "type": "object"
    }
  ],
  "type": "object"
}
sha256:0cb5bee293221381b59dfc213a52b93b2033d66a2bf11b69a624f0c34690da38

Description hash: sha256:0d74d6158ac7d6f89aaf3ea24db1477d5ad6d9e9b46555eb8e2896bab6935ce5

Interface hash: sha256:c5ceda161aa099a9743fed53aedd80cfe9c0023dd7aa1dc9bcd96ace970ffc95

Other observed Modelara metadata
{
  "id": "mcp:pdf-tools/get_allowed_directories",
  "title": "Get Allowed Directories",
  "source": {
    "type": "mcp",
    "server": "pdf-tools",
    "operation": "get_allowed_directories"
  },
  "declared": {
    "read_only": "true",
    "destructive": "false",
    "idempotent": "true",
    "open_world": "false"
  },
  "safety": {
    "idempotent": "true",
    "retry_safe": "true"
  },
  "metadata": {
    "mcp.annotations": "present"
  },
  "fingerprint": "sha256:8cfbc37e8f6548773720bb5f2a656a98bcf6169109863a118971988d1bda1690"
}
toolread0.12.1No change observed
get_page_analysispdf-toolkit:tool:get_page_analysis
Observed interface and hashes

Analyze a PDF and return per-page metadata with explicit content-analysis provenance: text length, text snippet, image/vector-graphics presence, dimensions, orientation, and blank_status. Only likely_blank pages with complete content measurements are blank candidates, and every candidate still requires visual inspection before mutation; unknown pages must never be deleted or reordered from this result. All paths must be absolute.

Input schema

{
  "properties": {
    "password": {
      "description": "Password for encrypted PDFs. PDF.js uses it, but this operation also loads page geometry with pdf-lib, which cannot decrypt PDFs, so an encrypted document still fails with the correct password.",
      "type": "string"
    },
    "pdf_path": {
      "description": "Path to the PDF file",
      "type": "string"
    }
  },
  "required": [
    "pdf_path"
  ],
  "type": "object"
}
sha256:6e3d28546ab97c6ed0b489971a3cfc357d3b2a826cf16bea4ce27d3a992afb2a

Output schema

{
  "anyOf": [
    {
      "additionalProperties": false,
      "properties": {
        "analysis_errors": {
          "items": {
            "additionalProperties": false,
            "properties": {
              "code": {
                "type": "string"
              },
              "page": {
                "type": "integer"
              },
              "scope": {
                "enum": [
                  "document",
                  "page"
                ],
                "type": "string"
              }
            },
            "required": [
              "scope",
              "code"
            ],
            "type": "object"
          },
          "type": "array"
        },
        "classification": {
          "additionalProperties": false,
          "properties": {
            "document_kind": {
              "enum": [
                "text_based",
                "image_based",
                "vector_heavy",
                "mixed",
                "empty",
                "unknown"
              ],
              "type": "string"
            },
            "pages_analyzed": {
              "type": "integer"
            },
            "pages_needing_vision": {
              "items": {
                "additionalProperties": false,
                "properties": {
                  "page": {
                    "type": "integer"
                  },
                  "reasons": {
                    "items": {
                      "enum": [
                        "invisible_text_layer",
                        "text_visibility_unavailable",
                        "no_text_layer",
                        "image_dominated",
                        "vector_only_text",
                        "suspected_text_integrity",
                        "analysis_unavailable"
                      ],
                      "type": "string"
                    },
                    "type": "array"
                  }
                },
                "required": [
                  "page",
                  "reasons"
                ],
                "type": "object"
              },
              "type": "array"
            },
            "pages_not_analyzed": {
              "items": {
                "type": "integer"
              },
              "type": "array"
            }
          },
          "required": [
            "document_kind",
            "pages_analyzed",
            "pages_needing_vision",
            "pages_not_analyzed"
          ],
          "type": "object"
        },
        "content_analysis_complete": {
          "type": "boolean"
        },
        "content_analysis_status": {
          "enum": [
            "complete",
            "partial",
            "degraded"
          ],
          "type": "string"
        },
        "content_pages_complete": {
          "type": "integer"
        },
        "content_pages_requested": {
          "type": "integer"
        },
        "likely_blank_pages": {
          "items": {
            "type": "integer"
          },
          "type": "array"
        },
        "majority_orientation": {
          "enum": [
            "portrait",
            "landscape"
          ],
          "type": "string"
        },
        "mutation_guidance": {
          "type": "string"
        },
        "nonblank_pages": {
          "items": {
            "type": "integer"
          },
          "type": "array"
        },
        "pages": {
          "items": {
            "additionalProperties": false,
            "properties": {
              "analysis_error_codes": {
                "items": {
                  "type": "string"
                },
                "type": "array"
              },
              "analysis_provenance": {
                "additionalProperties": false,
                "properties": {
                  "dimensions": {
                    "const": "pdf-lib"
                  },
                  "graphics": {
                    "anyOf": [
                      {
                        "enum": [
                          "pdfjs"
                        ],
                        "type": "string"
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "images": {
                    "anyOf": [
                      {
                        "enum": [
                          "pdfjs"
                        ],
                        "type": "string"
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "text": {
                    "anyOf": [
                      {
                        "enum": [
                          "pdfjs"
                        ],
                        "type": "string"
                      },
                      {
                        "type": "null"
                      }
                    ]
                  }
                },
                "required": [
                  "dimensions",
                  "text",
                  "images",
                  "graphics"
                ],
                "type": "object"
              },
              "blank_status": {
                "enum": [
                  "likely_blank",
                  "not_blank",
                  "unknown"
                ],
                "type": "string"
              },
              "content_analysis_status": {
                "enum": [
                  "complete",
                  "degraded",
                  "unavailable",
                  "not_analyzed"
                ],
                "type": "string"
              },
              "display_height": {
                "type": "integer"
              },
              "display_width": {
                "type": "integer"
              },
              "graphics_detection_status": {
                "enum": [
                  "complete",
                  "failed",
                  "not_analyzed"
                ],
                "type": "string"
              },
              "has_graphics": {
                "anyOf": [
                  {
                    "type": "boolean"
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "has_images": {
                "anyOf": [
                  {
                    "type": "boolean"
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "height": {
                "type": "integer"
              },
              "image_detection_status": {
                "enum": [
                  "complete",
                  "failed",
                  "not_analyzed"
                ],
                "type": "string"
              },
              "image_op_count": {
                "anyOf": [
                  {
                    "description": "Count of PDF.js image paint invocations; grouped or repeat image operators count as one invocation each, not raw PDF operators.",
                    "minimum": 0,
                    "type": "integer"
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "orientation": {
                "enum": [
                  "portrait",
                  "landscape"
                ],
                "type": "string"
              },
              "page": {
                "type": "integer"
              },
              "path_op_count": {
                "anyOf": [
                  {
                    "description": "Count of PDF.js constructPath invocations, not raw PDF path operators.",
                    "minimum": 0,
                    "type": "integer"
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "path_segment_count": {
                "anyOf": [
                  {
                    "description": "Count of DrawOPS path commands contained in PDF.js constructPath invocations.",
                    "minimum": 0,
                    "type": "integer"
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "rotation": {
                "type": "integer"
              },
              "text_extraction_status": {
                "enum": [
                  "complete",
                  "failed",
                  "not_analyzed"
                ],
                "type": "string"
              },
              "text_integrity": {
                "additionalProperties": false,
                "properties": {
                  "signals": {
                    "items": {
                      "additionalProperties": false,
                      "properties": {
                        "count": {
                          "minimum": 1,
                          "type": "integer"
                        },
                        "kind": {
                          "enum": [
                            "replacement_characters",
                            "private_use_runs",
                            "c1_control_tokens",
                            "non_alphanumeric_dominance"
                          ],
                          "type": "string"
                        }
                      },
                      "required": [
                        "kind",
                        "count"
                      ],
                      "type": "object"
                    },
                    "type": "array"
                  },
                  "status": {
                    "enum": [
                      "ok",
                      "suspect",
                      "unavailable"
                    ],
                    "type": "string"
                  }
                },
                "required": [
                  "status",
                  "signals"
                ],
                "type": "object"
              },
              "text_length": {
                "anyOf": [
                  {
                    "type": "integer"
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "text_snippet": {
                "anyOf": [
                  {
                    "type": "string"
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "text_visibility": {
                "additionalProperties": false,
                "properties": {
                  "invisible_text_show_count": {
                    "anyOf": [
                      {
                        "type": "integer"
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "other_text_show_count": {
                    "anyOf": [
                      {
                        "type": "integer"
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "status": {
                    "enum": [
                      "available",
                      "unavailable"
                    ],
                    "type": "string"
                  }
                },
                "required": [
                  "status",
                  "invisible_text_show_count",
                  "other_text_show_count"
                ],
                "type": "object"
              },
              "width": {
                "type": "integer"
              }
            },
            "required": [
              "text_visibility",
              "page",
              "width",
              "height",
              "rotation",
              "display_width",
              "display_height",
              "orientation",
              "text_length",
              "text_snippet",
              "has_images",
              "has_graphics",
              "image_op_count",
              "path_op_count",
              "path_segment_count",
              "content_analysis_status",
              "text_extraction_status",
              "image_detection_status",
              "graphics_detection_status",
              "blank_status",
              "analysis_error_codes",
              "analysis_provenance",
              "text_integrity"
            ],
            "type": "object"
          },
          "type": "array"
        },
        "retry_guidance": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ]
        },
        "total_pages": {
          "type": "integer"
        },
        "unknown_pages": {
          "items": {
            "type": "integer"
          },
          "type": "array"
        }
      },
      "required": [
        "total_pages",
        "content_analysis_status",
        "content_analysis_complete",
        "content_pages_requested",
        "content_pages_complete",
        "likely_blank_pages",
        "nonblank_pages",
        "unknown_pages",
        "analysis_errors",
        "retry_guidance",
        "mutation_guidance",
        "classification",
        "pages",
        "majority_orientation"
      ],
      "type": "object"
    },
    {
      "additionalProperties": false,
      "properties": {
        "error": {
          "additionalProperties": false,
          "properties": {
            "code": {
              "enum": [
                "internal_validation_error",
                "path_policy_denied",
                "tool_execution_failed"
              ],
              "type": "string"
            },
            "error_schema_version": {
              "const": 1
            }
          },
          "required": [
            "error_schema_version",
            "code"
          ],
          "type": "object"
        },
        "status": {
          "const": "failed"
        }
      },
      "required": [
        "status",
        "error"
      ],
      "type": "object"
    },
    {
      "additionalProperties": false,
      "properties": {
        "error": {
          "additionalProperties": false,
          "properties": {
            "code": {
              "const": "PDF_RESOURCE_LIMIT_EXCEEDED"
            },
            "error_schema_version": {
              "const": 1
            }
          },
          "required": [
            "error_schema_version",
            "code"
          ],
          "type": "object"
        },
        "status": {
          "const": "failed"
        }
      },
      "required": [
        "status",
        "error"
      ],
      "type": "object"
    }
  ],
  "type": "object"
}
sha256:7f9e044b14062047e920fe1e29f3f5fbfced45a56ab21cf70a2c026fce5d51af

Description hash: sha256:5c8d3b935555d936fdf9a189cc32565230a2a7dabedcaa3f13a98ff165d4f831

Interface hash: sha256:ef999b74197f5287b18c8bbc0819f9a4525ea859e18f776f0a6d17954ab26fb6

Other observed Modelara metadata
{
  "id": "mcp:pdf-tools/get_page_analysis",
  "title": "Get Page Analysis",
  "source": {
    "type": "mcp",
    "server": "pdf-tools",
    "operation": "get_page_analysis"
  },
  "declared": {
    "read_only": "true",
    "destructive": "false",
    "idempotent": "true",
    "open_world": "false"
  },
  "safety": {
    "idempotent": "true",
    "retry_safe": "true"
  },
  "metadata": {
    "mcp.annotations": "present"
  },
  "fingerprint": "sha256:9623b621ac936dc70dc1a722d1d9457f7c86b767330af6630458a13745fcc066"
}
toolread0.12.10.14.0
get_pdf_identitypdf-toolkit:tool:get_pdf_identity
Observed interface and hashes

Return a stable local artifact identity for a PDF without parsing or decrypting its document structure: canonical path, exact byte length, and SHA-256. Use this to bind plans, approvals, outputs, or provenance to the exact input bytes. The tool reads at most 250 MiB through one race-aware file descriptor and requires a PDF header within the first 1,024 bytes.

Input schema

{
  "examples": [
    {
      "pdf_path": "/Users/alice/Documents/contract.pdf"
    }
  ],
  "properties": {
    "pdf_path": {
      "description": "Absolute path to the local PDF file.",
      "type": "string"
    }
  },
  "required": [
    "pdf_path"
  ],
  "type": "object"
}
sha256:1f47fc667819a17233952dd0c0a1610b6a6a7cbab2f68b3b902a89e3c7fd9724

Output schema

{
  "anyOf": [
    {
      "additionalProperties": false,
      "properties": {
        "canonical_path": {
          "type": "string"
        },
        "file_name": {
          "type": "string"
        },
        "identity_method": {
          "const": "race_aware_descriptor_sha256"
        },
        "pdf_parsed": {
          "const": false
        },
        "requested_path": {
          "type": "string"
        },
        "schema_version": {
          "const": "1.0"
        },
        "sha256": {
          "pattern": "^[a-f0-9]{64}$",
          "type": "string"
        },
        "size_bytes": {
          "maximum": 262144000,
          "minimum": 0,
          "type": "integer"
        }
      },
      "required": [
        "schema_version",
        "requested_path",
        "canonical_path",
        "file_name",
        "size_bytes",
        "sha256",
        "identity_method",
        "pdf_parsed"
      ],
      "type": "object"
    },
    {
      "additionalProperties": false,
      "properties": {
        "error": {
          "additionalProperties": false,
          "properties": {
            "code": {
              "enum": [
                "internal_validation_error",
                "path_policy_denied",
                "tool_execution_failed"
              ],
              "type": "string"
            },
            "error_schema_version": {
              "const": 1
            }
          },
          "required": [
            "error_schema_version",
            "code"
          ],
          "type": "object"
        },
        "status": {
          "const": "failed"
        }
      },
      "required": [
        "status",
        "error"
      ],
      "type": "object"
    },
    {
      "additionalProperties": false,
      "properties": {
        "error": {
          "additionalProperties": false,
          "properties": {
            "code": {
              "enum": [
                "PDF_CHANGED_DURING_READ",
                "PDF_INPUT_TOO_LARGE",
                "PDF_INVALID_HEADER",
                "PDF_UNAVAILABLE"
              ],
              "type": "string"
            },
            "error_schema_version": {
              "const": 1
            }
          },
          "required": [
            "error_schema_version",
            "code"
          ],
          "type": "object"
        },
        "status": {
          "const": "failed"
        }
      },
      "required": [
        "status",
        "error"
      ],
      "type": "object"
    }
  ],
  "type": "object"
}
sha256:ab3fa980ff47f51d092d204b747ad7ffc93da859f7e6917cb71e9f513311bbda

Description hash: sha256:481df147ef8a7c758ecbae184d862d468d88f0a288fecdc86d8aca55921e0c7a

Interface hash: sha256:3cb129cd09fdad73cedc273f0f9d009aa4dc6029ae8adccce4ecf11e4ed6d593

Other observed Modelara metadata
{
  "id": "mcp:pdf-tools/get_pdf_identity",
  "title": "Get PDF Identity",
  "source": {
    "type": "mcp",
    "server": "pdf-tools",
    "operation": "get_pdf_identity"
  },
  "declared": {
    "read_only": "true",
    "destructive": "false",
    "idempotent": "true",
    "open_world": "false"
  },
  "safety": {
    "idempotent": "true",
    "retry_safe": "true"
  },
  "metadata": {
    "mcp.annotations": "present"
  },
  "fingerprint": "sha256:cf7aa2cab58e19c174178c0e81497a50f03d2cf765d2637e50ad1452294191f7"
}
toolread0.12.1No change observed
get_pdf_infopdf-toolkit:tool:get_pdf_info
Observed interface and hashes

Inspect a bounded local PDF through the pinned parser and return source-bound page geometry, Info and XMP metadata, form fields and widgets, and inert ordinary annotations. Every retained observation is tied to the canonical path, byte length, and SHA-256. Caps and parser failures are reported as partial or unavailable coverage, never as an empty-document claim. Annotation actions and URLs are observed but never followed. All paths must be absolute paths on the user's local machine.

Input schema

{
  "additionalProperties": false,
  "properties": {
    "max_output_characters": {
      "description": "Maximum serialized structured-output characters. Whole observations are omitted with explicit partial coverage when necessary. Default: 50000.",
      "maximum": 200000,
      "minimum": 20000,
      "type": "integer"
    },
    "max_pages": {
      "description": "Maximum pages to observe. Default: 200.",
      "maximum": 200,
      "minimum": 1,
      "type": "integer"
    },
    "password": {
      "description": "Password for encrypted PDFs (optional)",
      "maxLength": 4096,
      "type": "string"
    },
    "pdf_path": {
      "description": "Path to the PDF file",
      "type": "string"
    }
  },
  "required": [
    "pdf_path"
  ],
  "type": "object"
}
sha256:9c87c3fb179b02eb3f9c1c683b7c9bbdd93ecedb9a48890e429b52496758c16c

Output schema

{
  "anyOf": [
    {
      "additionalProperties": false,
      "properties": {
        "annotations": {
          "additionalProperties": false,
          "properties": {
            "encountered_count": {
              "type": "integer"
            },
            "items": {
              "items": {
                "additionalProperties": false,
                "properties": {
                  "contents": {
                    "type": "string"
                  },
                  "display_region": {
                    "anyOf": [
                      {
                        "additionalProperties": false,
                        "properties": {
                          "height": {
                            "type": "number"
                          },
                          "width": {
                            "type": "number"
                          },
                          "x": {
                            "type": "number"
                          },
                          "y": {
                            "type": "number"
                          }
                        },
                        "required": [
                          "x",
                          "y",
                          "width",
                          "height"
                        ],
                        "type": "object"
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "flags": {
                    "type": "integer"
                  },
                  "id": {
                    "pattern": "^annotation-[a-f0-9]{64}$",
                    "type": "string"
                  },
                  "native_region": {
                    "anyOf": [
                      {
                        "additionalProperties": false,
                        "properties": {
                          "x1": {
                            "type": "number"
                          },
                          "x2": {
                            "type": "number"
                          },
                          "y1": {
                            "type": "number"
                          },
                          "y2": {
                            "type": "number"
                          }
                        },
                        "required": [
                          "x1",
                          "y1",
                          "x2",
                          "y2"
                        ],
                        "type": "object"
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "observation_sha256": {
                    "pattern": "^[a-f0-9]{64}$",
                    "type": "string"
                  },
                  "page": {
                    "type": "integer"
                  },
                  "quad_points": {},
                  "source_object_id": {
                    "anyOf": [
                      {
                        "type": "string"
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "subtype": {
                    "type": "string"
                  },
                  "target_kind": {
                    "enum": [
                      "external_url",
                      "internal_destination",
                      "action",
                      "none"
                    ],
                    "type": "string"
                  },
                  "target_value": {}
                },
                "required": [
                  "id",
                  "source_object_id",
                  "page",
                  "subtype",
                  "contents",
                  "flags",
                  "native_region",
                  "display_region",
                  "quad_points",
                  "target_kind",
                  "target_value",
                  "observation_sha256"
                ],
                "type": "object"
              },
              "type": "array"
            },
            "observed_count": {
              "type": "integer"
            },
            "truncated": {
              "type": "boolean"
            }
          },
          "required": [
            "encountered_count",
            "observed_count",
            "truncated",
            "items"
          ],
          "type": "object"
        },
        "coverage": {
          "additionalProperties": false,
          "properties": {
            "annotations": {
              "additionalProperties": false,
              "properties": {
                "reason_codes": {
                  "items": {
                    "type": "string"
                  },
                  "type": "array"
                },
                "status": {
                  "enum": [
                    "supported",
                    "partial",
                    "unavailable"
                  ],
                  "type": "string"
                }
              },
              "required": [
                "status",
                "reason_codes"
              ],
              "type": "object"
            },
            "form_fields": {
              "additionalProperties": false,
              "properties": {
                "reason_codes": {
                  "items": {
                    "type": "string"
                  },
                  "type": "array"
                },
                "status": {
                  "enum": [
                    "supported",
                    "partial",
                    "unavailable"
                  ],
                  "type": "string"
                }
              },
              "required": [
                "status",
                "reason_codes"
              ],
              "type": "object"
            },
            "metadata": {
              "additionalProperties": false,
              "properties": {
                "reason_codes": {
                  "items": {
                    "type": "string"
                  },
                  "type": "array"
                },
                "status": {
                  "enum": [
                    "supported",
                    "partial",
                    "unavailable"
                  ],
                  "type": "string"
                }
              },
              "required": [
                "status",
                "reason_codes"
              ],
              "type": "object"
            },
            "pages": {
              "additionalProperties": false,
              "properties": {
                "reason_codes": {
                  "items": {
                    "type": "string"
                  },
                  "type": "array"
                },
                "status": {
                  "enum": [
                    "supported",
                    "partial",
                    "unavailable"
                  ],
                  "type": "string"
                }
              },
              "required": [
                "status",
                "reason_codes"
              ],
              "type": "object"
            }
          },
          "required": [
            "pages",
            "metadata",
            "form_fields",
            "annotations"
          ],
          "type": "object"
        },
        "form_fields": {
          "additionalProperties": false,
          "properties": {
            "field_object_count": {
              "type": "integer"
            },
            "items": {
              "items": {
                "additionalProperties": false,
                "properties": {
                  "appearance_state": {},
                  "default_value": {},
                  "flags": {
                    "type": "integer"
                  },
                  "id": {
                    "pattern": "^field-[a-f0-9]{64}$",
                    "type": "string"
                  },
                  "name": {
                    "type": "string"
                  },
                  "observation_sha256": {
                    "pattern": "^[a-f0-9]{64}$",
                    "type": "string"
                  },
                  "options": {
                    "items": {},
                    "type": "array"
                  },
                  "record_kind": {
                    "enum": [
                      "field",
                      "unmatched_widget"
                    ],
                    "type": "string"
                  },
                  "rotation": {
                    "type": "number"
                  },
                  "source_object_id": {
                    "anyOf": [
                      {
                        "type": "string"
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "type": {
                    "type": "string"
                  },
                  "value": {},
                  "value_sha256": {
                    "pattern": "^[a-f0-9]{64}$",
                    "type": "string"
                  },
                  "widget_display_region": {
                    "anyOf": [
                      {
                        "additionalProperties": false,
                        "properties": {
                          "height": {
                            "type": "number"
                          },
                          "width": {
                            "type": "number"
                          },
                          "x": {
                            "type": "number"
                          },
                          "y": {
                            "type": "number"
                          }
                        },
                        "required": [
                          "x",
                          "y",
                          "width",
                          "height"
                        ],
                        "type": "object"
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "widget_native_region": {
                    "anyOf": [
                      {
                        "additionalProperties": false,
                        "properties": {
                          "x1": {
                            "type": "number"
                          },
                          "x2": {
                            "type": "number"
                          },
                          "y1": {
                            "type": "number"
                          },
                          "y2": {
                            "type": "number"
                          }
                        },
                        "required": [
                          "x1",
                          "y1",
                          "x2",
                          "y2"
                        ],
                        "type": "object"
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "widget_page": {
                    "anyOf": [
                      {
                        "type": "integer"
                      },
                      {
                        "type": "null"
                      }
                    ]
                  }
                },
                "required": [
                  "id",
                  "record_kind",
                  "source_object_id",
                  "name",
                  "type",
                  "value",
                  "default_value",
                  "flags",
                  "options",
                  "widget_page",
                  "widget_native_region",
                  "widget_display_region",
                  "appearance_state",
                  "rotation",
                  "value_sha256",
                  "observation_sha256"
                ],
                "type": "object"
              },
              "type": "array"
            },
            "matched_widget_count": {
              "type": "integer"
            },
            "observed_count": {
              "type": "integer"
            },
            "omitted_widget_count": {
              "type": "integer"
            },
            "total_count": {
              "type": "integer"
            },
            "truncated": {
              "type": "boolean"
            },
            "unmatched_widget_count": {
              "type": "integer"
            },
            "widget_count": {
              "type": "integer"
            }
          },
          "required": [
            "field_object_count",
            "total_count",
            "observed_count",
            "truncated",
            "widget_count",
            "matched_widget_count",
            "unmatched_widget_count",
            "omitted_widget_count",
            "items"
          ],
          "type": "object"
        },
        "limitations": {
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        "limits": {
          "additionalProperties": false,
          "properties": {
            "max_annotations": {
              "const": 500
            },
            "max_fields": {
              "const": 500
            },
            "max_metadata_characters": {
              "const": 32768
            },
            "max_output_characters": {
              "maximum": 200000,
              "minimum": 20000,
              "type": "integer"
            },
            "max_pages": {
              "maximum": 200,
              "minimum": 1,
              "type": "integer"
            }
          },
          "required": [
            "max_pages",
            "max_fields",
            "max_annotations",
            "max_metadata_characters",
            "max_output_characters"
          ],
          "type": "object"
        },
        "metadata": {
          "additionalProperties": false,
          "properties": {
            "disagreements": {
              "items": {
                "additionalProperties": false,
                "properties": {
                  "info_value_sha256": {
                    "pattern": "^[a-f0-9]{64}$",
                    "type": "string"
                  },
                  "property": {
                    "type": "string"
                  },
                  "xmp_value_sha256": {
                    "pattern": "^[a-f0-9]{64}$",
                    "type": "string"
                  }
                },
                "required": [
                  "property",
                  "info_value_sha256",
                  "xmp_value_sha256"
                ],
                "type": "object"
              },
              "type": "array"
            },
            "disagreements_truncated": {
              "type": "boolean"
            },
            "info": {
              "additionalProperties": false,
              "properties": {
                "omitted_key_count": {
                  "type": "integer"
                },
                "omitted_keys": {
                  "items": {
                    "type": "string"
                  },
                  "type": "array"
                },
                "omitted_keys_truncated": {
                  "type": "boolean"
                },
                "truncated": {
                  "type": "boolean"
                },
                "values": {
                  "additionalProperties": true,
                  "type": "object"
                }
              },
              "required": [
                "values",
                "omitted_keys",
                "omitted_key_count",
                "omitted_keys_truncated",
                "truncated"
              ],
              "type": "object"
            },
            "observation_sha256": {
              "pattern": "^[a-f0-9]{64}$",
              "type": "string"
            },
            "xmp": {
              "additionalProperties": false,
              "properties": {
                "omitted_key_count": {
                  "type": "integer"
                },
                "omitted_keys": {
                  "items": {
                    "type": "string"
                  },
                  "type": "array"
                },
                "omitted_keys_truncated": {
                  "type": "boolean"
                },
                "truncated": {
                  "type": "boolean"
                },
                "values": {
                  "additionalProperties": true,
                  "type": "object"
                }
              },
              "required": [
                "values",
                "omitted_keys",
                "omitted_key_count",
                "omitted_keys_truncated",
                "truncated"
              ],
              "type": "object"
            }
          },
          "required": [
            "info",
            "xmp",
            "disagreements",
            "disagreements_truncated",
            "observation_sha256"
          ],
          "type": "object"
        },
        "observation_sha256": {
          "pattern": "^[a-f0-9]{64}$",
          "type": "string"
        },
        "pages": {
          "additionalProperties": false,
          "properties": {
            "items": {
              "items": {
                "additionalProperties": false,
                "properties": {
                  "coordinate_space": {
                    "const": "pdf_user_space_bottom_left_points"
                  },
                  "crop_box": {
                    "items": {
                      "type": "number"
                    },
                    "maxItems": 4,
                    "minItems": 4,
                    "type": "array"
                  },
                  "geometry_source": {
                    "enum": [
                      "pdf-lib",
                      "pdfjs-view-fallback"
                    ],
                    "type": "string"
                  },
                  "height_points": {
                    "type": "number"
                  },
                  "media_box": {
                    "anyOf": [
                      {
                        "items": {
                          "type": "number"
                        },
                        "maxItems": 4,
                        "minItems": 4,
                        "type": "array"
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "observation_sha256": {
                    "pattern": "^[a-f0-9]{64}$",
                    "type": "string"
                  },
                  "page": {
                    "type": "integer"
                  },
                  "rotation": {
                    "type": "number"
                  },
                  "user_unit": {
                    "type": "number"
                  },
                  "width_points": {
                    "type": "number"
                  }
                },
                "required": [
                  "page",
                  "geometry_source",
                  "media_box",
                  "crop_box",
                  "width_points",
                  "height_points",
                  "rotation",
                  "user_unit",
                  "coordinate_space",
                  "observation_sha256"
                ],
                "type": "object"
              },
              "type": "array"
            },
            "observed_count": {
              "type": "integer"
            },
            "total_count": {
              "type": "integer"
            },
            "truncated": {
              "type": "boolean"
            }
          },
          "required": [
            "total_count",
            "observed_count",
            "truncated",
            "items"
          ],
          "type": "object"
        },
        "parser": {
          "additionalProperties": false,
          "properties": {
            "name": {
              "const": "pdfjs-dist"
            },
            "version": {
              "const": "5.4.624"
            }
          },
          "required": [
            "name",
            "version"
          ],
          "type": "object"
        },
        "schema_version": {
          "const": "1.0"
        },
        "source": {
          "additionalProperties": false,
          "properties": {
            "canonical_path": {
              "type": "string"
            },
            "file_name": {
              "type": "string"
            },
            "identity_method": {
              "const": "race_aware_descriptor_sha256"
            },
            "sha256": {
              "pattern": "^[a-f0-9]{64}$",
              "type": "string"
            },
            "size_bytes": {
              "type": "integer"
            }
          },
          "required": [
            "canonical_path",
            "file_name",
            "size_bytes",
            "sha256",
            "identity_method"
          ],
          "type": "object"
        },
        "status": {
          "enum": [
            "complete",
            "partial"
          ],
          "type": "string"
        }
      },
      "required": [
        "schema_version",
        "status",
        "source",
        "parser",
        "coverage",
        "limits",
        "pages",
        "metadata",
        "form_fields",
        "annotations",
        "limitations",
        "observation_sha256"
      ],
      "type": "object"
    },
    {
      "additionalProperties": false,
      "properties": {
        "error": {
          "additionalProperties": false,
          "properties": {
            "code": {
              "enum": [
                "internal_validation_error",
                "path_policy_denied",
                "tool_execution_failed"
              ],
              "type": "string"
            },
            "error_schema_version": {
              "const": 1
            }
          },
          "required": [
            "error_schema_version",
            "code"
          ],
          "type": "object"
        },
        "status": {
          "const": "failed"
        }
      },
      "required": [
        "status",
        "error"
      ],
      "type": "object"
    },
    {
      "additionalProperties": false,
      "properties": {
        "error": {
          "additionalProperties": false,
          "properties": {
            "code": {
              "enum": [
                "PASSWORD_REQUIRED",
                "PASSWORD_INCORRECT"
              ],
              "type": "string"
            },
            "error_schema_version": {
              "const": 1
            }
          },
          "required": [
            "error_schema_version",
            "code"
          ],
          "type": "object"
        },
        "status": {
          "const": "failed"
        }
      },
      "required": [
        "status",
        "error"
      ],
      "type": "object"
    },
    {
      "additionalProperties": false,
      "properties": {
        "error": {
          "additionalProperties": false,
          "properties": {
            "code": {
              "const": "PDF_RESOURCE_LIMIT_EXCEEDED"
            },
            "error_schema_version": {
              "const": 1
            }
          },
          "required": [
            "error_schema_version",
            "code"
          ],
          "type": "object"
        },
        "status": {
          "const": "failed"
        }
      },
      "required": [
        "status",
        "error"
      ],
      "type": "object"
    },
    {
      "additionalProperties": false,
      "properties": {
        "error": {
          "additionalProperties": false,
          "properties": {
            "code": {
              "enum": [
                "PDF_CHANGED_DURING_READ",
                "PDF_INPUT_TOO_LARGE",
                "PDF_INVALID_HEADER",
                "PDF_UNAVAILABLE"
              ],
              "type": "string"
            },
            "error_schema_version": {
              "const": 1
            }
          },
          "required": [
            "error_schema_version",
            "code"
          ],
          "type": "object"
        },
        "status": {
          "const": "failed"
        }
      },
      "required": [
        "status",
        "error"
      ],
      "type": "object"
    }
  ],
  "type": "object"
}
sha256:c6c59e980ddd85d36630db58956ef5763d74e303565eb3959a7751c46e128749

Description hash: sha256:28d2f85e51cf99750340fd846c1abd77a7a1bf24db7ac85aa43ad5b803b19176

Interface hash: sha256:39aedd70cfbeb0817465f5601ff2e108ee758ccd755af6d9125818226c0c00e0

Other observed Modelara metadata
{
  "id": "mcp:pdf-tools/get_pdf_info",
  "title": "Get PDF Info",
  "source": {
    "type": "mcp",
    "server": "pdf-tools",
    "operation": "get_pdf_info"
  },
  "declared": {
    "read_only": "true",
    "destructive": "false",
    "idempotent": "true",
    "open_world": "false"
  },
  "safety": {
    "idempotent": "true",
    "retry_safe": "true"
  },
  "metadata": {
    "mcp.annotations": "present"
  },
  "fingerprint": "sha256:d327b72df736c7d70c04f67383f8f6b119acb07f78f5c5f2f8ed2437e293059e"
}
toolread0.12.1No change observed
get_pdf_resource_uripdf-toolkit:tool:get_pdf_resource_uri
Observed interface and hashes

Return the PDF's `pdf://...` resource URI so Claude-compatible MCP hosts can reference the binary directly through this server's Resources API. Use this when the host supports MCP resources and you want to hand Claude the document itself rather than only extracted text.

Input schema

{
  "examples": [
    {
      "pdf_path": "/Users/alice/Documents/report.pdf"
    }
  ],
  "properties": {
    "pdf_path": {
      "description": "Absolute path to the PDF file.",
      "type": "string"
    }
  },
  "required": [
    "pdf_path"
  ],
  "type": "object"
}
sha256:74b0802d51c99d58ecb00dbe250912af5744b0ef0505b83d636a20af7cd91330

Output schema

{
  "anyOf": [
    {
      "additionalProperties": false,
      "properties": {
        "file_name": {
          "type": "string"
        },
        "pdf_path": {
          "type": "string"
        },
        "size_bytes": {
          "type": "integer"
        },
        "uri": {
          "type": "string"
        }
      },
      "required": [
        "uri",
        "pdf_path",
        "file_name",
        "size_bytes"
      ],
      "type": "object"
    },
    {
      "additionalProperties": false,
      "properties": {
        "error": {
          "additionalProperties": false,
          "properties": {
            "code": {
              "enum": [
                "internal_validation_error",
                "path_policy_denied",
                "tool_execution_failed"
              ],
              "type": "string"
            },
            "error_schema_version": {
              "const": 1
            }
          },
          "required": [
            "error_schema_version",
            "code"
          ],
          "type": "object"
        },
        "status": {
          "const": "failed"
        }
      },
      "required": [
        "status",
        "error"
      ],
      "type": "object"
    }
  ],
  "type": "object"
}
sha256:7e847321de569979c6056f49af3978f6a57547d8f9b972b735588bf2ca5cd8aa

Description hash: sha256:508cbe60774ea8596fdb5bf03cbb7b35da3621f7fbc4e22f28c6503484b890e7

Interface hash: sha256:5fab8818c869940d929d89b33800a763816fa8cf23f51a81842eb4211581df11

Other observed Modelara metadata
{
  "id": "mcp:pdf-tools/get_pdf_resource_uri",
  "title": "Get PDF Resource URI",
  "source": {
    "type": "mcp",
    "server": "pdf-tools",
    "operation": "get_pdf_resource_uri"
  },
  "declared": {
    "read_only": "true",
    "destructive": "false",
    "idempotent": "true",
    "open_world": "false"
  },
  "safety": {
    "idempotent": "true",
    "retry_safe": "true"
  },
  "metadata": {
    "mcp.annotations": "present"
  },
  "fingerprint": "sha256:933d2bbdb1a1383806d6cf6acaca4842b72872d3fcf19522609555e5ad4021cf"
}
toolread0.12.1No change observed
inspect_extraction_statepdf-toolkit:tool:inspect_extraction_state
Observed interface and hashes

Inspect the exact current generation and recovery state of a private verified-extraction workspace.

Input schema

{
  "additionalProperties": false,
  "properties": {
    "workspace_id": {
      "type": "string"
    },
    "workspace_identity_sha256": {
      "pattern": "^[a-f0-9]{64}$",
      "type": "string"
    }
  },
  "required": [
    "workspace_id",
    "workspace_identity_sha256"
  ],
  "type": "object"
}
sha256:cfe248d2b0c02c1c8eb5d8ec687c279e1307e1ab007d00926ab48e04654d9ef0

Output schema

{
  "anyOf": [
    {
      "additionalProperties": false,
      "properties": {
        "abandoned_generations": {
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        "active_transaction_id": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ]
        },
        "complete_generations": {
          "minimum": 0,
          "type": "integer"
        },
        "current_generation_sequence": {
          "anyOf": [
            {
              "minimum": 0,
              "type": "integer"
            },
            {
              "type": "null"
            }
          ]
        },
        "current_generation_sha256": {
          "anyOf": [
            {
              "pattern": "^[a-f0-9]{64}$",
              "type": "string"
            },
            {
              "type": "null"
            }
          ]
        },
        "incomplete_generations": {
          "items": {
            "additionalProperties": false,
            "properties": {
              "name": {
                "type": "string"
              },
              "reason": {
                "anyOf": [
                  {
                    "type": "string"
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "state": {
                "type": "string"
              }
            },
            "required": [
              "name",
              "state",
              "reason"
            ],
            "type": "object"
          },
          "type": "array"
        },
        "retention": {
          "additionalProperties": false,
          "properties": {
            "automatic_pruning": {
              "const": false
            },
            "deletion_requires_exact_current_generation": {
              "const": true
            },
            "maximum_generations": {
              "minimum": 1,
              "type": "integer"
            },
            "remaining_generations": {
              "minimum": 0,
              "type": "integer"
            }
          },
          "required": [
            "maximum_generations",
            "remaining_generations",
            "automatic_pruning",
            "deletion_requires_exact_current_generation"
          ],
          "type": "object"
        },
        "state": {
          "enum": [
            "complete",
            "durability_uncertain",
            "initialization_recovery_required"
          ],
          "type": "string"
        },
        "workspace_id": {
          "type": "string"
        },
        "workspace_identity_sha256": {
          "pattern": "^[a-f0-9]{64}$",
          "type": "string"
        }
      },
      "required": [
        "workspace_id",
        "workspace_identity_sha256",
        "state",
        "current_generation_sha256",
        "current_generation_sequence",
        "complete_generations",
        "incomplete_generations",
        "abandoned_generations",
        "active_transaction_id",
        "retention"
      ],
      "type": "object"
    },
    {
      "additionalProperties": false,
      "properties": {
        "error": {
          "additionalProperties": false,
          "properties": {
            "code": {
              "enum": [
                "internal_validation_error",
                "path_policy_denied",
                "tool_execution_failed"
              ],
              "type": "string"
            },
            "error_schema_version": {
              "const": 1
            }
          },
          "required": [
            "error_schema_version",
            "code"
          ],
          "type": "object"
        },
        "status": {
          "const": "failed"
        }
      },
      "required": [
        "status",
        "error"
      ],
      "type": "object"
    }
  ],
  "type": "object"
}
sha256:328949286da6c7a0b21f67065aa7c7fbf036897f00ce87157a4dacbbb1870963

Description hash: sha256:e0aecfe7d6f7cf7854bcf848d8123930bf35a52c2ffb4d7cb2c5bac3671b2db6

Interface hash: sha256:6629ef195ec538a0d3cbc1a7c56fc2115128639257769dde741e526efd874b81

Other observed Modelara metadata
{
  "id": "mcp:pdf-tools/inspect_extraction_state",
  "title": "Inspect Verified Extraction Workspace",
  "source": {
    "type": "mcp",
    "server": "pdf-tools",
    "operation": "inspect_extraction_state"
  },
  "declared": {
    "read_only": "true",
    "destructive": "false",
    "idempotent": "true",
    "open_world": "false"
  },
  "safety": {
    "idempotent": "true",
    "retry_safe": "true"
  },
  "metadata": {
    "mcp.annotations": "present"
  },
  "fingerprint": "sha256:d3b7fabf93896374ad415a30ed1f713fb207bd35cad4ba75a2dc05e98412268c"
}
toolread0.13.00.13.0
inspect_pdf_accessibilitypdf-toolkit:tool:inspect_pdf_accessibility
Observed interface and hashes

Inspect an unencrypted bounded local PDF for exactly eight shallow catalog-level accessibility signals. Returns exact missing or unavailable observations, a source SHA-256 binding, fixed limitations, and areas requiring qualified human review. This structural review does not run veraPDF, assess tag semantics or assistive-technology behavior, edit the PDF, or establish PDF/UA, WCAG, certification, legal-compliance, or document-accessibility conclusions.

Input schema

{
  "additionalProperties": false,
  "properties": {
    "pdf_path": {
      "description": "Absolute path or ~/ path to the unencrypted local PDF file.",
      "maxLength": 32768,
      "type": "string"
    }
  },
  "required": [
    "pdf_path"
  ],
  "type": "object"
}
sha256:a7c804a038478a0f8ce3a2ec09ed0f4e8db0375b5e839c8869bc61acf063a887

Output schema

{
  "anyOf": [
    {
      "additionalProperties": false,
      "properties": {
        "checks": {
          "items": {
            "additionalProperties": false,
            "properties": {
              "id": {
                "enum": [
                  "parseable_pdf",
                  "catalog_marked_true",
                  "document_language_present",
                  "document_title_present",
                  "display_document_title_true",
                  "structure_tree_root_dictionary_present",
                  "structure_root_k_entry_resolves",
                  "structure_parent_tree_entry_resolves"
                ],
                "type": "string"
              },
              "limitation_code": {
                "enum": [
                  "PARSE_DOES_NOT_ESTABLISH_TAG_SEMANTICS",
                  "MARKED_FLAG_IS_NOT_TAG_QUALITY_EVIDENCE",
                  "LANGUAGE_VALUE_AND_CHANGES_NOT_ASSESSED",
                  "TITLE_MEANING_NOT_ASSESSED",
                  "VIEWER_PREFERENCE_SIGNAL_ONLY",
                  "STRUCTURE_ROOT_CONTENTS_NOT_VALIDATED",
                  "STRUCTURE_HIERARCHY_ROLES_AND_ORDER_NOT_VALIDATED",
                  "PARENT_TREE_NUMBER_TREE_AND_MAPPINGS_NOT_VALIDATED"
                ],
                "type": "string"
              },
              "observation_code": {
                "enum": [
                  "PARSE_SUCCEEDED",
                  "PARSE_FAILED",
                  "TRUE",
                  "FALSE",
                  "NONEMPTY_TEXT",
                  "BLANK_OR_CONTROL_ONLY",
                  "DICTIONARY_PRESENT",
                  "ABSENT_OR_WRONG_TYPE",
                  "ENTRY_RESOLVES",
                  "ENTRY_ABSENT_OR_UNRESOLVED",
                  "NOT_INSPECTED"
                ],
                "type": "string"
              },
              "reason_code": {
                "anyOf": [
                  {
                    "const": "STRICT_PARSE_FAILED"
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "status": {
                "enum": [
                  "observed",
                  "missing",
                  "unavailable"
                ],
                "type": "string"
              }
            },
            "required": [
              "id",
              "status",
              "observation_code",
              "limitation_code",
              "reason_code"
            ],
            "type": "object"
          },
          "maxItems": 8,
          "minItems": 8,
          "type": "array"
        },
        "conclusions": {
          "additionalProperties": false,
          "properties": {
            "certification": {
              "const": "not_established"
            },
            "document_accessibility": {
              "const": "not_established"
            },
            "legal_compliance": {
              "const": "not_established"
            },
            "pdfua_conformance": {
              "const": "not_established"
            },
            "wcag_conformance": {
              "const": "not_established"
            }
          },
          "required": [
            "pdfua_conformance",
            "wcag_conformance",
            "certification",
            "legal_compliance",
            "document_accessibility"
          ],
          "type": "object"
        },
        "engine": {
          "additionalProperties": false,
          "properties": {
            "name": {
              "const": "pdf-tools.structural-review-screen"
            },
            "version": {
              "const": "1.0.0"
            }
          },
          "required": [
            "name",
            "version"
          ],
          "type": "object"
        },
        "human_review": {
          "additionalProperties": false,
          "properties": {
            "status": {
              "const": "required"
            },
            "unresolved_areas": {
              "items": {
                "type": "string"
              },
              "type": "array"
            }
          },
          "required": [
            "status",
            "unresolved_areas"
          ],
          "type": "object"
        },
        "inspection_status": {
          "enum": [
            "complete",
            "partial"
          ],
          "type": "string"
        },
        "limitations": {
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        "machine_profile_validation": {
          "additionalProperties": false,
          "properties": {
            "status": {
              "const": "not_run"
            }
          },
          "required": [
            "status"
          ],
          "type": "object"
        },
        "parser": {
          "additionalProperties": false,
          "properties": {
            "name": {
              "const": "pdf-lib"
            },
            "version": {
              "const": "1.17.1"
            }
          },
          "required": [
            "name",
            "version"
          ],
          "type": "object"
        },
        "result": {
          "enum": [
            "findings_detected",
            "no_findings_detected",
            "indeterminate"
          ],
          "type": "string"
        },
        "schema_version": {
          "const": "pdf-tools.accessibility-inspection-result/1.0.0"
        },
        "self_declared_identification": {
          "additionalProperties": false,
          "properties": {
            "part": {
              "anyOf": [
                {
                  "maximum": 99,
                  "minimum": 1,
                  "type": "integer"
                },
                {
                  "type": "null"
                }
              ]
            },
            "reason_code": {
              "anyOf": [
                {
                  "enum": [
                    "COMPRESSED_METADATA_NOT_INSPECTED",
                    "METADATA_SIZE_LIMIT",
                    "STRICT_PARSE_FAILED"
                  ],
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ]
            },
            "revision": {
              "anyOf": [
                {
                  "maximum": 9999,
                  "minimum": 1,
                  "type": "integer"
                },
                {
                  "type": "null"
                }
              ]
            },
            "status": {
              "enum": [
                "observed",
                "not_observed",
                "unavailable"
              ],
              "type": "string"
            }
          },
          "required": [
            "status",
            "part",
            "revision",
            "reason_code"
          ],
          "type": "object"
        },
        "source": {
          "additionalProperties": false,
          "properties": {
            "file_name": {
              "maxLength": 255,
              "minLength": 1,
              "type": "string"
            },
            "sha256": {
              "pattern": "^[a-f0-9]{64}$",
              "type": "string"
            },
            "size_bytes": {
              "minimum": 1,
              "type": "integer"
            }
          },
          "required": [
            "file_name",
            "size_bytes",
            "sha256"
          ],
          "type": "object"
        },
        "summary": {
          "additionalProperties": false,
          "properties": {
            "missing": {
              "maximum": 8,
              "minimum": 0,
              "type": "integer"
            },
            "observed": {
              "maximum": 8,
              "minimum": 0,
              "type": "integer"
            },
            "text": {
              "type": "string"
            },
            "total": {
              "const": 8
            },
            "unavailable": {
              "maximum": 8,
              "minimum": 0,
              "type": "integer"
            }
          },
          "required": [
            "total",
            "observed",
            "missing",
            "unavailable",
            "text"
          ],
          "type": "object"
        }
      },
      "required": [
        "schema_version",
        "engine",
        "parser",
        "source",
        "inspection_status",
        "result",
        "checks",
        "summary",
        "self_declared_identification",
        "machine_profile_validation",
        "human_review",
        "conclusions",
        "limitations"
      ],
      "type": "object"
    },
    {
      "additionalProperties": false,
      "properties": {
        "error": {
          "additionalProperties": false,
          "properties": {
            "code": {
              "enum": [
                "internal_validation_error",
                "path_policy_denied",
                "tool_execution_failed"
              ],
              "type": "string"
            },
            "error_schema_version": {
              "const": 1
            }
          },
          "required": [
            "error_schema_version",
            "code"
          ],
          "type": "object"
        },
        "status": {
          "const": "failed"
        }
      },
      "required": [
        "status",
        "error"
      ],
      "type": "object"
    },
    {
      "additionalProperties": false,
      "properties": {
        "error": {
          "additionalProperties": false,
          "properties": {
            "code": {
              "const": "PDF_RESOURCE_LIMIT_EXCEEDED"
            },
            "error_schema_version": {
              "const": 1
            }
          },
          "required": [
            "error_schema_version",
            "code"
          ],
          "type": "object"
        },
        "status": {
          "const": "failed"
        }
      },
      "required": [
        "status",
        "error"
      ],
      "type": "object"
    },
    {
      "additionalProperties": false,
      "properties": {
        "error": {
          "additionalProperties": false,
          "properties": {
            "code": {
              "enum": [
                "PDF_CHANGED_DURING_READ",
                "PDF_INPUT_TOO_LARGE",
                "PDF_INVALID_HEADER",
                "PDF_UNAVAILABLE"
              ],
              "type": "string"
            },
            "error_schema_version": {
              "const": 1
            }
          },
          "required": [
            "error_schema_version",
            "code"
          ],
          "type": "object"
        },
        "status": {
          "const": "failed"
        }
      },
      "required": [
        "status",
        "error"
      ],
      "type": "object"
    },
    {
      "additionalProperties": false,
      "properties": {
        "error": {
          "additionalProperties": false,
          "properties": {
            "code": {
              "enum": [
                "PDF_ACCESSIBILITY_INSPECTION_UNAVAILABLE",
                "PDF_ENCRYPTED_INSPECTION_UNAVAILABLE"
              ],
              "type": "string"
            },
            "error_schema_version": {
              "const": 1
            }
          },
          "required": [
            "error_schema_version",
            "code"
          ],
          "type": "object"
        },
        "status": {
          "const": "failed"
        }
      },
      "required": [
        "status",
        "error"
      ],
      "type": "object"
    }
  ],
  "type": "object"
}
sha256:331ba09a9b296bac74947d968bfece067fbfbc71b8bf87230631fbc5752a645c

Description hash: sha256:5d8fe56b31a0640ca2ddbe09363532a9f62301e02ea475877c708d1a272143ac

Interface hash: sha256:a5eaede739b8dee0ce25c5c4b6d42e26f718e50328bfc3327a44669eff48a3d8

Other observed Modelara metadata
{
  "id": "mcp:pdf-tools/inspect_pdf_accessibility",
  "title": "Inspect PDF Accessibility Signals",
  "source": {
    "type": "mcp",
    "server": "pdf-tools",
    "operation": "inspect_pdf_accessibility"
  },
  "declared": {
    "read_only": "true",
    "destructive": "false",
    "idempotent": "true",
    "open_world": "false"
  },
  "safety": {
    "idempotent": "true",
    "retry_safe": "true"
  },
  "metadata": {
    "mcp.annotations": "present"
  },
  "fingerprint": "sha256:51151e4a4aa708219aff22b90f2352054c4d206500ea0b76714c1cbd753e6e10"
}
toolread0.12.1No change observed
list_pdfspdf-toolkit:tool:list_pdfs
Observed interface and hashes

List PDF files in a directory, sorted by name, returning at most 200 paths per call and reporting the true total when more exist. Use offset to page through a folder with more than 200 PDFs. This tool operates on the user's local filesystem — all paths must be absolute paths on the user's machine (e.g. /Users/name/Documents/), NOT paths on Claude's container (/mnt/...).

Input schema

{
  "properties": {
    "directory": {
      "description": "Directory path to search for PDFs. Defaults to the configured PDFs folder. Must be a local filesystem path.",
      "type": "string"
    },
    "offset": {
      "description": "Skip this many PDFs before listing. Use it to page through a folder holding more than 200 PDFs; the response reports the true total.",
      "minimum": 0,
      "type": "integer"
    }
  },
  "type": "object"
}
sha256:cd7a5bcc15388b14d94e2a2b177ee609fd3b7de2e6f1b9c9edb42305546f0489

Output schema

Not exposed in the analyzed interface.

sha256:398b676e47d03a29016ee92fe378b8b4f1b3e965390c4c64ce78d27f79df74d1

Description hash: sha256:88daace2602c3dfca0762edc3d34e86a20ded004ade6b5cff52304c7da79a632

Interface hash: sha256:7282cbba52a50e1a3d161134bd39c39f96a0d474ce95c8d821652f84564e8c65

Other observed Modelara metadata
{
  "id": "mcp:pdf-tools/list_pdfs",
  "title": "List PDF Files",
  "source": {
    "type": "mcp",
    "server": "pdf-tools",
    "operation": "list_pdfs"
  },
  "declared": {
    "read_only": "true",
    "destructive": "false",
    "idempotent": "true",
    "open_world": "false"
  },
  "safety": {
    "idempotent": "true",
    "retry_safe": "true"
  },
  "metadata": {
    "mcp.annotations": "present"
  },
  "fingerprint": "sha256:41ad3db88ba984a2ecbb32c39e9f17c3cc35dd031511b541dfddeb3e1b068ac2"
}
toolread0.12.1No change observed
list_profilespdf-toolkit:tool:list_profiles
Observed interface and hashes

List all saved profiles

Input schema

{
  "properties": {},
  "type": "object"
}
sha256:3178d649f32f96ea850da50c27c062f5c20cbef86dec2f5af0587dff56ebdb67

Output schema

Not exposed in the analyzed interface.

sha256:398b676e47d03a29016ee92fe378b8b4f1b3e965390c4c64ce78d27f79df74d1

Description hash: sha256:5f094a2bb579d63a5c8fe7f3ed9a99685d0c20254cf493e97316997c4d6e8731

Interface hash: sha256:2e127e053a340c72ee6a827a6fb32275bea32f5b6f43bc2e95130165f33ff127

Other observed Modelara metadata
{
  "id": "mcp:pdf-tools/list_profiles",
  "title": "List Saved Profiles",
  "source": {
    "type": "mcp",
    "server": "pdf-tools",
    "operation": "list_profiles"
  },
  "declared": {
    "read_only": "true",
    "destructive": "false",
    "idempotent": "true",
    "open_world": "false"
  },
  "safety": {
    "idempotent": "true",
    "retry_safe": "true"
  },
  "metadata": {
    "mcp.annotations": "present"
  },
  "fingerprint": "sha256:cc85ed119463b17ea48d13b3ed0dd4c9c60141cdb795553a3a80d45b3ceccd79"
}
toolread0.12.1No change observed
list_signaturespdf-toolkit:tool:list_signatures
Observed interface and hashes

List all saved signatures in ~/.pdf-toolkit-files/signatures/. Returns each signature's name, style (typed or image), display name (for typed), and creation timestamp.

Input schema

{
  "properties": {},
  "type": "object"
}
sha256:3178d649f32f96ea850da50c27c062f5c20cbef86dec2f5af0587dff56ebdb67

Output schema

{
  "anyOf": [
    {
      "additionalProperties": false,
      "properties": {
        "malformed": {
          "items": {
            "additionalProperties": false,
            "properties": {
              "file": {
                "type": "string"
              }
            },
            "required": [
              "file"
            ],
            "type": "object"
          },
          "type": "array"
        },
        "signatures": {
          "items": {
            "additionalProperties": false,
            "properties": {
              "created_at": {
                "anyOf": [
                  {
                    "type": "string"
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "display_name": {
                "anyOf": [
                  {
                    "type": "string"
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "name": {
                "type": "string"
              },
              "style": {
                "enum": [
                  "typed",
                  "image"
                ],
                "type": "string"
              }
            },
            "required": [
              "name",
              "style",
              "display_name",
              "created_at"
            ],
            "type": "object"
          },
          "type": "array"
        },
        "unreadable": {
          "items": {
            "additionalProperties": false,
            "properties": {
              "code": {
                "anyOf": [
                  {
                    "type": "string"
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "file": {
                "type": "string"
              }
            },
            "required": [
              "file",
              "code"
            ],
            "type": "object"
          },
          "type": "array"
        }
      },
      "required": [
        "signatures",
        "unreadable",
        "malformed"
      ],
      "type": "object"
    },
    {
      "additionalProperties": false,
      "properties": {
        "error": {
          "additionalProperties": false,
          "properties": {
            "code": {
              "enum": [
                "internal_validation_error",
                "path_policy_denied",
                "tool_execution_failed"
              ],
              "type": "string"
            },
            "error_schema_version": {
              "const": 1
            }
          },
          "required": [
            "error_schema_version",
            "code"
          ],
          "type": "object"
        },
        "status": {
          "const": "failed"
        }
      },
      "required": [
        "status",
        "error"
      ],
      "type": "object"
    }
  ],
  "type": "object"
}
sha256:a84575748697005dba75e989ba5530be9ae847fc1790c9d1bdb0cdc3694e2bef

Description hash: sha256:051a6495c761c830a987d923bdbfea4b2aad9e1c2bcf54f9988294610784d964

Interface hash: sha256:71e30630b849ea3b0a08bf8bd2b0facdef5cb3b2b57c45c823ce6d54b6e1914b

Other observed Modelara metadata
{
  "id": "mcp:pdf-tools/list_signatures",
  "title": "List Signatures",
  "source": {
    "type": "mcp",
    "server": "pdf-tools",
    "operation": "list_signatures"
  },
  "declared": {
    "read_only": "true",
    "destructive": "false",
    "idempotent": "true",
    "open_world": "false"
  },
  "safety": {
    "idempotent": "true",
    "retry_safe": "true"
  },
  "metadata": {
    "mcp.annotations": "present"
  },
  "fingerprint": "sha256:ec0a092c361acdbda09b098ab61d7ee102ea1b11f5fb38ff4e765401ad0a6323"
}
toolread0.12.10.14.0
load_profilepdf-toolkit:tool:load_profile
Observed interface and hashes

Load a saved profile

Input schema

{
  "properties": {
    "profile_name": {
      "description": "Name of the profile to load",
      "type": "string"
    }
  },
  "required": [
    "profile_name"
  ],
  "type": "object"
}
sha256:8fa79013477fded0d0fa44e2a56c123c696b514883f64390ca1187d572dc6b6e

Output schema

Not exposed in the analyzed interface.

sha256:398b676e47d03a29016ee92fe378b8b4f1b3e965390c4c64ce78d27f79df74d1

Description hash: sha256:96c6ddc5970bc295a8c1956416ac38c205111329c87d8ea6ddfc424c6c673426

Interface hash: sha256:cfcf3f25e61d3ece0eebd82fc64fef0af0d6dc7420849d74c7c25b4d8461b7c0

Other observed Modelara metadata
{
  "id": "mcp:pdf-tools/load_profile",
  "title": "Load Form Profile",
  "source": {
    "type": "mcp",
    "server": "pdf-tools",
    "operation": "load_profile"
  },
  "declared": {
    "read_only": "true",
    "destructive": "false",
    "idempotent": "true",
    "open_world": "false"
  },
  "safety": {
    "idempotent": "true",
    "retry_safe": "true"
  },
  "metadata": {
    "mcp.annotations": "present"
  },
  "fingerprint": "sha256:a4d467ce950cbb107cfd6085db18d62c8ed832bdaf935b8353a4ad2a624a8fd3"
}
toolread0.12.1No change observed
load_signaturepdf-toolkit:tool:load_signature
Observed interface and hashes

Load one saved signature by name. Returns the style, display name, and for image signatures a preview data URL so the viewer can render the selected asset on demand.

Input schema

{
  "properties": {
    "signature_name": {
      "description": "Name of a previously-saved signature.",
      "type": "string"
    }
  },
  "required": [
    "signature_name"
  ],
  "type": "object"
}
sha256:2d55be72d9ef406a34b743425e2eb32e29652df2cb8dca3187803048165d8233

Output schema

{
  "anyOf": [
    {
      "additionalProperties": false,
      "properties": {
        "created_at": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ]
        },
        "display_name": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ]
        },
        "name": {
          "type": "string"
        },
        "preview_data_url": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ]
        },
        "style": {
          "enum": [
            "typed",
            "image"
          ],
          "type": "string"
        }
      },
      "required": [
        "name",
        "style",
        "display_name",
        "preview_data_url",
        "created_at"
      ],
      "type": "object"
    },
    {
      "additionalProperties": false,
      "properties": {
        "error": {
          "additionalProperties": false,
          "properties": {
            "code": {
              "enum": [
                "internal_validation_error",
                "path_policy_denied",
                "tool_execution_failed"
              ],
              "type": "string"
            },
            "error_schema_version": {
              "const": 1
            }
          },
          "required": [
            "error_schema_version",
            "code"
          ],
          "type": "object"
        },
        "status": {
          "const": "failed"
        }
      },
      "required": [
        "status",
        "error"
      ],
      "type": "object"
    }
  ],
  "type": "object"
}
sha256:1e6bc3ea2cd41ee1637a3e03c1b629ea54f0044d914cb0479783444c0983a44e

Description hash: sha256:f0b010dae591f0845db776ebb3f4ae7c4a661980d509520328d8530e3980d787

Interface hash: sha256:dd16cd2013fc0382d323d7b645dff606a58ebf399d70989c1ce376eaaace957a

Other observed Modelara metadata
{
  "id": "mcp:pdf-tools/load_signature",
  "title": "Load Signature",
  "source": {
    "type": "mcp",
    "server": "pdf-tools",
    "operation": "load_signature"
  },
  "declared": {
    "read_only": "true",
    "destructive": "false",
    "idempotent": "true",
    "open_world": "false"
  },
  "safety": {
    "idempotent": "true",
    "retry_safe": "true"
  },
  "metadata": {
    "mcp.annotations": "present"
  },
  "fingerprint": "sha256:01aa35edb2ffcad44f50eeae197da619ee7221c1bb48fb4892ee25746f0cbbeb"
}
toolread0.12.1No change observed
merge_pdfspdf-toolkit:tool:merge_pdfs
Observed interface and hashes

Merge multiple PDF files into a single PDF. For multi-input merges, descriptive metadata is preserved only when every input asserts the same value; conflicting, partial, or invalid Title, Author, Subject, and Keywords claims are omitted rather than misattributed. New outputs commit atomically. Replacing a distinct existing output requires its exact current expected_output_identity. All paths must be absolute paths on the user's local machine.

Input schema

{
  "properties": {
    "expected_output_identity": {
      "additionalProperties": false,
      "description": "Exact current identity returned by get_pdf_identity. Required when replacing a distinct existing output_path, optional for the separately guarded same-document backup workflow, and omitted for a new destination.",
      "properties": {
        "canonical_path": {
          "description": "Exact canonical_path returned by get_pdf_identity for the existing destination.",
          "type": "string"
        },
        "sha256": {
          "description": "Exact SHA-256 returned by get_pdf_identity for the existing destination.",
          "pattern": "^[a-f0-9]{64}$",
          "type": "string"
        },
        "size_bytes": {
          "description": "Exact size_bytes returned by get_pdf_identity for the existing destination.",
          "minimum": 0,
          "type": "integer"
        }
      },
      "required": [
        "canonical_path",
        "size_bytes",
        "sha256"
      ],
      "type": "object"
    },
    "input_paths": {
      "description": "Array of PDF file paths to merge (in order)",
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "output_path": {
      "description": "Path where the merged PDF will be saved",
      "type": "string"
    },
    "password": {
      "description": "Password for an encrypted PDF. Supply the user or owner password and the document is decrypted in memory, changed, and then saved with exactly the encryption and permissions it already had (encrypted inputs are limited to 16 MiB). The protection is never removed, changed, or added by this tool. Leave it unset for an unencrypted document. If the document's own permissions deny the change being made, the owner password is required, because that is the credential which authorises overriding them.",
      "type": "string"
    }
  },
  "required": [
    "input_paths",
    "output_path"
  ],
  "type": "object"
}
sha256:66139f1a4a8b2e793b9891be1a8a746fcff3ae3d6d57eec2554c82f5acbda728

Output schema

{
  "anyOf": [
    {
      "additionalProperties": false,
      "properties": {
        "active_path": {
          "type": "string"
        },
        "backup_path": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ]
        },
        "fieldCount": {
          "type": "integer"
        },
        "fields": {
          "items": {
            "additionalProperties": false,
            "properties": {
              "currentValue": {
                "anyOf": [
                  {
                    "type": "string"
                  },
                  {
                    "type": "boolean"
                  },
                  {
                    "items": {
                      "type": "string"
                    },
                    "type": "array"
                  }
                ]
              },
              "name": {
                "type": "string"
              },
              "options": {
                "items": {
                  "type": "string"
                },
                "type": "array"
              },
              "type": {
                "enum": [
                  "text",
                  "checkbox",
                  "radio",
                  "dropdown",
                  "unknown"
                ],
                "type": "string"
              }
            },
            "required": [
              "name",
              "type",
              "options",
              "currentValue"
            ],
            "type": "object"
          },
          "type": "array"
        },
        "hasFormFields": {
          "type": "boolean"
        },
        "initialPage": {
          "type": "integer"
        },
        "last_mutation_at": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ]
        },
        "last_mutation_tool": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ]
        },
        "metadata_fields_omitted": {
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        "pdfPath": {
          "type": "string"
        },
        "totalBytes": {
          "type": "integer"
        },
        "total_pages": {
          "type": "integer"
        }
      },
      "required": [
        "pdfPath",
        "totalBytes",
        "initialPage",
        "fields",
        "fieldCount",
        "hasFormFields",
        "active_path",
        "backup_path",
        "last_mutation_tool",
        "last_mutation_at",
        "total_pages",
        "metadata_fields_omitted"
      ],
      "type": "object"
    },
    {
      "additionalProperties": false,
      "properties": {
        "error": {
          "additionalProperties": false,
          "properties": {
            "code": {
              "enum": [
                "internal_validation_error",
                "path_policy_denied",
                "tool_execution_failed"
              ],
              "type": "string"
            },
            "error_schema_version": {
              "const": 1
            }
          },
          "required": [
            "error_schema_version",
            "code"
          ],
          "type": "object"
        },
        "status": {
          "const": "failed"
        }
      },
      "required": [
        "status",
        "error"
      ],
      "type": "object"
    },
    {
      "additionalProperties": false,
      "properties": {
        "error": {
          "additionalProperties": false,
          "properties": {
            "code": {
              "const": "PDF_RESOURCE_LIMIT_EXCEEDED"
            },
            "error_schema_version": {
              "const": 1
            }
          },
          "required": [
            "error_schema_version",
            "code"
          ],
          "type": "object"
        },
        "status": {
          "const": "failed"
        }
      },
      "required": [
        "status",
        "error"
      ],
      "type": "object"
    }
  ],
  "type": "object"
}
sha256:c8c1c16b5bfdf2332748a8856c4c8e574a1176551417f58e29193775bad95dc5

Description hash: sha256:413bd0ee737fa4c331f208ff21afae6b0cc03d0850e8f1bf94ea6499950bacd4

Interface hash: sha256:d10b7d0d36a1575ba1bebc5a2518b68a49546003fa8be5341375adc41a415aad

Other observed Modelara metadata
{
  "id": "mcp:pdf-tools/merge_pdfs",
  "title": "Merge PDFs",
  "source": {
    "type": "mcp",
    "server": "pdf-tools",
    "operation": "merge_pdfs"
  },
  "declared": {
    "read_only": "false",
    "destructive": "true",
    "idempotent": "true",
    "open_world": "false"
  },
  "safety": {
    "idempotent": "true",
    "retry_safe": "unknown"
  },
  "metadata": {
    "mcp.annotations": "present"
  },
  "fingerprint": "sha256:cbc4712a9729fe33f865392f4ca061c40ef5b5ea17ccb1c62903248e801442af"
}
tooldestructive0.12.1No change observed
prepare_lumin_requestpdf-toolkit:tool:prepare_lumin_request
Observed interface and hashes

Prepare and preview a Lumin signing request locally. Requires a provider-ready receipt from prepare_signing_packet. This validates the exact prepared PDF, recipients, and expiry, then returns the disclosure and exact confirmation text required for sending. It does not contact Lumin or send anything.

Input schema

{
  "additionalProperties": false,
  "properties": {
    "authorization_session_id": {
      "description": "Connected Lumin session returned by finish_lumin_authorization. The prepared confirmation is bound to this session.",
      "type": "string"
    },
    "expires_at": {
      "description": "ISO-8601 time after which the Lumin request expires.",
      "format": "date-time",
      "type": "string"
    },
    "pdf_path": {
      "description": "Exact prepared PDF path returned by prepare_signing_packet.",
      "type": "string"
    },
    "preparation_receipt": {
      "description": "Exact preparation_receipt returned by prepare_signing_packet.",
      "type": "object"
    },
    "signers": {
      "items": {
        "additionalProperties": false,
        "properties": {
          "email_address": {
            "maxLength": 320,
            "type": "string"
          },
          "name": {
            "maxLength": 255,
            "type": "string"
          },
          "participant_id": {
            "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]{0,127}$",
            "type": "string"
          }
        },
        "required": [
          "participant_id",
          "name",
          "email_address"
        ],
        "type": "object"
      },
      "maxItems": 100,
      "minItems": 1,
      "type": "array"
    },
    "title": {
      "description": "Title recipients will see in Lumin.",
      "maxLength": 255,
      "type": "string"
    },
    "viewers": {
      "items": {
        "additionalProperties": false,
        "properties": {
          "email_address": {
            "maxLength": 320,
            "type": "string"
          },
          "name": {
            "maxLength": 255,
            "type": "string"
          },
          "participant_id": {
            "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]{0,127}$",
            "type": "string"
          }
        },
        "required": [
          "participant_id",
          "name",
          "email_address"
        ],
        "type": "object"
      },
      "maxItems": 100,
      "type": "array"
    }
  },
  "required": [
    "pdf_path",
    "preparation_receipt",
    "authorization_session_id",
    "title",
    "expires_at",
    "signers"
  ],
  "type": "object"
}
sha256:5440e20ca47980bb799fa06c78e81102f8d2f156b47da66eec2786d57d129a27

Output schema

{
  "anyOf": [
    {
      "additionalProperties": false,
      "properties": {
        "authorization_session_id": {
          "type": "string"
        },
        "confirmation_expires_at": {
          "type": "string"
        },
        "confirmation_sha256": {
          "pattern": "^[a-f0-9]{64}$",
          "type": "string"
        },
        "confirmation_statement_required": {
          "type": "string"
        },
        "disclosure": {
          "type": "string"
        },
        "pdf_sent": {
          "const": false
        },
        "prepared_document": {
          "additionalProperties": false,
          "properties": {
            "canonical_path": {
              "type": "string"
            },
            "sha256": {
              "pattern": "^[a-f0-9]{64}$",
              "type": "string"
            },
            "size_bytes": {
              "type": "integer"
            }
          },
          "required": [
            "canonical_path",
            "size_bytes",
            "sha256"
          ],
          "type": "object"
        },
        "provider": {
          "const": "lumin_sign"
        },
        "provider_contacted": {
          "const": false
        },
        "request_expires_at": {
          "type": "string"
        },
        "request_preparation_id": {
          "type": "string"
        },
        "signers": {
          "items": {
            "additionalProperties": false,
            "properties": {
              "email_address": {
                "type": "string"
              },
              "name": {
                "type": "string"
              },
              "participant_id": {
                "type": "string"
              }
            },
            "required": [
              "participant_id",
              "name",
              "email_address"
            ],
            "type": "object"
          },
          "type": "array"
        },
        "status": {
          "const": "ready_for_user_confirmation"
        },
        "title": {
          "type": "string"
        },
        "viewers": {
          "items": {
            "additionalProperties": false,
            "properties": {
              "email_address": {
                "type": "string"
              },
              "name": {
                "type": "string"
              },
              "participant_id": {
                "type": "string"
              }
            },
            "required": [
              "participant_id",
              "name",
              "email_address"
            ],
            "type": "object"
          },
          "type": "array"
        }
      },
      "required": [
        "status",
        "provider",
        "request_preparation_id",
        "authorization_session_id",
        "confirmation_sha256",
        "confirmation_expires_at",
        "disclosure",
        "confirmation_statement_required",
        "prepared_document",
        "title",
        "request_expires_at",
        "signers",
        "viewers",
        "provider_contacted",
        "pdf_sent"
      ],
      "type": "object"
    },
    {
      "additionalProperties": false,
      "properties": {
        "error": {
          "additionalProperties": false,
          "properties": {
            "code": {
              "enum": [
                "internal_validation_error",
                "path_policy_denied",
                "tool_execution_failed"
              ],
              "type": "string"
            },
            "error_schema_version": {
              "const": 1
            }
          },
          "required": [
            "error_schema_version",
            "code"
          ],
          "type": "object"
        },
        "status": {
          "const": "failed"
        }
      },
      "required": [
        "status",
        "error"
      ],
      "type": "object"
    },
    {
      "additionalProperties": false,
      "properties": {
        "error": {
          "additionalProperties": false,
          "properties": {
            "code": {
              "pattern": "^LUMIN_[A-Z0-9_]+$",
              "type": "string"
            },
            "error_schema_version": {
              "const": 1
            }
          },
          "required": [
            "error_schema_version",
            "code"
          ],
          "type": "object"
        },
        "status": {
          "const": "failed"
        }
      },
      "required": [
        "status",
        "error"
      ],
      "type": "object"
    }
  ],
  "type": "object"
}
sha256:e57d5f6b952b6275885ff8db08accb1817ddff628c4c0030d4fb575be6b750d1

Description hash: sha256:10381fb252696d606febb6c25f80d0657c2b4ff6f5753114097b56eba3a5ad62

Interface hash: sha256:c1968a93f536ae08395abead5fcece91f9c81cea881d0418d6ef03dc41badc82

Other observed Modelara metadata
{
  "id": "mcp:pdf-tools/prepare_lumin_request",
  "title": "Prepare Lumin Signing Request",
  "source": {
    "type": "mcp",
    "server": "pdf-tools",
    "operation": "prepare_lumin_request"
  },
  "declared": {
    "read_only": "true",
    "destructive": "false",
    "idempotent": "true",
    "open_world": "false"
  },
  "safety": {
    "idempotent": "true",
    "retry_safe": "true"
  },
  "metadata": {
    "mcp.annotations": "present"
  },
  "fingerprint": "sha256:01b0c832a42818465df1a8a076bc9c93e167f2c8ce47f319f6a9a25477ff3e94"
}
toolread0.14.00.14.0
prepare_signing_packetpdf-toolkit:tool:prepare_signing_packet
Observed interface and hashes

One-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

{
  "additionalProperties": false,
  "properties": {
    "allow_resign": {
      "description": "Proceed even if the PDF already contains cryptographic signature fields (default: false). Warning: saving will invalidate any existing signatures.",
      "type": "boolean"
    },
    "expected_output_identity": {
      "additionalProperties": false,
      "description": "Exact current identity returned by get_pdf_identity. Required when replacing a distinct existing output_path, optional for the separately guarded same-document backup workflow, and omitted for a new destination.",
      "properties": {
        "canonical_path": {
          "description": "Exact canonical_path returned by get_pdf_identity for the existing destination.",
          "type": "string"
        },
        "sha256": {
          "description": "Exact SHA-256 returned by get_pdf_identity for the existing destination.",
          "pattern": "^[a-f0-9]{64}$",
          "type": "string"
        },
        "size_bytes": {
          "description": "Exact size_bytes returned by get_pdf_identity for the existing destination.",
          "minimum": 0,
          "type": "integer"
        }
      },
      "required": [
        "canonical_path",
        "size_bytes",
        "sha256"
      ],
      "type": "object"
    },
    "field_values": {
      "additionalProperties": true,
      "description": "Optional map of AcroForm field name → value. Same shape as fill_pdf's 'field_data' argument.",
      "type": "object"
    },
    "force_xfa": {
      "description": "Proceed even if the PDF uses XFA forms (default: false). Warning: the XFA layer will be stripped.",
      "type": "boolean"
    },
    "output_path": {
      "description": "Path to save the prepared PDF. May be the same as pdf_path for in-place editing; the original will be backed up on the first mutation.",
      "type": "string"
    },
    "password": {
      "description": "Password for an encrypted PDF. Supply the user or owner password and the document is decrypted in memory, changed, and then saved with exactly the encryption and permissions it already had (encrypted inputs are limited to 16 MiB). The protection is never removed, changed, or added by this tool. Leave it unset for an unencrypted document. If the document's own permissions deny the change being made, the owner password is required, because that is the credential which authorises overriding them.",
      "type": "string"
    },
    "pdf_path": {
      "description": "Path to the input PDF",
      "type": "string"
    },
    "require_provider_ready": {
      "description": "Fail closed before committing unless every zone is typed and participant-bound and every requested field write succeeds. Default: false. This means ready for later provider mapping only, never ready or authorized to sign.",
      "type": "boolean"
    },
    "signature_locations": {
      "description": "Sign-here boxes to add. Coordinates use TOP-LEFT origin in points.",
      "items": {
        "additionalProperties": false,
        "properties": {
          "evidence_source": {
            "description": "Caller-declared label for how the placement was established (default: caller_supplied). This receipt does not independently replay that evidence.",
            "enum": [
              "caller_supplied",
              "detect_signature_zones",
              "acroform"
            ],
            "type": "string"
          },
          "field_type": {
            "description": "Provider-neutral intended field type. Required when require_provider_ready=true.",
            "enum": [
              "signature",
              "initials",
              "date",
              "printed_name",
              "witness_signature"
            ],
            "type": "string"
          },
          "height": {
            "type": "number"
          },
          "label": {
            "description": "Label shown in the box, e.g. 'Signature (Applicant)'",
            "type": "string"
          },
          "page": {
            "type": "integer"
          },
          "participant_id": {
            "description": "Opaque stable participant identifier, not an email address or secret. Required when require_provider_ready=true.",
            "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]{0,127}$",
            "type": "string"
          },
          "participant_role": {
            "description": "Provider-neutral participant role. Required when require_provider_ready=true.",
            "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]{0,127}$",
            "type": "string"
          },
          "width": {
            "type": "number"
          },
          "x": {
            "type": "number"
          },
          "y": {
            "type": "number"
          },
          "zone_id": {
            "description": "Optional stable provider-neutral zone identifier. A deterministic ID is generated when omitted.",
            "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]{0,127}$",
            "type": "string"
          }
        },
        "required": [
          "page",
          "x",
          "y",
          "width",
          "height"
        ],
        "type": "object"
      },
      "type": "array"
    }
  },
  "required": [
    "pdf_path",
    "output_path"
  ],
  "type": "object"
}
sha256:6069254ebb5074d50ec7b4dcf02cad0673e621ec0f30763850613bf341b10907

Output schema

{
  "anyOf": [
    {
      "additionalProperties": false,
      "properties": {
        "active_path": {
          "type": "string"
        },
        "backup_path": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ]
        },
        "fieldCount": {
          "type": "integer"
        },
        "fields": {
          "items": {
            "additionalProperties": false,
            "properties": {
              "currentValue": {
                "anyOf": [
                  {
                    "type": "string"
                  },
                  {
                    "type": "boolean"
                  },
                  {
                    "items": {
                      "type": "string"
                    },
                    "type": "array"
                  }
                ]
              },
              "name": {
                "type": "string"
              },
              "options": {
                "items": {
                  "type": "string"
                },
                "type": "array"
              },
              "type": {
                "enum": [
                  "text",
                  "checkbox",
                  "radio",
                  "dropdown",
                  "unknown"
                ],
                "type": "string"
              }
            },
            "required": [
              "name",
              "type",
              "options",
              "currentValue"
            ],
            "type": "object"
          },
          "type": "array"
        },
        "fill_errors": {
          "items": {
            "additionalProperties": false,
            "properties": {
              "error": {
                "type": "string"
              },
              "field": {
                "type": "string"
              }
            },
            "required": [
              "field",
              "error"
            ],
            "type": "object"
          },
          "type": "array"
        },
        "filled_count": {
          "type": "integer"
        },
        "hasFormFields": {
          "type": "boolean"
        },
        "initialPage": {
          "type": "integer"
        },
        "last_mutation_at": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ]
        },
        "last_mutation_tool": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ]
        },
        "pdfPath": {
          "type": "string"
        },
        "pdf_path": {
          "type": "string"
        },
        "pending_signatures": {
          "items": {
            "additionalProperties": false,
            "properties": {
              "height": {
                "type": "number"
              },
              "label": {
                "type": "string"
              },
              "page": {
                "type": "integer"
              },
              "width": {
                "type": "number"
              },
              "x": {
                "type": "number"
              },
              "y": {
                "type": "number"
              }
            },
            "required": [
              "label",
              "page",
              "x",
              "y",
              "width",
              "height"
            ],
            "type": "object"
          },
          "type": "array"
        },
        "preparation_receipt": {
          "additionalProperties": false,
          "properties": {
            "existing_signature_observation": {
              "additionalProperties": false,
              "properties": {
                "allow_resign": {
                  "type": "boolean"
                },
                "field_count": {
                  "type": "integer"
                },
                "field_names": {
                  "items": {
                    "type": "string"
                  },
                  "type": "array"
                },
                "present": {
                  "type": "boolean"
                }
              },
              "required": [
                "present",
                "field_count",
                "field_names",
                "allow_resign"
              ],
              "type": "object"
            },
            "field_outcomes": {
              "items": {
                "additionalProperties": false,
                "properties": {
                  "field_name": {
                    "type": "string"
                  },
                  "reason_code": {
                    "anyOf": [
                      {
                        "enum": [
                          "field_write_failed"
                        ],
                        "type": "string"
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "status": {
                    "enum": [
                      "written",
                      "skipped",
                      "failed"
                    ],
                    "type": "string"
                  }
                },
                "required": [
                  "field_name",
                  "status",
                  "reason_code"
                ],
                "type": "object"
              },
              "type": "array"
            },
            "geometry_policy": {
              "additionalProperties": false,
              "properties": {
                "crop_box_observed": {
                  "const": true
                },
                "display_coordinate_space": {
                  "const": "pdf-tools.crop-box-rotated-top-left-points.v1"
                },
                "native_coordinate_space": {
                  "const": "pdf-tools.media-box-top-left-points.v1"
                },
                "page_box_basis": {
                  "const": "MediaBox"
                },
                "rotation_policy": {
                  "const": "clockwise_quarter_turns"
                }
              },
              "required": [
                "native_coordinate_space",
                "display_coordinate_space",
                "page_box_basis",
                "crop_box_observed",
                "rotation_policy"
              ],
              "type": "object"
            },
            "handoff_status": {
              "enum": [
                "ready_for_provider_mapping",
                "incomplete",
                "blocked"
              ],
              "type": "string"
            },
            "limitations": {
              "items": {
                "type": "string"
              },
              "type": "array"
            },
            "missing_inputs": {
              "items": {
                "additionalProperties": false,
                "properties": {
                  "code": {
                    "enum": [
                      "NO_SIGNATURE_ZONES",
                      "ZONE_TYPE_UNSPECIFIED",
                      "ZONE_PARTICIPANT_BINDING_MISSING",
                      "ZONE_PARTICIPANT_BINDING_PARTIAL",
                      "ZONE_OUTSIDE_CROP_BOX",
                      "ZONE_PARTIALLY_CLIPPED",
                      "FIELD_WRITE_FAILED"
                    ],
                    "type": "string"
                  },
                  "field_name": {
                    "anyOf": [
                      {
                        "type": "string"
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "zone_id": {
                    "anyOf": [
                      {
                        "type": "string"
                      },
                      {
                        "type": "null"
                      }
                    ]
                  }
                },
                "required": [
                  "code",
                  "zone_id",
                  "field_name"
                ],
                "type": "object"
              },
              "type": "array"
            },
            "output_commit": {
              "additionalProperties": false,
              "properties": {
                "prepared_identity_verified_after_commit": {
                  "const": true
                },
                "protocol": {
                  "const": "pdf-tools.atomic-output-transaction.v1"
                },
                "replacement_identity_supplied": {
                  "type": "boolean"
                },
                "source_binding_verified_at_commit": {
                  "const": true
                },
                "status": {
                  "const": "committed"
                },
                "target_mode": {
                  "enum": [
                    "new_path",
                    "same_document"
                  ],
                  "type": "string"
                }
              },
              "required": [
                "status",
                "protocol",
                "target_mode",
                "source_binding_verified_at_commit",
                "prepared_identity_verified_after_commit",
                "replacement_identity_supplied"
              ],
              "type": "object"
            },
            "page_count": {
              "type": "integer"
            },
            "pages": {
              "items": {
                "additionalProperties": false,
                "properties": {
                  "crop_box": {
                    "additionalProperties": false,
                    "properties": {
                      "height": {
                        "type": "number"
                      },
                      "origin_x": {
                        "type": "number"
                      },
                      "origin_y": {
                        "type": "number"
                      },
                      "width": {
                        "type": "number"
                      }
                    },
                    "required": [
                      "origin_x",
                      "origin_y",
                      "width",
                      "height"
                    ],
                    "type": "object"
                  },
                  "media_box": {
                    "additionalProperties": false,
                    "properties": {
                      "height": {
                        "type": "number"
                      },
                      "origin_x": {
                        "type": "number"
                      },
                      "origin_y": {
                        "type": "number"
                      },
                      "width": {
                        "type": "number"
                      }
                    },
                    "required": [
                      "origin_x",
                      "origin_y",
                      "width",
                      "height"
                    ],
                    "type": "object"
                  },
                  "page": {
                    "type": "integer"
                  },
                  "rotation_degrees": {
                    "enum": [
                      0,
                      90,
                      180,
                      270
                    ],
                    "type": "integer"
                  }
                },
                "required": [
                  "page",
                  "rotation_degrees",
                  "media_box",
                  "crop_box"
                ],
                "type": "object"
              },
              "type": "array"
            },
            "preparation_engine": {
              "const": "pdf-tools.prepare-signing-packet.v1"
            },
            "prepared_document": {
              "additionalProperties": false,
              "properties": {
                "canonical_path": {
                  "type": "string"
                },
                "identity_method": {
                  "const": "race_aware_descriptor_sha256"
                },
                "sha256": {
                  "pattern": "^[a-f0-9]{64}$",
                  "type": "string"
                },
                "size_bytes": {
                  "type": "integer"
                }
              },
              "required": [
                "canonical_path",
                "size_bytes",
                "sha256",
                "identity_method"
              ],
              "type": "object"
            },
            "provider_execution_status": {
              "const": "not_requested"
            },
            "receipt_sha256": {
              "pattern": "^[a-f0-9]{64}$",
              "type": "string"
            },
            "schema_version": {
              "const": "1.0"
            },
            "source_document": {
              "additionalProperties": false,
              "properties": {
                "canonical_path": {
                  "type": "string"
                },
                "identity_method": {
                  "const": "race_aware_descriptor_sha256"
                },
                "sha256": {
                  "pattern": "^[a-f0-9]{64}$",
                  "type": "string"
                },
                "size_bytes": {
                  "type": "integer"
                }
              },
              "required": [
                "canonical_path",
                "size_bytes",
                "sha256",
                "identity_method"
              ],
              "type": "object"
            },
            "source_preservation": {
              "additionalProperties": false,
              "properties": {
                "backup_document": {
                  "anyOf": [
                    {
                      "additionalProperties": false,
                      "properties": {
                        "canonical_path": {
                          "type": "string"
                        },
                        "identity_method": {
                          "const": "immutable_original_backup_record_sha256"
                        },
                        "sha256": {
                          "pattern": "^[a-f0-9]{64}$",
                          "type": "string"
                        },
                        "size_bytes": {
                          "type": "integer"
                        }
                      },
                      "required": [
                        "canonical_path",
                        "size_bytes",
                        "sha256",
                        "identity_method"
                      ],
                      "type": "object"
                    },
                    {
                      "type": "null"
                    }
                  ]
                },
                "backup_identity_verified_after_commit": {
                  "type": "boolean"
                },
                "backup_path": {
                  "anyOf": [
                    {
                      "type": "string"
                    },
                    {
                      "type": "null"
                    }
                  ]
                },
                "mode": {
                  "enum": [
                    "source_path_unchanged",
                    "same_document_immutable_original_backup"
                  ],
                  "type": "string"
                },
                "source_path_reverified_after_commit": {
                  "type": "boolean"
                }
              },
              "required": [
                "mode",
                "source_path_reverified_after_commit",
                "backup_identity_verified_after_commit",
                "backup_path",
                "backup_document"
              ],
              "type": "object"
            },
            "xfa_observation": {
              "additionalProperties": false,
              "properties": {
                "force_xfa": {
                  "type": "boolean"
                },
                "present": {
                  "type": "boolean"
                },
                "stripping_authorized": {
                  "type": "boolean"
                }
              },
              "required": [
                "present",
                "force_xfa",
                "stripping_authorized"
              ],
              "type": "object"
            },
            "zones": {
              "items": {
                "additionalProperties": false,
                "properties": {
                  "coordinate_space_version": {
                    "const": "pdf-tools.media-box-top-left-points.v1"
                  },
                  "display_region": {
                    "additionalProperties": false,
                    "properties": {
                      "height": {
                        "type": "number"
                      },
                      "width": {
                        "type": "number"
                      },
                      "x": {
                        "type": "number"
                      },
                      "y": {
                        "type": "number"
                      }
                    },
                    "required": [
                      "x",
                      "y",
                      "width",
                      "height"
                    ],
                    "type": "object"
                  },
                  "evidence_binding_status": {
                    "const": "caller_declared"
                  },
                  "evidence_source": {
                    "enum": [
                      "caller_supplied",
                      "detect_signature_zones",
                      "acroform"
                    ],
                    "type": "string"
                  },
                  "field_type": {
                    "enum": [
                      "signature",
                      "initials",
                      "date",
                      "printed_name",
                      "witness_signature",
                      "unspecified"
                    ],
                    "type": "string"
                  },
                  "label": {
                    "type": "string"
                  },
                  "native_region": {
                    "additionalProperties": false,
                    "properties": {
                      "height": {
                        "type": "number"
                      },
                      "width": {
                        "type": "number"
                      },
                      "x": {
                        "type": "number"
                      },
                      "y": {
                        "type": "number"
                      }
                    },
                    "required": [
                      "x",
                      "y",
                      "width",
                      "height"
                    ],
                    "type": "object"
                  },
                  "page": {
                    "type": "integer"
                  },
                  "participant_binding": {
                    "additionalProperties": false,
                    "properties": {
                      "participant_id": {
                        "anyOf": [
                          {
                            "type": "string"
                          },
                          {
                            "type": "null"
                          }
                        ]
                      },
                      "participant_role": {
                        "anyOf": [
                          {
                            "type": "string"
                          },
                          {
                            "type": "null"
                          }
                        ]
                      },
                      "status": {
                        "enum": [
                          "bound",
                          "partial",
                          "unbound"
                        ],
                        "type": "string"
                      }
                    },
                    "required": [
                      "status",
                      "participant_id",
                      "participant_role"
                    ],
                    "type": "object"
                  },
                  "visibility_status": {
                    "enum": [
                      "visible",
                      "partially_clipped",
                      "outside_crop_box"
                    ],
                    "type": "string"
                  },
                  "zone_id": {
                    "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]{0,127}$",
                    "type": "string"
                  }
                },
                "required": [
                  "zone_id",
                  "label",
                  "field_type",
                  "page",
                  "native_region",
                  "display_region",
                  "visibility_status",
                  "coordinate_space_version",
                  "evidence_source",
                  "evidence_binding_status",
                  "participant_binding"
                ],
                "type": "object"
              },
              "type": "array"
            }
          },
          "required": [
            "schema_version",
            "preparation_engine",
            "source_document",
            "prepared_document",
            "source_preservation",
            "output_commit",
            "page_count",
            "geometry_policy",
            "pages",
            "field_outcomes",
            "zones",
            "existing_signature_observation",
            "xfa_observation",
            "handoff_status",
            "missing_inputs",
            "limitations",
            "provider_execution_status",
            "receipt_sha256"
          ],
          "type": "object"
        },
        "totalBytes": {
          "type": "integer"
        }
      },
      "required": [
        "pdfPath",
        "totalBytes",
        "initialPage",
        "fields",
        "fieldCount",
        "hasFormFields",
        "active_path",
        "backup_path",
        "last_mutation_tool",
        "last_mutation_at",
        "pdf_path",
        "pending_signatures",
        "filled_count",
        "fill_errors",
        "preparation_receipt"
      ],
      "type": "object"
    },
    {
      "additionalProperties": false,
      "properties": {
        "error": {
          "additionalProperties": false,
          "properties": {
            "code": {
              "enum": [
                "internal_validation_error",
                "path_policy_denied",
                "tool_execution_failed"
              ],
              "type": "string"
            },
            "error_schema_version": {
              "const": 1
            }
          },
          "required": [
            "error_schema_version",
            "code"
          ],
          "type": "object"
        },
        "status": {
          "const": "failed"
        }
      },
      "required": [
        "status",
        "error"
      ],
      "type": "object"
    },
    {
      "additionalProperties": false,
      "properties": {
        "error": {
          "additionalProperties": false,
          "properties": {
            "code": {
              "const": "PDF_RESOURCE_LIMIT_EXCEEDED"
            },
            "error_schema_version": {
              "const": 1
            }
          },
          "required": [
            "error_schema_version",
            "code"
          ],
          "type": "object"
        },
        "status": {
          "const": "failed"
        }
      },
      "required": [
        "status",
        "error"
      ],
      "type": "object"
    }
  ],
  "type": "object"
}
sha256:a278f619b3d1d0bc39c6b86d52cac59a5c96c94cbd54eb8831dbccb46308e421

Description hash: sha256:f471aabf069fcb788ddb7094b0aad237d08d91b97977d4ff003c2ac053ebc272

Interface hash: sha256:3ea2b028a0f442ea6c73ee185d9e440fd018109b0357d23cfc6041e7a1eaf9d1

Other observed Modelara metadata
{
  "id": "mcp:pdf-tools/prepare_signing_packet",
  "title": "Prepare Signing Packet",
  "source": {
    "type": "mcp",
    "server": "pdf-tools",
    "operation": "prepare_signing_packet"
  },
  "declared": {
    "read_only": "false",
    "destructive": "true",
    "idempotent": "false",
    "open_world": "false"
  },
  "safety": {
    "idempotent": "false",
    "retry_safe": "false"
  },
  "metadata": {
    "mcp.annotations": "present"
  },
  "fingerprint": "sha256:027b5b2d58a902d6d6981db949dad0f449a906a501b194191c04f2f816eae4f8"
}
tooldestructive0.12.10.14.0
read_extraction_chunkpdf-toolkit:tool:read_extraction_chunk
Observed interface and hashes

Rebuild and return one source-bound chunk from the current PDF bytes. The chunk must belong to the workspace's returned inventory; omitted chunks cannot be requested.

Input schema

{
  "additionalProperties": false,
  "properties": {
    "chunk_id": {
      "pattern": "^chunk\\.[a-f0-9]{64}$",
      "type": "string"
    },
    "password": {
      "type": "string"
    },
    "pdf_path": {
      "type": "string"
    },
    "workspace_id": {
      "type": "string"
    },
    "workspace_identity_sha256": {
      "pattern": "^[a-f0-9]{64}$",
      "type": "string"
    }
  },
  "required": [
    "pdf_path",
    "workspace_id",
    "workspace_identity_sha256",
    "chunk_id"
  ],
  "type": "object"
}
sha256:2b706daec961f901bc4fbd1d9bea4dedb4d3620a7da3c8a7c056a831ca664366

Output schema

{
  "anyOf": [
    {
      "additionalProperties": false,
      "properties": {
        "admitted_item_count": {
          "minimum": 0,
          "type": "integer"
        },
        "chunk_id": {
          "pattern": "^chunk\\.[a-f0-9]{64}$",
          "type": "string"
        },
        "content": {
          "type": "string"
        },
        "content_sha256": {
          "pattern": "^[a-f0-9]{64}$",
          "type": "string"
        },
        "content_utf8_bytes": {
          "minimum": 0,
          "type": "integer"
        },
        "document_map_sha256": {
          "pattern": "^[a-f0-9]{64}$",
          "type": "string"
        },
        "omitted_item_count": {
          "const": 0
        },
        "page_range": {
          "additionalProperties": false,
          "properties": {
            "end_page": {
              "minimum": 1,
              "type": "integer"
            },
            "start_page": {
              "minimum": 1,
              "type": "integer"
            }
          },
          "required": [
            "start_page",
            "end_page"
          ],
          "type": "object"
        }
      },
      "required": [
        "document_map_sha256",
        "chunk_id",
        "page_range",
        "content",
        "content_utf8_bytes",
        "content_sha256",
        "admitted_item_count",
        "omitted_item_count"
      ],
      "type": "object"
    },
    {
      "additionalProperties": false,
      "properties": {
        "error": {
          "additionalProperties": false,
          "properties": {
            "code": {
              "enum": [
                "internal_validation_error",
                "path_policy_denied",
                "tool_execution_failed"
              ],
              "type": "string"
            },
            "error_schema_version": {
              "const": 1
            }
          },
          "required": [
            "error_schema_version",
            "code"
          ],
          "type": "object"
        },
        "status": {
          "const": "failed"
        }
      },
      "required": [
        "status",
        "error"
      ],
      "type": "object"
    }
  ],
  "type": "object"
}
sha256:3bca6d9e7536ff60b7204733170fb709259fac7e44f153cae8ee4b3c28f1da54

Description hash: sha256:3d5be800c9bda4ee90b6b2b45895faa4d03e9211fd0f50c16ea7a28cd108eb35

Interface hash: sha256:b3e615c5fd867342de497678d8734445b6510716be0c7fc7456090f79457bd47

Other observed Modelara metadata
{
  "id": "mcp:pdf-tools/read_extraction_chunk",
  "title": "Read Verified Extraction Chunk",
  "source": {
    "type": "mcp",
    "server": "pdf-tools",
    "operation": "read_extraction_chunk"
  },
  "declared": {
    "read_only": "true",
    "destructive": "false",
    "idempotent": "true",
    "open_world": "false"
  },
  "safety": {
    "idempotent": "true",
    "retry_safe": "true"
  },
  "metadata": {
    "mcp.annotations": "present"
  },
  "fingerprint": "sha256:d5e42f6fa3ab9202b1fe60fed0cb9f2b9f19b63cabd85818af811554b5de8cc3"
}
toolread0.13.00.13.0
read_extraction_workspacepdf-toolkit:tool:read_extraction_workspace
Observed interface and hashes

Read a bounded, cursor-bound page of document chunks, pending schema leaves, proposals, verification results, or append-only events.

Input schema

{
  "additionalProperties": false,
  "properties": {
    "collection": {
      "enum": [
        "document_map_chunks",
        "pending_leaves",
        "events",
        "proposals",
        "results"
      ],
      "type": "string"
    },
    "cursor": {
      "type": "string"
    },
    "limit": {
      "maximum": 100,
      "minimum": 1,
      "type": "integer"
    },
    "workspace_id": {
      "type": "string"
    },
    "workspace_identity_sha256": {
      "pattern": "^[a-f0-9]{64}$",
      "type": "string"
    }
  },
  "required": [
    "workspace_id",
    "workspace_identity_sha256",
    "collection"
  ],
  "type": "object"
}
sha256:a7d39166cc647dd41170b96db6bdf2656c14d32b54fa0cc8fd33de071f0b9c99

Output schema

{
  "anyOf": [
    {
      "additionalProperties": false,
      "properties": {
        "collection": {
          "enum": [
            "document_map_chunks",
            "pending_leaves",
            "events",
            "proposals",
            "results"
          ],
          "type": "string"
        },
        "collection_sha256": {
          "pattern": "^[a-f0-9]{64}$",
          "type": "string"
        },
        "contract": {
          "additionalProperties": false,
          "properties": {
            "name": {
              "const": "pdf-tools.verified-extraction-workspace-page"
            },
            "version": {
              "const": "1.0.0-experimental"
            }
          },
          "required": [
            "name",
            "version"
          ],
          "type": "object"
        },
        "counts": {
          "additionalProperties": false,
          "properties": {
            "offset": {
              "minimum": 0,
              "type": "integer"
            },
            "omitted_after": {
              "minimum": 0,
              "type": "integer"
            },
            "omitted_before": {
              "minimum": 0,
              "type": "integer"
            },
            "returned": {
              "minimum": 0,
              "type": "integer"
            },
            "total": {
              "minimum": 0,
              "type": "integer"
            }
          },
          "required": [
            "total",
            "offset",
            "returned",
            "omitted_before",
            "omitted_after"
          ],
          "type": "object"
        },
        "generation_sha256": {
          "pattern": "^[a-f0-9]{64}$",
          "type": "string"
        },
        "items": {
          "items": {},
          "type": "array"
        },
        "next_cursor": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ]
        },
        "workspace_identity_sha256": {
          "pattern": "^[a-f0-9]{64}$",
          "type": "string"
        }
      },
      "required": [
        "contract",
        "workspace_identity_sha256",
        "generation_sha256",
        "collection",
        "collection_sha256",
        "counts",
        "items",
        "next_cursor"
      ],
      "type": "object"
    },
    {
      "additionalProperties": false,
      "properties": {
        "error": {
          "additionalProperties": false,
          "properties": {
            "code": {
              "enum": [
                "internal_validation_error",
                "path_policy_denied",
                "tool_execution_failed"
              ],
              "type": "string"
            },
            "error_schema_version": {
              "const": 1
            }
          },
          "required": [
            "error_schema_version",
            "code"
          ],
          "type": "object"
        },
        "status": {
          "const": "failed"
        }
      },
      "required": [
        "status",
        "error"
      ],
      "type": "object"
    }
  ],
  "type": "object"
}
sha256:9b441e381d97a5dbed82d9cb3cedb1c5349936c66733cbc2c289071ae280a568

Description hash: sha256:9fc53413d2b8a70045f3c8b1164a788346769aaa9d0b5c5f82e031448f5b650f

Interface hash: sha256:80ba177ea9728a3a0ec022a55e660b7bcd8e1938b3da9d0b5e9d85cdb1bd5615

Other observed Modelara metadata
{
  "id": "mcp:pdf-tools/read_extraction_workspace",
  "title": "Read Verified Extraction Workspace",
  "source": {
    "type": "mcp",
    "server": "pdf-tools",
    "operation": "read_extraction_workspace"
  },
  "declared": {
    "read_only": "true",
    "destructive": "false",
    "idempotent": "true",
    "open_world": "false"
  },
  "safety": {
    "idempotent": "true",
    "retry_safe": "true"
  },
  "metadata": {
    "mcp.annotations": "present"
  },
  "fingerprint": "sha256:d197ff282e2701adf89bf18888a9a1988eb0bda9377a5f68bd09ebcfc896eec6"
}
toolread0.13.00.13.0
read_pdf_bytespdf-toolkit:tool:read_pdf_bytes
Observed interface and hashes

Read PDF file bytes in chunks (for UI rendering)

Input schema

{
  "properties": {
    "byteCount": {
      "description": "Number of bytes to read (max 524288)",
      "type": "number"
    },
    "offset": {
      "description": "Byte offset to start reading from",
      "type": "number"
    },
    "pdf_path": {
      "description": "Path to the PDF file",
      "type": "string"
    }
  },
  "required": [
    "pdf_path",
    "offset",
    "byteCount"
  ],
  "type": "object"
}
sha256:4a02b9f207a504467241532dab068f4bf45b7cbb62277e3d24d9f263670275c7

Output schema

{
  "anyOf": [
    {
      "additionalProperties": false,
      "properties": {
        "byteCount": {
          "type": "integer"
        },
        "bytes": {
          "type": "string"
        },
        "hasMore": {
          "type": "boolean"
        },
        "offset": {
          "type": "integer"
        },
        "pdfPath": {
          "type": "string"
        },
        "totalBytes": {
          "type": "integer"
        }
      },
      "required": [
        "pdfPath",
        "bytes",
        "offset",
        "byteCount",
        "totalBytes",
        "hasMore"
      ],
      "type": "object"
    },
    {
      "additionalProperties": false,
      "properties": {
        "error": {
          "additionalProperties": false,
          "properties": {
            "code": {
              "enum": [
                "internal_validation_error",
                "path_policy_denied",
                "tool_execution_failed"
              ],
              "type": "string"
            },
            "error_schema_version": {
              "const": 1
            }
          },
          "required": [
            "error_schema_version",
            "code"
          ],
          "type": "object"
        },
        "status": {
          "const": "failed"
        }
      },
      "required": [
        "status",
        "error"
      ],
      "type": "object"
    }
  ],
  "type": "object"
}
sha256:82479f0a507290c7b2adffd2946019cef1c3721b5bc1a644ff8af8e5bd8753a9

Description hash: sha256:c3e7782b28389fb03a97cf4844a746cddc24cba9ee8d566fd1ab2fdbb7bc3179

Interface hash: sha256:c2d9e60168f8cd01290b7ed94250c952d212d31e3a59888f10596a424cbfee20

Other observed Modelara metadata
{
  "id": "mcp:pdf-tools/read_pdf_bytes",
  "title": "Read PDF Bytes",
  "source": {
    "type": "mcp",
    "server": "pdf-tools",
    "operation": "read_pdf_bytes"
  },
  "declared": {
    "read_only": "true",
    "destructive": "false",
    "idempotent": "true",
    "open_world": "false"
  },
  "safety": {
    "idempotent": "true",
    "retry_safe": "true"
  },
  "metadata": {
    "mcp.annotations": "present"
  },
  "fingerprint": "sha256:84f48ab350dafc0121ad17f82cd38e5c8a8be26f831fd11faea0fc56feffab8f"
}
toolread0.12.1No change observed
read_pdf_contentpdf-toolkit:tool:read_pdf_content
Observed interface and hashes

Read PDF text for broad understanding of the document. Returns an explicit extraction_status (complete, partial, or failed); a failed result must not be interpreted as an empty PDF. Best for full-document summarization, question answering, and exploratory analysis when you want a single text-oriented view of the file. If you need page-bounded excerpts or keyword search results, prefer read_pdf_pages or search_pdf_text. All paths must be absolute paths on the user's local machine, NOT Claude container paths (/mnt/...).

Input schema

{
  "examples": [
    {
      "max_pages": 12,
      "pdf_path": "/Users/alice/Documents/contract.pdf"
    }
  ],
  "properties": {
    "max_pages": {
      "description": "Maximum number of pages to extract. Useful for very large PDFs when you only need the opening section.",
      "type": "number"
    },
    "pdf_path": {
      "description": "Absolute path to the PDF file.",
      "type": "string"
    }
  },
  "required": [
    "pdf_path"
  ],
  "type": "object"
}
sha256:8cbe4f72a493172968a2956c7c58373aaca55e0a9119ee6bcfa279b7e8d2301c

Output schema

{
  "anyOf": [
    {
      "anyOf": [
        {
          "additionalProperties": false,
          "properties": {
            "content_available": {
              "const": true
            },
            "error_codes": {
              "items": {
                "type": "string"
              },
              "type": "array"
            },
            "extraction_mode": {
              "const": "text"
            },
            "extraction_status": {
              "description": "Text-layer read coverage, not OCR correctness or agreement with the visible page.",
              "enum": [
                "complete",
                "partial"
              ],
              "type": "string"
            },
            "file_name": {
              "type": "string"
            },
            "page_previews": {
              "items": {
                "additionalProperties": false,
                "properties": {
                  "char_count": {
                    "type": "integer"
                  },
                  "page": {
                    "type": "integer"
                  },
                  "returned_chars": {
                    "type": "integer"
                  },
                  "text": {
                    "type": "string"
                  },
                  "truncated": {
                    "type": "boolean"
                  }
                },
                "required": [
                  "page",
                  "char_count",
                  "returned_chars",
                  "truncated",
                  "text"
                ],
                "type": "object"
              },
              "type": "array"
            },
            "page_read_error": {
              "anyOf": [
                {
                  "additionalProperties": false,
                  "properties": {
                    "code": {
                      "const": "PDFJS_PAGE_READ_FAILED"
                    },
                    "page": {
                      "type": "integer"
                    }
                  },
                  "required": [
                    "page",
                    "code"
                  ],
                  "type": "object"
                },
                {
                  "type": "null"
                }
              ]
            },
            "pages_read": {
              "type": "integer"
            },
            "pages_with_invisible_text": {
              "items": {
                "additionalProperties": false,
                "properties": {
                  "invisible_text_show_count": {
                    "anyOf": [
                      {
                        "type": "integer"
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "other_text_show_count": {
                    "anyOf": [
                      {
                        "type": "integer"
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "page": {
                    "type": "integer"
                  },
                  "status": {
                    "enum": [
                      "available",
                      "unavailable"
                    ],
                    "type": "string"
                  }
                },
                "required": [
                  "page",
                  "status",
                  "invisible_text_show_count",
                  "other_text_show_count"
                ],
                "type": "object"
              },
              "type": "array"
            },
            "pages_with_suspected_text_integrity": {
              "items": {
                "additionalProperties": false,
                "properties": {
                  "page": {
                    "type": "integer"
                  },
                  "signals": {
                    "items": {
                      "additionalProperties": false,
                      "properties": {
                        "count": {
                          "minimum": 1,
                          "type": "integer"
                        },
                        "kind": {
                          "enum": [
                            "replacement_characters",
                            "private_use_runs",
                            "c1_control_tokens",
                            "non_alphanumeric_dominance"
                          ],
                          "type": "string"
                        }
                      },
                      "required": [
                        "kind",
                        "count"
                      ],
                      "type": "object"
                    },
                    "type": "array"
                  }
                },
                "required": [
                  "page",
                  "signals"
                ],
                "type": "object"
              },
              "type": "array"
            },
            "pages_with_unavailable_text_visibility": {
              "items": {
                "type": "integer"
              },
              "type": "array"
            },
            "pdf_path": {
              "type": "string"
            },
            "preview_truncated": {
              "type": "boolean"
            },
            "read_pages_without_text": {
              "description": "Pages actually read in this call whose normalized text layer is empty.",
              "items": {
                "type": "integer"
              },
              "type": "array"
            },
            "retry_guidance": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ]
            },
            "routing_guidance": {
              "anyOf": [
                {
                  "description": "Fixed visual-verification guidance for textless, suspect, invisible, or visibility-unavailable text within the read scope.",
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ]
            },
            "text_found": {
              "const": true
            },
            "text_length": {
              "type": "integer"
            },
            "text_truncated": {
              "type": "boolean"
            },
            "total_pages": {
              "type": "integer"
            }
          },
          "required": [
            "pages_with_invisible_text",
            "pages_with_unavailable_text_visibility",
            "pdf_path",
            "file_name",
            "total_pages",
            "pages_read",
            "text_length",
            "text_truncated",
            "text_found",
            "content_available",
            "extraction_status",
            "page_previews",
            "page_read_error",
            "read_pages_without_text",
            "pages_with_suspected_text_integrity",
            "routing_guidance",
            "preview_truncated",
            "extraction_mode",
            "error_codes",
            "retry_guidance"
          ],
          "type": "object"
        },
        {
          "additionalProperties": false,
          "properties": {
            "content_available": {
              "const": true
            },
            "error_codes": {
              "items": {
                "type": "string"
              },
              "type": "array"
            },
            "extraction_mode": {
              "const": "image-fallback"
            },
            "extraction_status": {
              "const": "partial"
            },
            "file_name": {
              "type": "string"
            },
            "image_renderer": {
              "enum": [
                "native-canvas",
                "macos-sips",
                "macos-quicklook"
              ],
              "type": "string"
            },
            "page_previews": {
              "items": {
                "additionalProperties": false,
                "properties": {
                  "char_count": {
                    "type": "integer"
                  },
                  "page": {
                    "type": "integer"
                  },
                  "returned_chars": {
                    "type": "integer"
                  },
                  "text": {
                    "type": "string"
                  },
                  "truncated": {
                    "type": "boolean"
                  }
                },
                "required": [
                  "page",
                  "char_count",
                  "returned_chars",
                  "truncated",
                  "text"
                ],
                "type": "object"
              },
              "type": "array"
            },
            "page_read_error": {
              "anyOf": [
                {
                  "additionalProperties": false,
                  "properties": {
                    "code": {
                      "const": "PDFJS_PAGE_READ_FAILED"
                    },
                    "page": {
                      "type": "integer"
                    }
                  },
                  "required": [
                    "page",
                    "code"
                  ],
                  "type": "object"
                },
                {
                  "type": "null"
                }
              ]
            },
            "pages_read": {
              "type": "integer"
            },
            "pages_with_invisible_text": {
              "items": {
                "additionalProperties": false,
                "properties": {
                  "invisible_text_show_count": {
                    "anyOf": [
                      {
                        "type": "integer"
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "other_text_show_count": {
                    "anyOf": [
                      {
                        "type": "integer"
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "page": {
                    "type": "integer"
                  },
                  "status": {
                    "enum": [
                      "available",
                      "unavailable"
                    ],
                    "type": "string"
                  }
                },
                "required": [
                  "page",
                  "status",
                  "invisible_text_show_count",
                  "other_text_show_count"
                ],
                "type": "object"
              },
              "type": "array"
            },
            "pages_with_suspected_text_integrity": {
              "items": {
                "additionalProperties": false,
                "properties": {
                  "page": {
                    "type": "integer"
                  },
                  "signals": {
                    "items": {
                      "additionalProperties": false,
                      "properties": {
                        "count": {
                          "minimum": 1,
                          "type": "integer"
                        },
                        "kind": {
                          "enum": [
                            "replacement_characters",
                            "private_use_runs",
                            "c1_control_tokens",
                            "non_alphanumeric_dominance"
                          ],
                          "type": "string"
                        }
                      },
                      "required": [
                        "kind",
                        "count"
                      ],
                      "type": "object"
                    },
                    "type": "array"
                  }
                },
                "required": [
                  "page",
                  "signals"
                ],
                "type": "object"
              },
              "type": "array"
            },
            "pages_with_unavailable_text_visibility": {
              "items": {
                "type": "integer"
              },
              "type": "array"
            },
            "pdf_path": {
              "type": "string"
            },
            "preview_truncated": {
              "type": "boolean"
            },
            "read_pages_without_text": {
              "description": "Pages actually read in this call whose normalized text layer is empty.",
              "items": {
                "type": "integer"
              },
              "type": "array"
            },
            "retry_guidance": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ]
            },
            "routing_guidance": {
              "anyOf": [
                {
                  "description": "Fixed visual-verification guidance for textless, suspect, invisible, or visibility-unavailable text within the read scope.",
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ]
            },
            "text_found": {
              "const": false
            },
            "text_length": {
              "const": 0
            },
            "text_truncated": {
              "const": false
            },
            "total_pages": {
              "type": "integer"
            }
          },
          "required": [
            "pages_with_invisible_text",
            "pages_with_unavailable_text_visibility",
            "pdf_path",
            "file_name",
            "total_pages",
            "pages_read",
            "text_length",
            "text_truncated",
            "text_found",
            "content_available",
            "extraction_status",
            "page_previews",
            "page_read_error",
            "read_pages_without_text",
            "pages_with_suspected_text_integrity",
            "routing_guidance",
            "preview_truncated",
            "extraction_mode",
            "error_codes",
            "retry_guidance",
            "image_renderer"
          ],
          "type": "object"
        }
      ],
      "type": "object"
    },
    {
      "additionalProperties": false,
      "properties": {
        "error": {
          "additionalProperties": false,
          "properties": {
            "code": {
              "enum": [
                "internal_validation_error",
                "path_policy_denied",
                "tool_execution_failed"
              ],
              "type": "string"
            },
            "error_schema_version": {
              "const": 1
            }
          },
          "required": [
            "error_schema_version",
            "code"
          ],
          "type": "object"
        },
        "status": {
          "const": "failed"
        }
      },
      "required": [
        "status",
        "error"
      ],
      "type": "object"
    },
    {
      "additionalProperties": false,
      "properties": {
        "content_available": {
          "const": false
        },
        "error_codes": {
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        "extraction_mode": {
          "const": "none"
        },
        "extraction_status": {
          "const": "failed"
        },
        "file_name": {
          "type": "string"
        },
        "page_previews": {
          "items": {
            "additionalProperties": false,
            "properties": {
              "char_count": {
                "type": "integer"
              },
              "page": {
                "type": "integer"
              },
              "returned_chars": {
                "type": "integer"
              },
              "text": {
                "type": "string"
              },
              "truncated": {
                "type": "boolean"
              }
            },
            "required": [
              "page",
              "char_count",
              "returned_chars",
              "truncated",
              "text"
            ],
            "type": "object"
          },
          "type": "array"
        },
        "page_read_error": {
          "anyOf": [
            {
              "additionalProperties": false,
              "properties": {
                "code": {
                  "const": "PDFJS_PAGE_READ_FAILED"
                },
                "page": {
                  "type": "integer"
                }
              },
              "required": [
                "page",
                "code"
              ],
              "type": "object"
            },
            {
              "type": "null"
            }
          ]
        },
        "pages_read": {
          "type": "integer"
        },
        "pages_with_invisible_text": {
          "items": {
            "additionalProperties": false,
            "properties": {
              "invisible_text_show_count": {
                "anyOf": [
                  {
                    "type": "integer"
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "other_text_show_count": {
                "anyOf": [
                  {
                    "type": "integer"
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "page": {
                "type": "integer"
              },
              "status": {
                "enum": [
                  "available",
                  "unavailable"
                ],
                "type": "string"
              }
            },
            "required": [
              "page",
              "status",
              "invisible_text_show_count",
              "other_text_show_count"
            ],
            "type": "object"
          },
          "type": "array"
        },
        "pages_with_suspected_text_integrity": {
          "items": {
            "additionalProperties": false,
            "properties": {
              "page": {
                "type": "integer"
              },
              "signals": {
                "items": {
                  "additionalProperties": false,
                  "properties": {
                    "count": {
                      "minimum": 1,
                      "type": "integer"
                    },
                    "kind": {
                      "enum": [
                        "replacement_characters",
                        "private_use_runs",
                        "c1_control_tokens",
                        "non_alphanumeric_dominance"
                      ],
                      "type": "string"
                    }
                  },
                  "required": [
                    "kind",
                    "count"
                  ],
                  "type": "object"
                },
                "type": "array"
              }
            },
            "required": [
              "page",
              "signals"
            ],
            "type": "object"
          },
          "type": "array"
        },
        "pages_with_unavailable_text_visibility": {
          "items": {
            "type": "integer"
          },
          "type": "array"
        },
        "pdf_path": {
          "type": "string"
        },
        "preview_truncated": {
          "type": "boolean"
        },
        "read_pages_without_text": {
          "description": "Pages actually read in this call whose normalized text layer is empty.",
          "items": {
            "type": "integer"
          },
          "type": "array"
        },
        "retry_guidance": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ]
        },
        "routing_guidance": {
          "anyOf": [
            {
              "description": "Fixed visual-verification guidance for textless, suspect, invisible, or visibility-unavailable text within the read scope.",
              "type": "string"
            },
            {
              "type": "null"
            }
          ]
        },
        "text_found": {
          "const": false
        },
        "text_length": {
          "type": "integer"
        },
        "text_truncated": {
          "const": false
        },
        "total_pages": {
          "type": "integer"
        }
      },
      "required": [
        "pages_with_invisible_text",
        "pages_with_unavailable_text_visibility",
        "pdf_path",
        "file_name",
        "total_pages",
        "pages_read",
        "text_length",
        "text_truncated",
        "text_found",
        "content_available",
        "extraction_status",
        "page_previews",
        "page_read_error",
        "read_pages_without_text",
        "pages_with_suspected_text_integrity",
        "routing_guidance",
        "preview_truncated",
        "extraction_mode",
        "error_codes",
        "retry_guidance"
      ],
      "type": "object"
    },
    {
      "additionalProperties": false,
      "properties": {
        "error": {
          "additionalProperties": false,
          "properties": {
            "code": {
              "enum": [
                "internal_validation_error",
                "path_policy_denied",
                "tool_execution_failed"
              ],
              "type": "string"
            },
            "error_schema_version": {
              "const": 1
            }
          },
          "required": [
            "error_schema_version",
            "code"
          ],
          "type": "object"
        },
        "page_read_error": {
          "anyOf": [
            {
              "additionalProperties": false,
              "properties": {
                "code": {
                  "const": "PDFJS_PAGE_READ_FAILED"
                },
                "page": {
                  "type": "integer"
                }
              },
              "required": [
                "page",
                "code"
              ],
              "type": "object"
            },
            {
              "type": "null"
            }
          ]
        },
        "pages_read": {
          "type": "integer"
        },
        "pages_with_invisible_text": {
          "items": {
            "additionalProperties": false,
            "properties": {
              "invisible_text_show_count": {
                "anyOf": [
                  {
                    "type": "integer"
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "other_text_show_count": {
                "anyOf": [
                  {
                    "type": "integer"
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "page": {
                "type": "integer"
              },
              "status": {
                "enum": [
                  "available",
                  "unavailable"
                ],
                "type": "string"
              }
            },
            "required": [
              "page",
              "status",
              "invisible_text_show_count",
              "other_text_show_count"
            ],
            "type": "object"
          },
          "type": "array"
        },
        "pages_with_suspected_text_integrity": {
          "items": {
            "additionalProperties": false,
            "properties": {
              "page": {
                "type": "integer"
              },
              "signals": {
                "items": {
                  "additionalProperties": false,
                  "properties": {
                    "count": {
                      "minimum": 1,
                      "type": "integer"
                    },
                    "kind": {
                      "enum": [
                        "replacement_characters",
                        "private_use_runs",
                        "c1_control_tokens",
                        "non_alphanumeric_dominance"
                      ],
                      "type": "string"
                    }
                  },
                  "required": [
                    "kind",
                    "count"
                  ],
                  "type": "object"
                },
                "type": "array"
              }
            },
            "required": [
              "page",
              "signals"
            ],
            "type": "object"
          },
          "type": "array"
        },
        "pages_with_unavailable_text_visibility": {
          "items": {
            "type": "integer"
          },
          "type": "array"
        },
        "read_pages_without_text": {
          "items": {
            "type": "integer"
          },
          "type": "array"
        },
        "status": {
          "const": "failed"
        }
      },
      "required": [
        "pages_with_invisible_text",
        "pages_with_unavailable_text_visibility",
        "status",
        "error",
        "pages_read",
        "read_pages_without_text",
        "pages_with_suspected_text_integrity",
        "page_read_error"
      ],
      "type": "object"
    },
    {
      "additionalProperties": false,
      "properties": {
        "error": {
          "additionalProperties": false,
          "properties": {
            "code": {
              "const": "PDF_RESOURCE_LIMIT_EXCEEDED"
            },
            "error_schema_version": {
              "const": 1
            }
          },
          "required": [
            "error_schema_version",
            "code"
          ],
          "type": "object"
        },
        "page_read_error": {
          "anyOf": [
            {
              "additionalProperties": false,
              "properties": {
                "code": {
                  "const": "PDFJS_PAGE_READ_FAILED"
                },
                "page": {
                  "type": "integer"
                }
              },
              "required": [
                "page",
                "code"
              ],
              "type": "object"
            },
            {
              "type": "null"
            }
          ]
        },
        "pages_read": {
          "type": "integer"
        },
        "pages_with_invisible_text": {
          "items": {
            "additionalProperties": false,
            "properties": {
              "invisible_text_show_count": {
                "anyOf": [
                  {
                    "type": "integer"
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "other_text_show_count": {
                "anyOf": [
                  {
                    "type": "integer"
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "page": {
                "type": "integer"
              },
              "status": {
                "enum": [
                  "available",
                  "unavailable"
                ],
                "type": "string"
              }
            },
            "required": [
              "page",
              "status",
              "invisible_text_show_count",
              "other_text_show_count"
            ],
            "type": "object"
          },
          "type": "array"
        },
        "pages_with_suspected_text_integrity": {
          "items": {
            "additionalProperties": false,
            "properties": {
              "page": {
                "type": "integer"
              },
              "signals": {
                "items": {
                  "additionalProperties": false,
                  "properties": {
                    "count": {
                      "minimum": 1,
                      "type": "integer"
                    },
                    "kind": {
                      "enum": [
                        "replacement_characters",
                        "private_use_runs",
                        "c1_control_tokens",
                        "non_alphanumeric_dominance"
                      ],
                      "type": "string"
                    }
                  },
                  "required": [
                    "kind",
                    "count"
                  ],
                  "type": "object"
                },
                "type": "array"
              }
            },
            "required": [
              "page",
              "signals"
            ],
            "type": "object"
          },
          "type": "array"
        },
        "pages_with_unavailable_text_visibility": {
          "items": {
            "type": "integer"
          },
          "type": "array"
        },
        "read_pages_without_text": {
          "items": {
            "type": "integer"
          },
          "type": "array"
        },
        "status": {
          "const": "failed"
        }
      },
      "required": [
        "pages_with_invisible_text",
        "pages_with_unavailable_text_visibility",
        "status",
        "error",
        "pages_read",
        "read_pages_without_text",
        "pages_with_suspected_text_integrity",
        "page_read_error"
      ],
      "type": "object"
    },
    {
      "additionalProperties": false,
      "properties": {
        "error": {
          "additionalProperties": false,
          "properties": {
            "code": {
              "const": "PDF_RESOURCE_LIMIT_EXCEEDED"
            },
            "error_schema_version": {
              "const": 1
            }
          },
          "required": [
            "error_schema_version",
            "code"
          ],
          "type": "object"
        },
        "status": {
          "const": "failed"
        }
      },
      "required": [
        "status",
        "error"
      ],
      "type": "object"
    }
  ],
  "type": "object"
}
sha256:49f50db61b13d7c4e1708f0a3f51f3c447bfc4f225820b49bb9e7fe5c1434baf

Description hash: sha256:1bde43655c794152d60ab2121fac34605f63cc0384143133a057f85034ee96da

Interface hash: sha256:36183e6732eb124284978d46dfdcfac5e43b1ce9fb2ca17c8ea53678f151e3b9

Other observed Modelara metadata
{
  "id": "mcp:pdf-tools/read_pdf_content",
  "title": "Read PDF Content",
  "source": {
    "type": "mcp",
    "server": "pdf-tools",
    "operation": "read_pdf_content"
  },
  "declared": {
    "read_only": "true",
    "destructive": "false",
    "idempotent": "true",
    "open_world": "false"
  },
  "safety": {
    "idempotent": "true",
    "retry_safe": "true"
  },
  "metadata": {
    "mcp.annotations": "present"
  },
  "fingerprint": "sha256:5818c9465907ef03fe48474925dfea90f1b1c5a5fc87a360156cf62d243186ae"
}
toolread0.12.10.14.0
read_pdf_fieldspdf-toolkit:tool:read_pdf_fields
Observed interface and hashes

Read all form fields from a PDF file and display them in an interactive viewer. Returns field names, types, and current values. Also renders the PDF visually — no need to also call display_pdf. All paths must be absolute paths on the user's local machine, NOT Claude container paths (/mnt/...).

Input schema

{
  "properties": {
    "password": {
      "description": "Password for an encrypted PDF. Supply the user or owner password and the document is decrypted in memory to complete this read (encrypted inputs are limited to 16 MiB). Leave it unset for an unencrypted document, or for an encrypted one that opens without a password. A document that needs a password cannot be read without it, and this tool never removes or weakens a document's protection.",
      "type": "string"
    },
    "pdf_path": {
      "description": "Path to the PDF file",
      "type": "string"
    }
  },
  "required": [
    "pdf_path"
  ],
  "type": "object"
}
sha256:ad057b6143d0b7b8a156a39d40be7bf969d717d11e1d96471e2d03e76bba39b3

Output schema

{
  "anyOf": [
    {
      "additionalProperties": false,
      "properties": {
        "active_path": {
          "type": "string"
        },
        "backup_path": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ]
        },
        "fieldCount": {
          "type": "integer"
        },
        "fields": {
          "items": {
            "additionalProperties": false,
            "properties": {
              "currentValue": {
                "anyOf": [
                  {
                    "type": "string"
                  },
                  {
                    "type": "boolean"
                  },
                  {
                    "items": {
                      "type": "string"
                    },
                    "type": "array"
                  }
                ]
              },
              "name": {
                "type": "string"
              },
              "options": {
                "items": {
                  "type": "string"
                },
                "type": "array"
              },
              "type": {
                "enum": [
                  "text",
                  "checkbox",
                  "radio",
                  "dropdown",
                  "unknown"
                ],
                "type": "string"
              }
            },
            "required": [
              "name",
              "type",
              "options",
              "currentValue"
            ],
            "type": "object"
          },
          "type": "array"
        },
        "hasFormFields": {
          "type": "boolean"
        },
        "initialPage": {
          "type": "integer"
        },
        "last_mutation_at": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ]
        },
        "last_mutation_tool": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ]
        },
        "pdfPath": {
          "type": "string"
        },
        "totalBytes": {
          "type": "integer"
        }
      },
      "required": [
        "pdfPath",
        "totalBytes",
        "initialPage",
        "fields",
        "fieldCount",
        "hasFormFields",
        "active_path",
        "backup_path",
        "last_mutation_tool",
        "last_mutation_at"
      ],
      "type": "object"
    },
    {
      "additionalProperties": false,
      "properties": {
        "error": {
          "additionalProperties": false,
          "properties": {
            "code": {
              "enum": [
                "internal_validation_error",
                "path_policy_denied",
                "tool_execution_failed"
              ],
              "type": "string"
            },
            "error_schema_version": {
              "const": 1
            }
          },
          "required": [
            "error_schema_version",
            "code"
          ],
          "type": "object"
        },
        "status": {
          "const": "failed"
        }
      },
      "required": [
        "status",
        "error"
      ],
      "type": "object"
    }
  ],
  "type": "object"
}
sha256:8228bb9d4087430cab91d0d0d44e3dcd935f4aba97580ee9cf3d99c339c9e135

Description hash: sha256:b2a016dc632f683d8acf7f9673cf66dfa80d5c330a903e78b7174ee2ca7f3c66

Interface hash: sha256:07be3cbf5aef9edc894e4ad05cdb503eea6f7b0e5111e5984561efd40ec2b90a

Other observed Modelara metadata
{
  "id": "mcp:pdf-tools/read_pdf_fields",
  "title": "Read PDF Form Fields",
  "source": {
    "type": "mcp",
    "server": "pdf-tools",
    "operation": "read_pdf_fields"
  },
  "declared": {
    "read_only": "false",
    "destructive": "false",
    "idempotent": "false",
    "open_world": "false"
  },
  "safety": {
    "idempotent": "false",
    "retry_safe": "false"
  },
  "metadata": {
    "mcp.annotations": "present"
  },
  "fingerprint": "sha256:36b625ace4bc1129e2de76d06d4d5a90aaa2d318a1415d4af818f0236ff03086"
}
toolwrite0.12.1No change observed
read_pdf_layoutpdf-toolkit:tool:read_pdf_layout
Observed interface and hashes

Extract a bounded page range into the versioned PDF Tools Extraction IR using the local pinned PDF.js parser. Returns source identity, raw page boxes and rotation when available, PDF.js-authoritative display geometry in physical 1/72-inch points after UserUnit, conservative lines and nonsemantic flow blocks, normalized flow/spatial text, and explicit raster or partial gaps. Text-run quads are advance boxes, not glyph ink bounds. This tool does not render pages, run OCR, infer tables, or fill an arbitrary schema. Narrow the page range or lower limits for large documents. All paths must be absolute paths on the user's local machine, NOT Claude container paths (/mnt/...).

Input schema

{
  "additionalProperties": false,
  "properties": {
    "end_page": {
      "description": "Last page to extract, inclusive. Default: start_page. At most 10 pages per call.",
      "minimum": 1,
      "type": "integer"
    },
    "max_characters": {
      "description": "Maximum returned raw text characters across the requested range. Default: 50000.",
      "maximum": 100000,
      "minimum": 1,
      "type": "integer"
    },
    "max_items": {
      "description": "Maximum returned raw text items across the requested range. Default: 1000.",
      "maximum": 5000,
      "minimum": 1,
      "type": "integer"
    },
    "max_output_characters": {
      "description": "Maximum serialized structured-output characters. Whole page detail is omitted with explicit metadata if needed. Default: 50000.",
      "maximum": 200000,
      "minimum": 20000,
      "type": "integer"
    },
    "password": {
      "description": "Password for an encrypted PDF, when required.",
      "type": "string"
    },
    "pdf_path": {
      "description": "Absolute path, or ~/ path, to the local PDF file.",
      "type": "string"
    },
    "start_page": {
      "description": "First page to extract, 1-indexed. Default: 1.",
      "minimum": 1,
      "type": "integer"
    }
  },
  "required": [
    "pdf_path"
  ],
  "type": "object"
}
sha256:bd11b3c155cc60cd906bdce9e0c379be02c586a5c280d4445dd7a5dad1d73be9

Output schema

{
  "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_ir_options"
            },
            "max_characters": {
              "type": "integer"
            },
            "max_items": {
              "type": "integer"
            },
            "max_output_characters": {
              "type": "integer"
            },
            "parser_version": {
              "const": "5.4.624"
            },
            "requested_end_page": {
              "type": "integer"
            },
            "requested_start_page": {
              "type": "integer"
            },
            "source_sha256": {
              "pattern": "^[a-f0-9]{64}$",
              "type": "string"
            }
          },
          "required": [
            "kind",
            "source_sha256",
            "parser_version",
            "ir_version",
            "requested_start_page",
            "requested_end_page",
            "max_items",
            "max_characters",
            "max_output_characters"
          ],
          "type": "object"
        },
        "ir": {
          "additionalProperties": false,
          "properties": {
            "name": {
              "const": "pdf-tools.extraction-ir"
            },
            "version": {
              "const": "1.6.0"
            }
          },
          "required": [
            "name",
            "version"
          ],
          "type": "object"
        },
        "limitations": {
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        "limits": {
          "additionalProperties": false,
          "properties": {
            "deadline_ms": {
              "type": "integer"
            },
            "max_characters": {
              "type": "integer"
            },
            "max_items": {
              "type": "integer"
            },
            "max_output_characters": {
              "type": "integer"
            }
          },
          "required": [
            "max_items",
            "max_characters",
            "max_output_characters",
            "deadline_ms"
          ],
          "type": "object"
        },
        "page_range": {
          "additionalProperties": false,
          "properties": {
            "end_page": {
              "type": "integer"
            },
            "requested_end_page": {
              "type": "integer"
            },
            "requested_start_page": {
              "type": "integer"
            },
            "start_page": {
              "type": "integer"
            },
            "total_pages": {
              "type": "integer"
            }
          },
          "required": [
            "requested_start_page",
            "requested_end_page",
            "start_page",
            "end_page",
            "total_pages"
          ],
          "type": "object"
        },
        "pages": {
          "items": {
            "additionalProperties": false,
            "properties": {
              "blocks": {
                "items": {
                  "additionalProperties": false,
                  "properties": {
                    "column_index": {
                      "type": "integer"
                    },
                    "id": {
                      "type": "string"
                    },
                    "kind": {
                      "enum": [
                        "page_flow",
                        "column_flow",
                        "spanning_flow"
                      ],
                      "type": "string"
                    },
                    "line_ids": {
                      "items": {
                        "type": "string"
                      },
                      "type": "array"
                    }
                  },
                  "required": [
                    "id",
                    "kind",
                    "column_index",
                    "line_ids"
                  ],
                  "type": "object"
                },
                "type": "array"
              },
              "counts": {
                "additionalProperties": false,
                "properties": {
                  "observed_characters": {
                    "type": "integer"
                  },
                  "observed_items": {
                    "type": "integer"
                  },
                  "observed_non_whitespace_items": {
                    "type": "integer"
                  },
                  "returned_characters": {
                    "type": "integer"
                  },
                  "returned_items": {
                    "type": "integer"
                  },
                  "returned_non_whitespace_items": {
                    "type": "integer"
                  }
                },
                "required": [
                  "observed_items",
                  "returned_items",
                  "observed_non_whitespace_items",
                  "returned_non_whitespace_items",
                  "observed_characters",
                  "returned_characters"
                ],
                "type": "object"
              },
              "errors": {
                "items": {
                  "additionalProperties": false,
                  "properties": {
                    "code": {
                      "type": "string"
                    },
                    "message": {
                      "type": "string"
                    },
                    "stage": {
                      "enum": [
                        "page",
                        "text",
                        "operators",
                        "geometry",
                        "annotations",
                        "ruled_rects"
                      ],
                      "type": "string"
                    }
                  },
                  "required": [
                    "stage",
                    "code",
                    "message"
                  ],
                  "type": "object"
                },
                "type": "array"
              },
              "extraction_status": {
                "enum": [
                  "complete",
                  "partial",
                  "failed"
                ],
                "type": "string"
              },
              "flow_text": {
                "type": "string"
              },
              "geometry": {
                "additionalProperties": false,
                "properties": {
                  "crop_box": {
                    "anyOf": [
                      {
                        "additionalProperties": false,
                        "properties": {
                          "height": {
                            "type": "number"
                          },
                          "width": {
                            "type": "number"
                          },
                          "x": {
                            "type": "number"
                          },
                          "y": {
                            "type": "number"
                          }
                        },
                        "required": [
                          "x",
                          "y",
                          "width",
                          "height"
                        ],
                        "type": "object"
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "display_height": {
                    "anyOf": [
                      {
                        "type": "number"
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "display_rotation": {
                    "anyOf": [
                      {
                        "enum": [
                          0,
                          90,
                          180,
                          270
                        ],
                        "type": "integer"
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "display_width": {
                    "anyOf": [
                      {
                        "type": "number"
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "item_space": {
                    "additionalProperties": false,
                    "properties": {
                      "origin": {
                        "const": "top_left"
                      },
                      "reference_box": {
                        "const": "pdfjs_display_viewport"
                      },
                      "unit": {
                        "const": "points_1_72_in_after_user_unit"
                      }
                    },
                    "required": [
                      "origin",
                      "unit",
                      "reference_box"
                    ],
                    "type": "object"
                  },
                  "media_box": {
                    "anyOf": [
                      {
                        "additionalProperties": false,
                        "properties": {
                          "height": {
                            "type": "number"
                          },
                          "width": {
                            "type": "number"
                          },
                          "x": {
                            "type": "number"
                          },
                          "y": {
                            "type": "number"
                          }
                        },
                        "required": [
                          "x",
                          "y",
                          "width",
                          "height"
                        ],
                        "type": "object"
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "page": {
                    "type": "integer"
                  },
                  "pdfjs_view": {
                    "anyOf": [
                      {
                        "items": {
                          "type": "number"
                        },
                        "maxItems": 4,
                        "minItems": 4,
                        "type": "array"
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "raw_page_space": {
                    "additionalProperties": false,
                    "properties": {
                      "basis": {
                        "const": "pdf_default_user_space"
                      },
                      "stage": {
                        "const": "before_user_unit_and_page_rotation"
                      },
                      "unit": {
                        "const": "pdf_user_unit"
                      }
                    },
                    "required": [
                      "basis",
                      "unit",
                      "stage"
                    ],
                    "type": "object"
                  },
                  "raw_pdf_rotation": {
                    "anyOf": [
                      {
                        "enum": [
                          0,
                          90,
                          180,
                          270
                        ],
                        "type": "integer"
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "rotation_matches_raw": {
                    "anyOf": [
                      {
                        "type": "boolean"
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "user_unit": {
                    "anyOf": [
                      {
                        "type": "number"
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "viewport_transform": {
                    "anyOf": [
                      {
                        "items": {
                          "type": "number"
                        },
                        "maxItems": 6,
                        "minItems": 6,
                        "type": "array"
                      },
                      {
                        "type": "null"
                      }
                    ]
                  }
                },
                "required": [
                  "page",
                  "media_box",
                  "crop_box",
                  "pdfjs_view",
                  "user_unit",
                  "raw_pdf_rotation",
                  "display_rotation",
                  "rotation_matches_raw",
                  "display_width",
                  "display_height",
                  "viewport_transform",
                  "raw_page_space",
                  "item_space"
                ],
                "type": "object"
              },
              "has_image_operations": {
                "anyOf": [
                  {
                    "type": "boolean"
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "has_vector_paint_operations": {
                "anyOf": [
                  {
                    "type": "boolean"
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "id": {
                "type": "string"
              },
              "image_detection_status": {
                "enum": [
                  "detected",
                  "not_detected",
                  "failed"
                ],
                "type": "string"
              },
              "limitations": {
                "items": {
                  "type": "string"
                },
                "type": "array"
              },
              "lines": {
                "items": {
                  "additionalProperties": false,
                  "properties": {
                    "column_index": {
                      "type": "integer"
                    },
                    "direction": {
                      "enum": [
                        "ltr",
                        "rtl",
                        "ttb",
                        "unknown"
                      ],
                      "type": "string"
                    },
                    "height": {
                      "type": "number"
                    },
                    "id": {
                      "type": "string"
                    },
                    "item_ids": {
                      "items": {
                        "type": "string"
                      },
                      "type": "array"
                    },
                    "reading_order_index": {
                      "type": "integer"
                    },
                    "source_first_index": {
                      "type": "integer"
                    },
                    "text": {
                      "type": "string"
                    },
                    "width": {
                      "type": "number"
                    },
                    "x": {
                      "type": "number"
                    },
                    "y": {
                      "type": "number"
                    }
                  },
                  "required": [
                    "id",
                    "source_first_index",
                    "text",
                    "x",
                    "y",
                    "width",
                    "height",
                    "direction",
                    "item_ids",
                    "reading_order_index",
                    "column_index"
                  ],
                  "type": "object"
                },
                "type": "array"
              },
              "link_annotations": {
                "additionalProperties": false,
                "properties": {
                  "items": {
                    "items": {
                      "additionalProperties": false,
                      "properties": {
                        "id": {
                          "type": "string"
                        },
                        "rect": {
                          "anyOf": [
                            {
                              "additionalProperties": false,
                              "properties": {
                                "height": {
                                  "type": "number"
                                },
                                "width": {
                                  "type": "number"
                                },
                                "x": {
                                  "type": "number"
                                },
                                "y": {
                                  "type": "number"
                                }
                              },
                              "required": [
                                "x",
                                "y",
                                "width",
                                "height"
                              ],
                              "type": "object"
                            },
                            {
                              "type": "null"
                            }
                          ]
                        },
                        "target_kind": {
                          "enum": [
                            "http",
                            "internal_destination",
                            "action",
                            "unsupported_scheme",
                            "ambiguous_target",
                            "none"
                          ],
                          "type": "string"
                        },
                        "url": {
                          "anyOf": [
                            {
                              "type": "string"
                            },
                            {
                              "type": "null"
                            }
                          ]
                        }
                      },
                      "required": [
                        "id",
                        "rect",
                        "target_kind",
                        "url"
                      ],
                      "type": "object"
                    },
                    "type": "array"
                  },
                  "status": {
                    "enum": [
                      "available",
                      "unavailable"
                    ],
                    "type": "string"
                  },
                  "truncated": {
                    "type": "boolean"
                  }
                },
                "required": [
                  "status",
                  "truncated",
                  "items"
                ],
                "type": "object"
              },
              "modality_hint": {
                "enum": [
                  "text-layer-candidate",
                  "mixed-content-candidate",
                  "image-only-candidate",
                  "vector-only-candidate",
                  "empty-candidate",
                  "unknown"
                ],
                "type": "string"
              },
              "needs_visual_inspection": {
                "type": "boolean"
              },
              "operator_counts": {
                "anyOf": [
                  {
                    "additionalProperties": false,
                    "properties": {
                      "image_paint_ops": {
                        "minimum": 0,
                        "type": "integer"
                      },
                      "path_construct_ops": {
                        "minimum": 0,
                        "type": "integer"
                      },
                      "path_segments": {
                        "minimum": 0,
                        "type": "integer"
                      }
                    },
                    "required": [
                      "image_paint_ops",
                      "path_segments",
                      "path_construct_ops"
                    ],
                    "type": "object"
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "page": {
                "type": "integer"
              },
              "painted_rectangles": {
                "additionalProperties": false,
                "properties": {
                  "items": {
                    "items": {
                      "additionalProperties": false,
                      "properties": {
                        "bbox": {
                          "additionalProperties": false,
                          "properties": {
                            "height": {
                              "type": "number"
                            },
                            "width": {
                              "type": "number"
                            },
                            "x": {
                              "type": "number"
                            },
                            "y": {
                              "type": "number"
                            }
                          },
                          "required": [
                            "x",
                            "y",
                            "width",
                            "height"
                          ],
                          "type": "object"
                        },
                        "graphics_transform": {
                          "items": {
                            "type": "number"
                          },
                          "maxItems": 6,
                          "minItems": 6,
                          "type": "array"
                        },
                        "id": {
                          "type": "string"
                        },
                        "quad": {
                          "items": {
                            "additionalProperties": false,
                            "properties": {
                              "x": {
                                "type": "number"
                              },
                              "y": {
                                "type": "number"
                              }
                            },
                            "required": [
                              "x",
                              "y"
                            ],
                            "type": "object"
                          },
                          "maxItems": 4,
                          "minItems": 4,
                          "type": "array"
                        },
                        "source_kind": {
                          "const": "solid_color_image_mask"
                        },
                        "source_operation_index": {
                          "type": "integer"
                        }
                      },
                      "required": [
                        "id",
                        "source_operation_index",
                        "source_kind",
                        "graphics_transform",
                        "quad",
                        "bbox"
                      ],
                      "type": "object"
                    },
                    "type": "array"
                  },
                  "observed_count": {
                    "type": "integer"
                  },
                  "returned_count": {
                    "type": "integer"
                  },
                  "status": {
                    "enum": [
                      "available",
                      "unavailable"
                    ],
                    "type": "string"
                  },
                  "truncated": {
                    "type": "boolean"
                  }
                },
                "required": [
                  "status",
                  "truncated",
                  "observed_count",
                  "returned_count",
                  "items"
                ],
                "type": "object"
              },
              "raw_items": {
                "items": {
                  "additionalProperties": false,
                  "properties": {
                    "bbox": {
                      "anyOf": [
                        {
                          "additionalProperties": false,
                          "properties": {
                            "height": {
                              "type": "number"
                            },
                            "width": {
                              "type": "number"
                            },
                            "x": {
                              "type": "number"
                            },
                            "y": {
                              "type": "number"
                            }
                          },
                          "required": [
                            "x",
                            "y",
                            "width",
                            "height"
                          ],
                          "type": "object"
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "bbox_status": {
                      "enum": [
                        "valid",
                        "degenerate",
                        "invalid"
                      ],
                      "type": "string"
                    },
                    "column_index": {
                      "anyOf": [
                        {
                          "type": "integer"
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "direction": {
                      "enum": [
                        "ltr",
                        "rtl",
                        "ttb",
                        "unknown"
                      ],
                      "type": "string"
                    },
                    "font": {
                      "additionalProperties": false,
                      "properties": {
                        "ascent": {
                          "anyOf": [
                            {
                              "type": "number"
                            },
                            {
                              "type": "null"
                            }
                          ]
                        },
                        "descent": {
                          "anyOf": [
                            {
                              "type": "number"
                            },
                            {
                              "type": "null"
                            }
                          ]
                        },
                        "family": {
                          "anyOf": [
                            {
                              "type": "string"
                            },
                            {
                              "type": "null"
                            }
                          ]
                        },
                        "vertical": {
                          "type": "boolean"
                        }
                      },
                      "required": [
                        "family",
                        "ascent",
                        "descent",
                        "vertical"
                      ],
                      "type": "object"
                    },
                    "font_name": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "geometry_kind": {
                      "const": "pdfjs_text_run_advance_box"
                    },
                    "geometry_provenance": {
                      "additionalProperties": false,
                      "properties": {
                        "advance_source": {
                          "enum": [
                            "item_width",
                            "item_height",
                            "operator_advance_width"
                          ],
                          "type": "string"
                        },
                        "ascent_ratio": {
                          "anyOf": [
                            {
                              "type": "number"
                            },
                            {
                              "type": "null"
                            }
                          ]
                        },
                        "ascent_source": {
                          "anyOf": [
                            {
                              "enum": [
                                "style_ascent",
                                "style_descent_fallback",
                                "default_0_8"
                              ],
                              "type": "string"
                            },
                            {
                              "type": "null"
                            }
                          ]
                        },
                        "formula": {
                          "enum": [
                            "pdfjs_text_item_style_metric_advance_box_approximation",
                            "pdfjs_collapsed_type3_operator_advance_box_approximation"
                          ],
                          "type": "string"
                        },
                        "quad_order": {
                          "const": "anchor_top_terminal_top_anchor_bottom_terminal_bottom"
                        }
                      },
                      "required": [
                        "formula",
                        "quad_order",
                        "advance_source",
                        "ascent_source",
                        "ascent_ratio"
                      ],
                      "type": "object"
                    },
                    "geometry_valid": {
                      "type": "boolean"
                    },
                    "glyph_recoveries": {
                      "items": {
                        "additionalProperties": false,
                        "properties": {
                          "binding_kind": {
                            "enum": [
                              "exact_text_scalar",
                              "collapsed_whitespace_item"
                            ],
                            "type": "string"
                          },
                          "font_name": {
                            "anyOf": [
                              {
                                "type": "string"
                              },
                              {
                                "type": "null"
                              }
                            ]
                          },
                          "glyph_evidence_version": {
                            "type": "string"
                          },
                          "glyph_sha256": {
                            "type": "string"
                          },
                          "operator_advance_width": {
                            "anyOf": [
                              {
                                "type": "number"
                              },
                              {
                                "type": "null"
                              }
                            ]
                          },
                          "operator_anchor_span_width": {
                            "anyOf": [
                              {
                                "type": "number"
                              },
                              {
                                "type": "null"
                              }
                            ]
                          },
                          "operator_raw_transform": {
                            "anyOf": [
                              {
                                "items": {
                                  "type": "number"
                                },
                                "maxItems": 6,
                                "minItems": 6,
                                "type": "array"
                              },
                              {
                                "type": "null"
                              }
                            ]
                          },
                          "operator_unicode": {
                            "type": "string"
                          },
                          "original_char_code": {
                            "type": "integer"
                          },
                          "output_utf16_end": {
                            "type": "integer"
                          },
                          "output_utf16_start": {
                            "type": "integer"
                          },
                          "qualification": {
                            "type": "string"
                          },
                          "registry_id": {
                            "type": "string"
                          },
                          "source_unicode": {
                            "type": "string"
                          },
                          "source_utf16_end": {
                            "type": "integer"
                          },
                          "source_utf16_start": {
                            "type": "integer"
                          },
                          "target_unicode": {
                            "type": "string"
                          },
                          "tfm_reference_version": {
                            "type": "string"
                          },
                          "witness_glyph_sha256": {
                            "items": {
                              "type": "string"
                            },
                            "type": "array"
                          }
                        },
                        "required": [
                          "source_utf16_start",
                          "source_utf16_end",
                          "output_utf16_start",
                          "output_utf16_end",
                          "original_char_code",
                          "source_unicode",
                          "operator_unicode",
                          "target_unicode",
                          "binding_kind",
                          "operator_advance_width",
                          "operator_anchor_span_width",
                          "operator_raw_transform",
                          "font_name",
                          "registry_id",
                          "qualification",
                          "glyph_sha256",
                          "witness_glyph_sha256",
                          "tfm_reference_version",
                          "glyph_evidence_version"
                        ],
                        "type": "object"
                      },
                      "type": "array"
                    },
                    "has_eol": {
                      "type": "boolean"
                    },
                    "height": {
                      "anyOf": [
                        {
                          "type": "number"
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "id": {
                      "type": "string"
                    },
                    "is_whitespace": {
                      "type": "boolean"
                    },
                    "line_height": {
                      "anyOf": [
                        {
                          "type": "number"
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "line_id": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "quad": {
                      "anyOf": [
                        {
                          "items": {
                            "additionalProperties": false,
                            "properties": {
                              "x": {
                                "type": "number"
                              },
                              "y": {
                                "type": "number"
                              }
                            },
                            "required": [
                              "x",
                              "y"
                            ],
                            "type": "object"
                          },
                          "maxItems": 4,
                          "minItems": 4,
                          "type": "array"
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "raw_height": {
                      "anyOf": [
                        {
                          "type": "number"
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "raw_transform": {
                      "items": {
                        "anyOf": [
                          {
                            "type": "number"
                          },
                          {
                            "type": "null"
                          }
                        ]
                      },
                      "maxItems": 6,
                      "minItems": 6,
                      "type": "array"
                    },
                    "raw_width": {
                      "anyOf": [
                        {
                          "type": "number"
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "reading_order_index": {
                      "type": "integer"
                    },
                    "source_index": {
                      "type": "integer"
                    },
                    "source_text": {
                      "type": "string"
                    },
                    "text": {
                      "type": "string"
                    },
                    "text_kind": {
                      "enum": [
                        "empty",
                        "whitespace",
                        "non_whitespace"
                      ],
                      "type": "string"
                    },
                    "width": {
                      "anyOf": [
                        {
                          "type": "number"
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "x": {
                      "anyOf": [
                        {
                          "type": "number"
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "y": {
                      "anyOf": [
                        {
                          "type": "number"
                        },
                        {
                          "type": "null"
                        }
                      ]
                    }
                  },
                  "required": [
                    "id",
                    "source_index",
                    "text",
                    "is_whitespace",
                    "text_kind",
                    "has_eol",
                    "raw_transform",
                    "raw_width",
                    "raw_height",
                    "font_name",
                    "font",
                    "geometry_kind",
                    "geometry_valid",
                    "bbox_status",
                    "geometry_provenance",
                    "quad",
                    "bbox",
                    "x",
                    "y",
                    "width",
                    "height",
                    "line_height",
                    "direction",
                    "reading_order_index",
                    "line_id",
                    "column_index"
                  ],
                  "type": "object"
                },
                "type": "array"
              },
              "reading_order": {
                "additionalProperties": false,
                "properties": {
                  "column_count": {
                    "type": "integer"
                  },
                  "confidence": {
                    "const": "not_calibrated"
                  },
                  "limitations": {
                    "items": {
                      "type": "string"
                    },
                    "type": "array"
                  },
                  "strategy": {
                    "enum": [
                      "source_order_fallback",
                      "two_column_left_to_right",
                      "unavailable_output_omitted"
                    ],
                    "type": "string"
                  }
                },
                "required": [
                  "strategy",
                  "confidence",
                  "column_count",
                  "limitations"
                ],
                "type": "object"
              },
              "ruled_rects": {
                "additionalProperties": false,
                "properties": {
                  "items": {
                    "items": {
                      "additionalProperties": false,
                      "properties": {
                        "height": {
                          "minimum": 0,
                          "type": "number"
                        },
                        "verb": {
                          "enum": [
                            "fill",
                            "stroke",
                            "clip",
                            "none"
                          ],
                          "type": "string"
                        },
                        "width": {
                          "minimum": 0,
                          "type": "number"
                        },
                        "x": {
                          "type": "number"
                        },
                        "y": {
                          "type": "number"
                        }
                      },
                      "required": [
                        "x",
                        "y",
                        "width",
                        "height",
                        "verb"
                      ],
                      "type": "object"
                    },
                    "type": "array"
                  },
                  "observed_count": {
                    "minimum": 0,
                    "type": "integer"
                  },
                  "returned_count": {
                    "minimum": 0,
                    "type": "integer"
                  },
                  "status": {
                    "enum": [
                      "available",
                      "truncated",
                      "failed",
                      "unavailable"
                    ],
                    "type": "string"
                  }
                },
                "required": [
                  "status",
                  "observed_count",
                  "returned_count",
                  "items"
                ],
                "type": "object"
              },
              "ruling_segments": {
                "additionalProperties": false,
                "properties": {
                  "items": {
                    "items": {
                      "additionalProperties": false,
                      "properties": {
                        "orientation": {
                          "enum": [
                            "horizontal",
                            "vertical"
                          ],
                          "type": "string"
                        },
                        "source_operator_index": {
                          "minimum": 0,
                          "type": "integer"
                        },
                        "x1": {
                          "type": "number"
                        },
                        "x2": {
                          "type": "number"
                        },
                        "y1": {
                          "type": "number"
                        },
                        "y2": {
                          "type": "number"
                        }
                      },
                      "required": [
                        "orientation",
                        "x1",
                        "y1",
                        "x2",
                        "y2",
                        "source_operator_index"
                      ],
                      "type": "object"
                    },
                    "type": "array"
                  },
                  "observed_count": {
                    "minimum": 0,
                    "type": "integer"
                  },
                  "returned_count": {
                    "minimum": 0,
                    "type": "integer"
                  },
                  "status": {
                    "enum": [
                      "available",
                      "unavailable"
                    ],
                    "type": "string"
                  },
                  "truncated": {
                    "type": "boolean"
                  }
                },
                "required": [
                  "status",
                  "truncated",
                  "observed_count",
                  "returned_count",
                  "items"
                ],
                "type": "object"
              },
              "spatial_text": {
                "type": "string"
              },
              "text_integrity": {
                "additionalProperties": false,
                "properties": {
                  "signals": {
                    "items": {
                      "additionalProperties": false,
                      "properties": {
                        "count": {
                          "minimum": 1,
                          "type": "integer"
                        },
                        "kind": {
                          "enum": [
                            "replacement_characters",
                            "private_use_runs",
                            "c1_control_tokens",
                            "non_alphanumeric_dominance"
                          ],
                          "type": "string"
                        }
                      },
                      "required": [
                        "kind",
                        "count"
                      ],
                      "type": "object"
                    },
                    "type": "array"
                  },
                  "status": {
                    "enum": [
                      "ok",
                      "suspect",
                      "unavailable"
                    ],
                    "type": "string"
                  }
                },
                "required": [
                  "status",
                  "signals"
                ],
                "type": "object"
              },
              "text_layer_status": {
                "enum": [
                  "present",
                  "empty",
                  "partial",
                  "failed"
                ],
                "type": "string"
              },
              "truncation": {
                "additionalProperties": false,
                "properties": {
                  "first_omitted_source_index": {
                    "anyOf": [
                      {
                        "type": "integer"
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "omitted_characters": {
                    "type": "integer"
                  },
                  "omitted_items": {
                    "type": "integer"
                  },
                  "omitted_non_whitespace_items": {
                    "type": "integer"
                  },
                  "reasons": {
                    "items": {
                      "type": "string"
                    },
                    "type": "array"
                  },
                  "truncated": {
                    "type": "boolean"
                  }
                },
                "required": [
                  "truncated",
                  "reasons",
                  "omitted_items",
                  "omitted_non_whitespace_items",
                  "omitted_characters",
                  "first_omitted_source_index"
                ],
                "type": "object"
              }
            },
            "required": [
              "id",
              "page",
              "text_layer_status",
              "image_detection_status",
              "modality_hint",
              "extraction_status",
              "needs_visual_inspection",
              "geometry",
              "has_image_operations",
              "has_vector_paint_operations",
              "ruled_rects",
              "ruling_segments",
              "text_integrity",
              "operator_counts",
              "painted_rectangles",
              "link_annotations",
              "raw_items",
              "lines",
              "blocks",
              "reading_order",
              "flow_text",
              "spatial_text",
              "counts",
              "truncation",
              "errors",
              "limitations"
            ],
            "type": "object"
          },
          "type": "array"
        },
        "parser": {
          "additionalProperties": false,
          "properties": {
            "name": {
              "const": "pdfjs-dist"
            },
            "version": {
              "const": "5.4.624"
            }
          },
          "required": [
            "name",
            "version"
          ],
          "type": "object"
        },
        "source": {
          "additionalProperties": false,
          "properties": {
            "file_name": {
              "type": "string"
            },
            "pdf_path": {
              "type": "string"
            },
            "sha256": {
              "pattern": "^[a-f0-9]{64}$",
              "type": "string"
            },
            "size_bytes": {
              "type": "integer"
            }
          },
          "required": [
            "pdf_path",
            "file_name",
            "sha256",
            "size_bytes"
          ],
          "type": "object"
        },
        "truncation": {
          "additionalProperties": false,
          "properties": {
            "first_omitted_page": {
              "anyOf": [
                {
                  "type": "integer"
                },
                {
                  "type": "null"
                }
              ]
            },
            "first_omitted_source_index": {
              "anyOf": [
                {
                  "type": "integer"
                },
                {
                  "type": "null"
                }
              ]
            },
            "omitted_characters": {
              "type": "integer"
            },
            "omitted_items": {
              "type": "integer"
            },
            "reasons": {
              "items": {
                "type": "string"
              },
              "type": "array"
            },
            "truncated": {
              "type": "boolean"
            }
          },
          "required": [
            "truncated",
            "reasons",
            "omitted_items",
            "omitted_characters",
            "first_omitted_page",
            "first_omitted_source_index"
          ],
          "type": "object"
        }
      },
      "required": [
        "ir",
        "parser",
        "source",
        "id_scope",
        "page_range",
        "extraction_status",
        "pages",
        "limits",
        "truncation",
        "limitations"
      ],
      "type": "object"
    },
    {
      "additionalProperties": false,
      "properties": {
        "error": {
          "additionalProperties": false,
          "properties": {
            "code": {
              "enum": [
                "internal_validation_error",
                "path_policy_denied",
                "tool_execution_failed"
              ],
              "type": "string"
            },
            "error_schema_version": {
              "const": 1
            }
          },
          "required": [
            "error_schema_version",
            "code"
          ],
          "type": "object"
        },
        "status": {
          "const": "failed"
        }
      },
      "required": [
        "status",
        "error"
      ],
      "type": "object"
    },
    {
      "additionalProperties": false,
      "properties": {
        "error": {
          "additionalProperties": false,
          "properties": {
            "code": {
              "enum": [
                "PASSWORD_REQUIRED",
                "PASSWORD_INCORRECT"
              ],
              "type": "string"
            },
            "error_schema_version": {
              "const": 1
            }
          },
          "required": [
            "error_schema_version",
            "code"
          ],
          "type": "object"
        },
        "status": {
          "const": "failed"
        }
      },
      "required": [
        "status",
        "error"
      ],
      "type": "object"
    },
    {
      "additionalProperties": false,
      "properties": {
        "error": {
          "additionalProperties": false,
          "properties": {
            "code": {
              "const": "PDF_RESOURCE_LIMIT_EXCEEDED"
            },
            "error_schema_version": {
              "const": 1
            }
          },
          "required": [
            "error_schema_version",
            "code"
          ],
          "type": "object"
        },
        "status": {
          "const": "failed"
        }
      },
      "required": [
        "status",
        "error"
      ],
      "type": "object"
    }
  ],
  "type": "object"
}
sha256:24d17039b7a070f5fae9275e88360059d6e1d60b48108707207b36390b0ff47c

Description hash: sha256:4658c2f7bf43ec1a0704b8dc6e360fa499b3b19aed5f89079298a2ff1c88269f

Interface hash: sha256:fbd5e6f6589cd6a19a469791990576e4f06e702779ba8161e27b569a1f6ce914

Other observed Modelara metadata
{
  "id": "mcp:pdf-tools/read_pdf_layout",
  "title": "Read PDF Layout",
  "source": {
    "type": "mcp",
    "server": "pdf-tools",
    "operation": "read_pdf_layout"
  },
  "declared": {
    "read_only": "true",
    "destructive": "false",
    "idempotent": "true",
    "open_world": "false"
  },
  "safety": {
    "idempotent": "true",
    "retry_safe": "true"
  },
  "metadata": {
    "mcp.annotations": "present"
  },
  "fingerprint": "sha256:f6b7a58d4775b82763a22a15782280618bdf272824d17372a3d049c245decd8c"
}
toolread0.12.10.13.0
read_pdf_pagespdf-toolkit:tool:read_pdf_pages
Observed interface and hashes

Read a specific page range from a PDF with page-numbered structured output. Use this when the model should inspect or quote a bounded slice of the document instead of loading the whole thing at once. All paths must be absolute paths on the user's local machine, NOT Claude container paths (/mnt/...).

Input schema

{
  "examples": [
    {
      "end_page": 6,
      "pdf_path": "/Users/alice/Documents/nda.pdf",
      "start_page": 4
    }
  ],
  "properties": {
    "end_page": {
      "description": "Last page to read (1-indexed, inclusive, default: start_page).",
      "type": "number"
    },
    "max_chars_per_page": {
      "description": "Maximum characters to return per page, an integer from 1 to 20000 (default: 4000). Every page in one call also draws on a shared 16,000-character budget, so a later page in a long range can return less text than this, or none; read it with a later start_page.",
      "type": "number"
    },
    "pdf_path": {
      "description": "Absolute path to the PDF file.",
      "type": "string"
    },
    "start_page": {
      "description": "First page to read (1-indexed, default: 1).",
      "type": "number"
    }
  },
  "required": [
    "pdf_path"
  ],
  "type": "object"
}
sha256:7889fa14a07855b3ada0bad41cc8bdb7899cfb17b71217e7023e52143f9d086d

Output schema

{
  "anyOf": [
    {
      "additionalProperties": false,
      "properties": {
        "end_page": {
          "type": "integer"
        },
        "file_name": {
          "type": "string"
        },
        "pages": {
          "items": {
            "additionalProperties": false,
            "properties": {
              "char_count": {
                "type": "integer"
              },
              "page": {
                "type": "integer"
              },
              "returned_chars": {
                "type": "integer"
              },
              "text": {
                "type": "string"
              },
              "truncated": {
                "type": "boolean"
              }
            },
            "required": [
              "page",
              "char_count",
              "returned_chars",
              "truncated",
              "text"
            ],
            "type": "object"
          },
          "type": "array"
        },
        "pdf_path": {
          "type": "string"
        },
        "start_page": {
          "type": "integer"
        },
        "text_found": {
          "type": "boolean"
        },
        "total_pages": {
          "type": "integer"
        },
        "truncated": {
          "type": "boolean"
        }
      },
      "required": [
        "pdf_path",
        "file_name",
        "total_pages",
        "start_page",
        "end_page",
        "pages",
        "text_found",
        "truncated"
      ],
      "type": "object"
    },
    {
      "additionalProperties": false,
      "properties": {
        "error": {
          "additionalProperties": false,
          "properties": {
            "code": {
              "enum": [
                "internal_validation_error",
                "path_policy_denied",
                "tool_execution_failed"
              ],
              "type": "string"
            },
            "error_schema_version": {
              "const": 1
            }
          },
          "required": [
            "error_schema_version",
            "code"
          ],
          "type": "object"
        },
        "status": {
          "const": "failed"
        }
      },
      "required": [
        "status",
        "error"
      ],
      "type": "object"
    },
    {
      "additionalProperties": false,
      "properties": {
        "error": {
          "additionalProperties": false,
          "properties": {
            "code": {
              "const": "PDF_RESOURCE_LIMIT_EXCEEDED"
            },
            "error_schema_version": {
              "const": 1
            }
          },
          "required": [
            "error_schema_version",
            "code"
          ],
          "type": "object"
        },
        "status": {
          "const": "failed"
        }
      },
      "required": [
        "status",
        "error"
      ],
      "type": "object"
    }
  ],
  "type": "object"
}
sha256:721180ec88ef729717390a5290c9fbb6aafc510307f977677884a5814c781e76

Description hash: sha256:54135a1896ef1a5c28bebd9c3712caf6cc5c1b656d9ac00b5da21820f2629e76

Interface hash: sha256:15a968c9e2c40ee86cbdd5504d0477efe0a7775f8e22bb1570b7ca7149d83710

Other observed Modelara metadata
{
  "id": "mcp:pdf-tools/read_pdf_pages",
  "title": "Read PDF Pages",
  "source": {
    "type": "mcp",
    "server": "pdf-tools",
    "operation": "read_pdf_pages"
  },
  "declared": {
    "read_only": "true",
    "destructive": "false",
    "idempotent": "true",
    "open_world": "false"
  },
  "safety": {
    "idempotent": "true",
    "retry_safe": "true"
  },
  "metadata": {
    "mcp.annotations": "present"
  },
  "fingerprint": "sha256:8cdf75ad86ca0a40ead58b632905320a366fe7dd23152edd49851ed1f9bc4511"
}
toolread0.12.10.14.0
render_pdf_pagepdf-toolkit:tool:render_pdf_page
Observed interface and hashes

Render one PDF.js page view to a PNG image for visual reasoning. The source-bound result distinguishes raw MediaBox/CropBox geometry from the rotated, UserUnit-scaled PDF.js view and raster coordinate spaces. Use this when text extraction is weak or visual layout must be inspected. All paths must be absolute local paths, not host container paths.

Input schema

{
  "examples": [
    {
      "max_dimension_px": 1600,
      "page": 1,
      "pdf_path": "/Users/alice/Documents/scanned-invoice.pdf"
    }
  ],
  "properties": {
    "max_dimension_px": {
      "description": "Target size of the page image's longer side in pixels, an integer from 64 to 8192 (default: 1800). The render scale is held between 1 and 2.5 pixels per PDF.js viewport point, so a page whose longer side exceeds this many points renders larger than the target, and a target above 2.5 times that side renders smaller. Use smaller values for lighter previews.",
      "type": "number"
    },
    "page": {
      "description": "Page number to render (1-indexed, default: 1).",
      "type": "number"
    },
    "password": {
      "description": "Password for encrypted PDFs. PDF.js uses it, but this operation also loads page geometry with pdf-lib, which cannot decrypt PDFs, so an encrypted document still fails with the correct password.",
      "type": "string"
    },
    "pdf_path": {
      "description": "Absolute path to the PDF file.",
      "type": "string"
    }
  },
  "required": [
    "pdf_path"
  ],
  "type": "object"
}
sha256:281c8e9ea4160df6876372d9c4ece32511c4804043ba337fdaf28cf58a818a58

Output schema

{
  "anyOf": [
    {
      "additionalProperties": false,
      "properties": {
        "file_name": {
          "type": "string"
        },
        "height_points": {
          "type": "integer"
        },
        "mime_type": {
          "const": "image/png"
        },
        "observation_schema_version": {
          "const": "1.0"
        },
        "observation_sha256": {
          "pattern": "^[a-f0-9]{64}$",
          "type": "string"
        },
        "page": {
          "type": "integer"
        },
        "page_geometry": {
          "additionalProperties": false,
          "properties": {
            "coordinate_space": {
              "const": "pdf_user_space_bottom_left_points"
            },
            "crop_box": {
              "items": {
                "type": "number"
              },
              "maxItems": 4,
              "minItems": 4,
              "type": "array"
            },
            "geometry_source": {
              "enum": [
                "pdf-lib",
                "pdfjs-view-fallback"
              ],
              "type": "string"
            },
            "height_points": {
              "type": "number"
            },
            "media_box": {
              "anyOf": [
                {
                  "items": {
                    "type": "number"
                  },
                  "maxItems": 4,
                  "minItems": 4,
                  "type": "array"
                },
                {
                  "type": "null"
                }
              ]
            },
            "rotation": {
              "type": "number"
            },
            "user_unit": {
              "type": "number"
            },
            "width_points": {
              "type": "number"
            }
          },
          "required": [
            "geometry_source",
            "media_box",
            "crop_box",
            "width_points",
            "height_points",
            "rotation",
            "user_unit",
            "coordinate_space"
          ],
          "type": "object"
        },
        "page_view": {
          "additionalProperties": false,
          "properties": {
            "coordinate_space": {
              "const": "pdfjs_viewport_top_left_points"
            },
            "height_points": {
              "type": "number"
            },
            "rotation": {
              "type": "number"
            },
            "user_unit": {
              "type": "number"
            },
            "view_box": {
              "items": {
                "type": "number"
              },
              "maxItems": 4,
              "minItems": 4,
              "type": "array"
            },
            "width_points": {
              "type": "number"
            }
          },
          "required": [
            "view_box",
            "width_points",
            "height_points",
            "rotation",
            "user_unit",
            "coordinate_space"
          ],
          "type": "object"
        },
        "pdf_path": {
          "type": "string"
        },
        "png_sha256": {
          "pattern": "^[a-f0-9]{64}$",
          "type": "string"
        },
        "raw_pixel_sha256": {
          "anyOf": [
            {
              "pattern": "^[a-f0-9]{64}$",
              "type": "string"
            },
            {
              "type": "null"
            }
          ]
        },
        "raw_pixel_status": {
          "enum": [
            "available",
            "unavailable"
          ],
          "type": "string"
        },
        "rendered_coordinate_space": {
          "const": "raster_top_left_pixels"
        },
        "rendered_height_px": {
          "type": "integer"
        },
        "rendered_region": {
          "additionalProperties": false,
          "properties": {
            "height": {
              "type": "number"
            },
            "width": {
              "type": "number"
            },
            "x": {
              "type": "number"
            },
            "y": {
              "type": "number"
            }
          },
          "required": [
            "x",
            "y",
            "width",
            "height"
          ],
          "type": "object"
        },
        "rendered_width_px": {
          "type": "integer"
        },
        "renderer": {
          "enum": [
            "native-canvas",
            "macos-sips",
            "macos-quicklook"
          ],
          "type": "string"
        },
        "renderer_policy": {
          "enum": [
            "forced_unavailable",
            "native",
            "native_with_system_fallback",
            "system"
          ],
          "type": "string"
        },
        "requested_coordinate_space": {
          "const": "pdfjs_viewport_top_left_points"
        },
        "requested_region": {
          "additionalProperties": false,
          "properties": {
            "height": {
              "type": "number"
            },
            "width": {
              "type": "number"
            },
            "x": {
              "type": "number"
            },
            "y": {
              "type": "number"
            }
          },
          "required": [
            "x",
            "y",
            "width",
            "height"
          ],
          "type": "object"
        },
        "scale": {
          "type": "number"
        },
        "source": {
          "additionalProperties": false,
          "properties": {
            "canonical_path": {
              "type": "string"
            },
            "file_name": {
              "type": "string"
            },
            "sha256": {
              "pattern": "^[a-f0-9]{64}$",
              "type": "string"
            },
            "size_bytes": {
              "type": "integer"
            }
          },
          "required": [
            "canonical_path",
            "file_name",
            "size_bytes",
            "sha256"
          ],
          "type": "object"
        },
        "total_pages": {
          "type": "integer"
        },
        "width_points": {
          "type": "integer"
        }
      },
      "required": [
        "pdf_path",
        "file_name",
        "page",
        "total_pages",
        "width_points",
        "height_points",
        "rendered_width_px",
        "rendered_height_px",
        "scale",
        "renderer",
        "mime_type",
        "observation_schema_version",
        "source",
        "page_geometry",
        "page_view",
        "requested_coordinate_space",
        "rendered_coordinate_space",
        "requested_region",
        "rendered_region",
        "renderer_policy",
        "png_sha256",
        "raw_pixel_sha256",
        "raw_pixel_status",
        "observation_sha256"
      ],
      "type": "object"
    },
    {
      "additionalProperties": false,
      "properties": {
        "error": {
          "additionalProperties": false,
          "properties": {
            "code": {
              "enum": [
                "internal_validation_error",
                "path_policy_denied",
                "tool_execution_failed"
              ],
              "type": "string"
            },
            "error_schema_version": {
              "const": 1
            }
          },
          "required": [
            "error_schema_version",
            "code"
          ],
          "type": "object"
        },
        "status": {
          "const": "failed"
        }
      },
      "required": [
        "status",
        "error"
      ],
      "type": "object"
    },
    {
      "additionalProperties": false,
      "properties": {
        "error": {
          "additionalProperties": false,
          "properties": {
            "code": {
              "const": "PDF_RESOURCE_LIMIT_EXCEEDED"
            },
            "error_schema_version": {
              "const": 1
            }
          },
          "required": [
            "error_schema_version",
            "code"
          ],
          "type": "object"
        },
        "status": {
          "const": "failed"
        }
      },
      "required": [
        "status",
        "error"
      ],
      "type": "object"
    }
  ],
  "type": "object"
}
sha256:0e253e878f8e21dbba4d6469af2caecef8eb4a491da2b623cd123dc222a28429

Description hash: sha256:15a31bdf90184629e81d0151a3881ecc423cc47135c3a87a48e07af0fc307d39

Interface hash: sha256:e1f850474a282af95e687a4b6fb82d8ccb6116514cb20d0f8a61a3a595c87b3e

Other observed Modelara metadata
{
  "id": "mcp:pdf-tools/render_pdf_page",
  "title": "Render PDF Page",
  "source": {
    "type": "mcp",
    "server": "pdf-tools",
    "operation": "render_pdf_page"
  },
  "declared": {
    "read_only": "true",
    "destructive": "false",
    "idempotent": "true",
    "open_world": "false"
  },
  "safety": {
    "idempotent": "true",
    "retry_safe": "true"
  },
  "metadata": {
    "mcp.annotations": "present"
  },
  "fingerprint": "sha256:71c5198b6b95425f26294274a590db76688fe90e3905a8c2c51cd833d88dc2e1"
}
toolread0.12.10.14.0
render_pdf_regionpdf-toolkit:tool:render_pdf_region
Observed interface and hashes

Render a rectangular region from the rotated, UserUnit-scaled PDF.js page view. Coordinates use a top-left origin in PDF.js viewport points and are not interchangeable with MediaBox-relative detect_signature_zones or signing coordinates. The macOS system renderer preserves this view mapping and reports raw pixels unavailable. All paths must be absolute local paths, not host container paths.

Input schema

{
  "examples": [
    {
      "height": 80,
      "max_dimension_px": 1200,
      "page": 8,
      "pdf_path": "/Users/alice/Documents/contract.pdf",
      "width": 220,
      "x": 72,
      "y": 620
    }
  ],
  "properties": {
    "height": {
      "description": "Height in rotated, UserUnit-scaled PDF.js viewport points.",
      "type": "number"
    },
    "max_dimension_px": {
      "description": "Target size of the region image's longer side in pixels, an integer from 64 to 8192 (default: 1400). The render scale is held between 0.1 and 4 pixels per PDF.js viewport point, so a region whose longer side exceeds ten times the target renders larger than it, and a target above four times that side renders smaller.",
      "type": "number"
    },
    "page": {
      "description": "Page number to render (1-indexed).",
      "type": "number"
    },
    "password": {
      "description": "Password for encrypted PDFs. PDF.js uses it, but this operation also loads page geometry with pdf-lib, which cannot decrypt PDFs, so an encrypted document still fails with the correct password.",
      "type": "string"
    },
    "pdf_path": {
      "description": "Absolute path to the PDF file.",
      "type": "string"
    },
    "width": {
      "description": "Width in rotated, UserUnit-scaled PDF.js viewport points.",
      "type": "number"
    },
    "x": {
      "description": "Left edge in PDF.js viewport points from the displayed page view's left edge.",
      "type": "number"
    },
    "y": {
      "description": "Top edge in PDF.js viewport points from the displayed page view's top edge.",
      "type": "number"
    }
  },
  "required": [
    "pdf_path",
    "page",
    "x",
    "y",
    "width",
    "height"
  ],
  "type": "object"
}
sha256:182ff7018a335195ee2b8e3a6f10bf2a4784979ecfdc57f8f897781042d09509

Output schema

{
  "anyOf": [
    {
      "additionalProperties": false,
      "properties": {
        "file_name": {
          "type": "string"
        },
        "mime_type": {
          "const": "image/png"
        },
        "observation_schema_version": {
          "const": "1.0"
        },
        "observation_sha256": {
          "pattern": "^[a-f0-9]{64}$",
          "type": "string"
        },
        "page": {
          "type": "integer"
        },
        "page_geometry": {
          "additionalProperties": false,
          "properties": {
            "coordinate_space": {
              "const": "pdf_user_space_bottom_left_points"
            },
            "crop_box": {
              "items": {
                "type": "number"
              },
              "maxItems": 4,
              "minItems": 4,
              "type": "array"
            },
            "geometry_source": {
              "enum": [
                "pdf-lib",
                "pdfjs-view-fallback"
              ],
              "type": "string"
            },
            "height_points": {
              "type": "number"
            },
            "media_box": {
              "anyOf": [
                {
                  "items": {
                    "type": "number"
                  },
                  "maxItems": 4,
                  "minItems": 4,
                  "type": "array"
                },
                {
                  "type": "null"
                }
              ]
            },
            "rotation": {
              "type": "number"
            },
            "user_unit": {
              "type": "number"
            },
            "width_points": {
              "type": "number"
            }
          },
          "required": [
            "geometry_source",
            "media_box",
            "crop_box",
            "width_points",
            "height_points",
            "rotation",
            "user_unit",
            "coordinate_space"
          ],
          "type": "object"
        },
        "page_view": {
          "additionalProperties": false,
          "properties": {
            "coordinate_space": {
              "const": "pdfjs_viewport_top_left_points"
            },
            "height_points": {
              "type": "number"
            },
            "rotation": {
              "type": "number"
            },
            "user_unit": {
              "type": "number"
            },
            "view_box": {
              "items": {
                "type": "number"
              },
              "maxItems": 4,
              "minItems": 4,
              "type": "array"
            },
            "width_points": {
              "type": "number"
            }
          },
          "required": [
            "view_box",
            "width_points",
            "height_points",
            "rotation",
            "user_unit",
            "coordinate_space"
          ],
          "type": "object"
        },
        "pdf_path": {
          "type": "string"
        },
        "png_sha256": {
          "pattern": "^[a-f0-9]{64}$",
          "type": "string"
        },
        "raw_pixel_sha256": {
          "anyOf": [
            {
              "pattern": "^[a-f0-9]{64}$",
              "type": "string"
            },
            {
              "type": "null"
            }
          ]
        },
        "raw_pixel_status": {
          "enum": [
            "available",
            "unavailable"
          ],
          "type": "string"
        },
        "region_points": {
          "additionalProperties": false,
          "properties": {
            "height": {
              "type": "number"
            },
            "width": {
              "type": "number"
            },
            "x": {
              "type": "number"
            },
            "y": {
              "type": "number"
            }
          },
          "required": [
            "x",
            "y",
            "width",
            "height"
          ],
          "type": "object"
        },
        "rendered_coordinate_space": {
          "const": "raster_top_left_pixels"
        },
        "rendered_height_px": {
          "type": "integer"
        },
        "rendered_region": {
          "additionalProperties": false,
          "properties": {
            "height": {
              "type": "number"
            },
            "width": {
              "type": "number"
            },
            "x": {
              "type": "number"
            },
            "y": {
              "type": "number"
            }
          },
          "required": [
            "x",
            "y",
            "width",
            "height"
          ],
          "type": "object"
        },
        "rendered_width_px": {
          "type": "integer"
        },
        "renderer": {
          "enum": [
            "native-canvas",
            "macos-sips",
            "macos-quicklook"
          ],
          "type": "string"
        },
        "renderer_policy": {
          "enum": [
            "forced_unavailable",
            "native",
            "native_with_system_fallback",
            "system"
          ],
          "type": "string"
        },
        "requested_coordinate_space": {
          "const": "pdfjs_viewport_top_left_points"
        },
        "requested_region": {
          "additionalProperties": false,
          "properties": {
            "height": {
              "type": "number"
            },
            "width": {
              "type": "number"
            },
            "x": {
              "type": "number"
            },
            "y": {
              "type": "number"
            }
          },
          "required": [
            "x",
            "y",
            "width",
            "height"
          ],
          "type": "object"
        },
        "scale": {
          "type": "number"
        },
        "source": {
          "additionalProperties": false,
          "properties": {
            "canonical_path": {
              "type": "string"
            },
            "file_name": {
              "type": "string"
            },
            "sha256": {
              "pattern": "^[a-f0-9]{64}$",
              "type": "string"
            },
            "size_bytes": {
              "type": "integer"
            }
          },
          "required": [
            "canonical_path",
            "file_name",
            "size_bytes",
            "sha256"
          ],
          "type": "object"
        },
        "total_pages": {
          "type": "integer"
        }
      },
      "required": [
        "pdf_path",
        "file_name",
        "page",
        "total_pages",
        "region_points",
        "rendered_width_px",
        "rendered_height_px",
        "scale",
        "renderer",
        "mime_type",
        "observation_schema_version",
        "source",
        "page_geometry",
        "page_view",
        "requested_coordinate_space",
        "rendered_coordinate_space",
        "requested_region",
        "rendered_region",
        "renderer_policy",
        "png_sha256",
        "raw_pixel_sha256",
        "raw_pixel_status",
        "observation_sha256"
      ],
      "type": "object"
    },
    {
      "additionalProperties": false,
      "properties": {
        "error": {
          "additionalProperties": false,
          "properties": {
            "code": {
              "enum": [
                "internal_validation_error",
                "path_policy_denied",
                "tool_execution_failed"
              ],
              "type": "string"
            },
            "error_schema_version": {
              "const": 1
            }
          },
          "required": [
            "error_schema_version",
            "code"
          ],
          "type": "object"
        },
        "status": {
          "const": "failed"
        }
      },
      "required": [
        "status",
        "error"
      ],
      "type": "object"
    },
    {
      "additionalProperties": false,
      "properties": {
        "error": {
          "additionalProperties": false,
          "properties": {
            "code": {
              "const": "PDF_RESOURCE_LIMIT_EXCEEDED"
            },
            "error_schema_version": {
              "const": 1
            }
          },
          "required": [
            "error_schema_version",
            "code"
          ],
          "type": "object"
        },
        "status": {
          "const": "failed"
        }
      },
      "required": [
        "status",
        "error"
      ],
      "type": "object"
    }
  ],
  "type": "object"
}
sha256:f9aef65e106a2ee9bbb16e2bd2990542bc7919b1f2053df0acedb540551ec0ab

Description hash: sha256:98783f01bb3397979c395d83e660ebf457ee0a58e97d4c454edc1b9d0df27849

Interface hash: sha256:4ea826a3c54ef4c0443ae0530f6d28e6d154ab754879850772dc46f6a225f6f5

Other observed Modelara metadata
{
  "id": "mcp:pdf-tools/render_pdf_region",
  "title": "Render PDF Region",
  "source": {
    "type": "mcp",
    "server": "pdf-tools",
    "operation": "render_pdf_region"
  },
  "declared": {
    "read_only": "true",
    "destructive": "false",
    "idempotent": "true",
    "open_world": "false"
  },
  "safety": {
    "idempotent": "true",
    "retry_safe": "true"
  },
  "metadata": {
    "mcp.annotations": "present"
  },
  "fingerprint": "sha256:430790dc08eb701e1014bd3b8c6c2c55031b1a163e5ef32b2e1409ae9fefa09c"
}
toolread0.12.10.14.0
reorder_pdf_pagespdf-toolkit:tool:reorder_pdf_pages
Observed interface and hashes

Rearrange the pages of a PDF in a new order. All pages must be included exactly once (strict permutation). New outputs commit atomically. Replacing a distinct existing output requires its exact current expected_output_identity. All paths must be absolute paths on the user's local machine.

Input schema

{
  "properties": {
    "expected_output_identity": {
      "additionalProperties": false,
      "description": "Exact current identity returned by get_pdf_identity. Required when replacing a distinct existing output_path, optional for the separately guarded same-document backup workflow, and omitted for a new destination.",
      "properties": {
        "canonical_path": {
          "description": "Exact canonical_path returned by get_pdf_identity for the existing destination.",
          "type": "string"
        },
        "sha256": {
          "description": "Exact SHA-256 returned by get_pdf_identity for the existing destination.",
          "pattern": "^[a-f0-9]{64}$",
          "type": "string"
        },
        "size_bytes": {
          "description": "Exact size_bytes returned by get_pdf_identity for the existing destination.",
          "minimum": 0,
          "type": "integer"
        }
      },
      "required": [
        "canonical_path",
        "size_bytes",
        "sha256"
      ],
      "type": "object"
    },
    "input_path": {
      "description": "Path to the source PDF file",
      "type": "string"
    },
    "output_path": {
      "description": "Path where the reordered PDF will be saved",
      "type": "string"
    },
    "page_order": {
      "description": "Array of 1-based page numbers in desired order, e.g. [3, 1, 2, 4]",
      "items": {
        "type": "number"
      },
      "type": "array"
    },
    "password": {
      "description": "Password for an encrypted PDF. Supply the user or owner password and the document is decrypted in memory, changed, and then saved with exactly the encryption and permissions it already had (encrypted inputs are limited to 16 MiB). The protection is never removed, changed, or added by this tool. Leave it unset for an unencrypted document. If the document's own permissions deny the change being made, the owner password is required, because that is the credential which authorises overriding them.",
      "type": "string"
    }
  },
  "required": [
    "input_path",
    "output_path",
    "page_order"
  ],
  "type": "object"
}
sha256:5b93025e634bb52f2aea5a21bce18ab330dfddcb15909c1e7527be5f343fd2d5

Output schema

{
  "anyOf": [
    {
      "additionalProperties": false,
      "properties": {
        "active_path": {
          "type": "string"
        },
        "backup_path": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ]
        },
        "fieldCount": {
          "type": "integer"
        },
        "fields": {
          "items": {
            "additionalProperties": false,
            "properties": {
              "currentValue": {
                "anyOf": [
                  {
                    "type": "string"
                  },
                  {
                    "type": "boolean"
                  },
                  {
                    "items": {
                      "type": "string"
                    },
                    "type": "array"
                  }
                ]
              },
              "name": {
                "type": "string"
              },
              "options": {
                "items": {
                  "type": "string"
                },
                "type": "array"
              },
              "type": {
                "enum": [
                  "text",
                  "checkbox",
                  "radio",
                  "dropdown",
                  "unknown"
                ],
                "type": "string"
              }
            },
            "required": [
              "name",
              "type",
              "options",
              "currentValue"
            ],
            "type": "object"
          },
          "type": "array"
        },
        "hasFormFields": {
          "type": "boolean"
        },
        "initialPage": {
          "type": "integer"
        },
        "last_mutation_at": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ]
        },
        "last_mutation_tool": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ]
        },
        "page_order": {
          "items": {
            "type": "integer"
          },
          "type": "array"
        },
        "pdfPath": {
          "type": "string"
        },
        "totalBytes": {
          "type": "integer"
        }
      },
      "required": [
        "pdfPath",
        "totalBytes",
        "initialPage",
        "fields",
        "fieldCount",
        "hasFormFields",
        "active_path",
        "backup_path",
        "last_mutation_tool",
        "last_mutation_at",
        "page_order"
      ],
      "type": "object"
    },
    {
      "additionalProperties": false,
      "properties": {
        "error": {
          "additionalProperties": false,
          "properties": {
            "code": {
              "enum": [
                "internal_validation_error",
                "path_policy_denied",
                "tool_execution_failed"
              ],
              "type": "string"
            },
            "error_schema_version": {
              "const": 1
            }
          },
          "required": [
            "error_schema_version",
            "code"
          ],
          "type": "object"
        },
        "status": {
          "const": "failed"
        }
      },
      "required": [
        "status",
        "error"
      ],
      "type": "object"
    },
    {
      "additionalProperties": false,
      "properties": {
        "error": {
          "additionalProperties": false,
          "properties": {
            "code": {
              "const": "PDF_RESOURCE_LIMIT_EXCEEDED"
            },
            "error_schema_version": {
              "const": 1
            }
          },
          "required": [
            "error_schema_version",
            "code"
          ],
          "type": "object"
        },
        "status": {
          "const": "failed"
        }
      },
      "required": [
        "status",
        "error"
      ],
      "type": "object"
    }
  ],
  "type": "object"
}
sha256:c5f1443e19f0e4db79cf6cf465fd23e4c90a22afe524e937b50312bee4ab3ad3

Description hash: sha256:99cf0987c2786f5e823a15ae71ca6cc5f5c5a893bcf4840170829799b6510cb7

Interface hash: sha256:46032adb5c8877dc7572a74fe45faf3c003103d38e0bf7d679a07b5525ae1095

Other observed Modelara metadata
{
  "id": "mcp:pdf-tools/reorder_pdf_pages",
  "title": "Reorder PDF Pages",
  "source": {
    "type": "mcp",
    "server": "pdf-tools",
    "operation": "reorder_pdf_pages"
  },
  "declared": {
    "read_only": "false",
    "destructive": "true",
    "idempotent": "true",
    "open_world": "false"
  },
  "safety": {
    "idempotent": "true",
    "retry_safe": "unknown"
  },
  "metadata": {
    "mcp.annotations": "present"
  },
  "fingerprint": "sha256:3428caf44e7c97b1fb7fa3890c8ca2810d7d71856e84346c11142dc20ed1800d"
}
tooldestructive0.12.1No change observed
reveal_in_finderpdf-toolkit:tool:reveal_in_finder
Observed interface and hashes

Open the OS file manager with the given file selected (macOS: Finder → Reveal; Windows: Explorer → select; Linux: opens the enclosing folder). Used by the viewer to surface the active PDF or its backup so the user can immediately see the relevant file.

Input schema

{
  "properties": {
    "path": {
      "description": "Absolute path to the file to reveal.",
      "type": "string"
    }
  },
  "required": [
    "path"
  ],
  "type": "object"
}
sha256:bba38932fb904c7421672b71a6e7fc7726d63a835fa985c3f4c624aad89e3f78

Output schema

{
  "anyOf": [
    {
      "additionalProperties": false,
      "properties": {
        "path": {
          "type": "string"
        },
        "platform": {
          "enum": [
            "darwin",
            "win32",
            "linux",
            "aix",
            "freebsd",
            "openbsd",
            "sunos",
            "android"
          ],
          "type": "string"
        }
      },
      "required": [
        "path",
        "platform"
      ],
      "type": "object"
    },
    {
      "additionalProperties": false,
      "properties": {
        "error": {
          "additionalProperties": false,
          "properties": {
            "code": {
              "enum": [
                "internal_validation_error",
                "path_policy_denied",
                "tool_execution_failed"
              ],
              "type": "string"
            },
            "error_schema_version": {
              "const": 1
            }
          },
          "required": [
            "error_schema_version",
            "code"
          ],
          "type": "object"
        },
        "status": {
          "const": "failed"
        }
      },
      "required": [
        "status",
        "error"
      ],
      "type": "object"
    }
  ],
  "type": "object"
}
sha256:c2fb7df699fea3fdefbf02ea58c065b11ab6aa32e7ad2f8a0adf5bd3ad5c4297

Description hash: sha256:1117cb7e24a6adc7ffc411bb4b94a0de6c7362fb2cea863139fafa46dddc082d

Interface hash: sha256:4023fded2b28c6bd337f971463c56d14018e551c3b95d3bd14e39ad41066ce5e

Other observed Modelara metadata
{
  "id": "mcp:pdf-tools/reveal_in_finder",
  "title": "Reveal File in Finder",
  "source": {
    "type": "mcp",
    "server": "pdf-tools",
    "operation": "reveal_in_finder"
  },
  "declared": {
    "read_only": "false",
    "destructive": "false",
    "idempotent": "false",
    "open_world": "false"
  },
  "safety": {
    "idempotent": "false",
    "retry_safe": "false"
  },
  "metadata": {
    "mcp.annotations": "present"
  },
  "fingerprint": "sha256:aeaa46f00ca1f46f3cb45e42c368ea6f267e33ca2cad5420c163ade996cec06c"
}
toolwrite0.12.1No change observed
rotate_pdf_pagespdf-toolkit:tool:rotate_pdf_pages
Observed interface and hashes

Rotate pages in a PDF by 90, 180, or 270 degrees. New outputs commit atomically. Replacing a distinct existing output requires its exact current expected_output_identity. All paths must be absolute paths on the user's local machine.

Input schema

{
  "properties": {
    "degrees": {
      "description": "Rotation angle: 90, 180, or 270",
      "type": "number"
    },
    "expected_output_identity": {
      "additionalProperties": false,
      "description": "Exact current identity returned by get_pdf_identity. Required when replacing a distinct existing output_path, optional for the separately guarded same-document backup workflow, and omitted for a new destination.",
      "properties": {
        "canonical_path": {
          "description": "Exact canonical_path returned by get_pdf_identity for the existing destination.",
          "type": "string"
        },
        "sha256": {
          "description": "Exact SHA-256 returned by get_pdf_identity for the existing destination.",
          "pattern": "^[a-f0-9]{64}$",
          "type": "string"
        },
        "size_bytes": {
          "description": "Exact size_bytes returned by get_pdf_identity for the existing destination.",
          "minimum": 0,
          "type": "integer"
        }
      },
      "required": [
        "canonical_path",
        "size_bytes",
        "sha256"
      ],
      "type": "object"
    },
    "input_path": {
      "description": "Path to the source PDF file",
      "type": "string"
    },
    "output_path": {
      "description": "Path where the rotated PDF will be saved",
      "type": "string"
    },
    "pages": {
      "description": "Array of 1-based page numbers to rotate (omit or empty array for all pages)",
      "items": {
        "type": "number"
      },
      "type": "array"
    },
    "password": {
      "description": "Password for an encrypted PDF. Supply the user or owner password and the document is decrypted in memory, changed, and then saved with exactly the encryption and permissions it already had (encrypted inputs are limited to 16 MiB). The protection is never removed, changed, or added by this tool. Leave it unset for an unencrypted document. If the document's own permissions deny the change being made, the owner password is required, because that is the credential which authorises overriding them.",
      "type": "string"
    }
  },
  "required": [
    "input_path",
    "output_path",
    "degrees"
  ],
  "type": "object"
}
sha256:8075137ff977fc37846550bb072791da5b1e206095a244bbb2cd41242838dddf

Output schema

{
  "anyOf": [
    {
      "additionalProperties": false,
      "properties": {
        "active_path": {
          "type": "string"
        },
        "backup_path": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ]
        },
        "degrees": {
          "enum": [
            90,
            180,
            270
          ],
          "type": "number"
        },
        "fieldCount": {
          "type": "integer"
        },
        "fields": {
          "items": {
            "additionalProperties": false,
            "properties": {
              "currentValue": {
                "anyOf": [
                  {
                    "type": "string"
                  },
                  {
                    "type": "boolean"
                  },
                  {
                    "items": {
                      "type": "string"
                    },
                    "type": "array"
                  }
                ]
              },
              "name": {
                "type": "string"
              },
              "options": {
                "items": {
                  "type": "string"
                },
                "type": "array"
              },
              "type": {
                "enum": [
                  "text",
                  "checkbox",
                  "radio",
                  "dropdown",
                  "unknown"
                ],
                "type": "string"
              }
            },
            "required": [
              "name",
              "type",
              "options",
              "currentValue"
            ],
            "type": "object"
          },
          "type": "array"
        },
        "hasFormFields": {
          "type": "boolean"
        },
        "initialPage": {
          "type": "integer"
        },
        "last_mutation_at": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ]
        },
        "last_mutation_tool": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ]
        },
        "pdfPath": {
          "type": "string"
        },
        "rotated_pages": {
          "type": "integer"
        },
        "totalBytes": {
          "type": "integer"
        }
      },
      "required": [
        "pdfPath",
        "totalBytes",
        "initialPage",
        "fields",
        "fieldCount",
        "hasFormFields",
        "active_path",
        "backup_path",
        "last_mutation_tool",
        "last_mutation_at",
        "rotated_pages",
        "degrees"
      ],
      "type": "object"
    },
    {
      "additionalProperties": false,
      "properties": {
        "error": {
          "additionalProperties": false,
          "properties": {
            "code": {
              "enum": [
                "internal_validation_error",
                "path_policy_denied",
                "tool_execution_failed"
              ],
              "type": "string"
            },
            "error_schema_version": {
              "const": 1
            }
          },
          "required": [
            "error_schema_version",
            "code"
          ],
          "type": "object"
        },
        "status": {
          "const": "failed"
        }
      },
      "required": [
        "status",
        "error"
      ],
      "type": "object"
    },
    {
      "additionalProperties": false,
      "properties": {
        "error": {
          "additionalProperties": false,
          "properties": {
            "code": {
              "const": "PDF_RESOURCE_LIMIT_EXCEEDED"
            },
            "error_schema_version": {
              "const": 1
            }
          },
          "required": [
            "error_schema_version",
            "code"
          ],
          "type": "object"
        },
        "status": {
          "const": "failed"
        }
      },
      "required": [
        "status",
        "error"
      ],
      "type": "object"
    }
  ],
  "type": "object"
}
sha256:f43c91e25110e4276dbbc7eebd80222e213596e2761f030c62b6a13b7f70f1db

Description hash: sha256:77917f6bad0d9ee5d0b83c6b918ba9802aca780a0a5007bc0d75c40c3b0efdab

Interface hash: sha256:49568d81e09c5226a5573965431a49164587d2972f8553f4bae40cd4f5230ae7

Other observed Modelara metadata
{
  "id": "mcp:pdf-tools/rotate_pdf_pages",
  "title": "Rotate PDF Pages",
  "source": {
    "type": "mcp",
    "server": "pdf-tools",
    "operation": "rotate_pdf_pages"
  },
  "declared": {
    "read_only": "false",
    "destructive": "true",
    "idempotent": "true",
    "open_world": "false"
  },
  "safety": {
    "idempotent": "true",
    "retry_safe": "unknown"
  },
  "metadata": {
    "mcp.annotations": "present"
  },
  "fingerprint": "sha256:10e6acc7c0d17a715412b13108251a0136bcbd0d441414bd4531d751b089266f"
}
tooldestructive0.12.1No change observed
save_profilepdf-toolkit:tool:save_profile
Observed interface and hashes

Save form data as a reusable profile

Input schema

{
  "properties": {
    "field_data": {
      "description": "Object with field names and values to save",
      "type": "object"
    },
    "profile_name": {
      "description": "Name for the profile (e.g., 'work', 'personal')",
      "type": "string"
    }
  },
  "required": [
    "profile_name",
    "field_data"
  ],
  "type": "object"
}
sha256:455dcc6f5f11be0d3ba0b4ef258759246ea40993c435d588b8b97f43c351825a

Output schema

Not exposed in the analyzed interface.

sha256:398b676e47d03a29016ee92fe378b8b4f1b3e965390c4c64ce78d27f79df74d1

Description hash: sha256:301440323fb6ce3fbc157042c804e5d4bab036de253e7c5720c21f500a9c76a0

Interface hash: sha256:3828e275277b5cfe2b8b64c6f4a29766286bca7e0e0b2d8d5038328af6f406a8

Other observed Modelara metadata
{
  "id": "mcp:pdf-tools/save_profile",
  "title": "Save Form Profile",
  "source": {
    "type": "mcp",
    "server": "pdf-tools",
    "operation": "save_profile"
  },
  "declared": {
    "read_only": "false",
    "destructive": "true",
    "idempotent": "true",
    "open_world": "false"
  },
  "safety": {
    "idempotent": "true",
    "retry_safe": "unknown"
  },
  "metadata": {
    "mcp.annotations": "present"
  },
  "fingerprint": "sha256:202241162f01652ab037dbc6a9f9559d663cea3bfe397ef2c68eff402155a3c3"
}
tooldestructive0.12.1No change observed
search_pdf_textpdf-toolkit:tool:search_pdf_text
Observed interface and hashes

Search extracted PDF text for a literal phrase and return page-numbered snippets. Use this when you need to find mentions of a clause, person, amount, or keyword before deciding which pages to inspect more deeply. All paths must be absolute paths on the user's local machine, NOT Claude container paths (/mnt/...).

Input schema

{
  "examples": [
    {
      "max_results": 5,
      "pdf_path": "/Users/alice/Documents/master-services-agreement.pdf",
      "query": "indemnification"
    }
  ],
  "properties": {
    "context_chars": {
      "description": "Approximate number of surrounding characters to include around each match (default: 160).",
      "type": "number"
    },
    "max_results": {
      "description": "Maximum number of matching snippets to return (default: 10).",
      "type": "number"
    },
    "pdf_path": {
      "description": "Absolute path to the PDF file.",
      "type": "string"
    },
    "query": {
      "description": "Literal text to search for, such as \"indemnification\" or \"governing law\".",
      "type": "string"
    }
  },
  "required": [
    "pdf_path",
    "query"
  ],
  "type": "object"
}
sha256:d77200f98690d9545c25a4dc4b301a02ddafea95339e53c2de787af41b7651a6

Output schema

{
  "anyOf": [
    {
      "additionalProperties": false,
      "properties": {
        "file_name": {
          "type": "string"
        },
        "match_count": {
          "type": "integer"
        },
        "matches": {
          "items": {
            "additionalProperties": false,
            "properties": {
              "char_index": {
                "type": "integer"
              },
              "match_text": {
                "type": "string"
              },
              "page": {
                "type": "integer"
              },
              "snippet": {
                "type": "string"
              }
            },
            "required": [
              "page",
              "char_index",
              "match_text",
              "snippet"
            ],
            "type": "object"
          },
          "type": "array"
        },
        "pdf_path": {
          "type": "string"
        },
        "query": {
          "type": "string"
        },
        "total_pages": {
          "type": "integer"
        },
        "truncated": {
          "type": "boolean"
        }
      },
      "required": [
        "pdf_path",
        "file_name",
        "total_pages",
        "query",
        "match_count",
        "truncated",
        "matches"
      ],
      "type": "object"
    },
    {
      "additionalProperties": false,
      "properties": {
        "error": {
          "additionalProperties": false,
          "properties": {
            "code": {
              "enum": [
                "internal_validation_error",
                "path_policy_denied",
                "tool_execution_failed"
              ],
              "type": "string"
            },
            "error_schema_version": {
              "const": 1
            }
          },
          "required": [
            "error_schema_version",
            "code"
          ],
          "type": "object"
        },
        "status": {
          "const": "failed"
        }
      },
      "required": [
        "status",
        "error"
      ],
      "type": "object"
    },
    {
      "additionalProperties": false,
      "properties": {
        "error": {
          "additionalProperties": false,
          "properties": {
            "code": {
              "const": "PDF_RESOURCE_LIMIT_EXCEEDED"
            },
            "error_schema_version": {
              "const": 1
            }
          },
          "required": [
            "error_schema_version",
            "code"
          ],
          "type": "object"
        },
        "status": {
          "const": "failed"
        }
      },
      "required": [
        "status",
        "error"
      ],
      "type": "object"
    }
  ],
  "type": "object"
}
sha256:dbc9965f518d90683cc573fbba37088c0466763c4445acb547e3437229f132c0

Description hash: sha256:8953faf1a979f2753254317e40dac27be07036f833238f05c473d4771ada95d6

Interface hash: sha256:c2f7c4cd883e03ba2dcb152c14f67477e276ec679cba947a2114fa15dd028ce6

Other observed Modelara metadata
{
  "id": "mcp:pdf-tools/search_pdf_text",
  "title": "Search PDF Text",
  "source": {
    "type": "mcp",
    "server": "pdf-tools",
    "operation": "search_pdf_text"
  },
  "declared": {
    "read_only": "true",
    "destructive": "false",
    "idempotent": "true",
    "open_world": "false"
  },
  "safety": {
    "idempotent": "true",
    "retry_safe": "true"
  },
  "metadata": {
    "mcp.annotations": "present"
  },
  "fingerprint": "sha256:83f11f04d4ae1dde0cedf1320df088b410cc8fc137d2249a166e7748dbd3e4a1"
}
toolread0.12.1No change observed
send_lumin_requestpdf-toolkit:tool:send_lumin_request
Observed interface and hashes

NEVER FABRICATE confirmation_statement OR user_confirmed_at. Ask the user to confirm the exact disclosure returned by prepare_lumin_request, then pass their exact confirmation text and timestamp. This makes one nonretryable provider request that uploads the prepared PDF to Lumin and emails the listed signers. An ambiguous outcome remains consumed and is never automatically retried.

Input schema

{
  "additionalProperties": false,
  "properties": {
    "authorization_session_id": {
      "description": "Connected session ID returned by finish_lumin_authorization.",
      "type": "string"
    },
    "confirmation_sha256": {
      "description": "Exact confirmation digest returned by prepare_lumin_request.",
      "pattern": "^[a-f0-9]{64}$",
      "type": "string"
    },
    "confirmation_statement": {
      "description": "The user's verbatim confirmation_statement_required value. Never invent or paraphrase it.",
      "type": "string"
    },
    "request_preparation_id": {
      "description": "Opaque preparation ID returned by prepare_lumin_request.",
      "type": "string"
    },
    "user_confirmed_at": {
      "description": "When the user personally confirmed, within the last 10 minutes.",
      "format": "date-time",
      "type": "string"
    }
  },
  "required": [
    "request_preparation_id",
    "authorization_session_id",
    "confirmation_sha256",
    "confirmation_statement",
    "user_confirmed_at"
  ],
  "type": "object"
}
sha256:ebde6c4a6906a01b856f4a3420ac818f02be6ea4041ab52607f302322a20c0cc

Output schema

{
  "anyOf": [
    {
      "additionalProperties": false,
      "properties": {
        "access_token_persisted": {
          "const": false
        },
        "attempt_count": {
          "const": 1
        },
        "authority_sha256": {
          "pattern": "^[a-f0-9]{64}$",
          "type": "string"
        },
        "automatic_retry_performed": {
          "const": false
        },
        "create_retry_allowed": {
          "const": false
        },
        "created_at": {
          "type": "integer"
        },
        "operation_status": {
          "const": "request_created"
        },
        "provider": {
          "const": "lumin_sign"
        },
        "provider_status": {
          "type": "string"
        },
        "signature_request_id": {
          "type": "string"
        },
        "status": {
          "const": "request_created"
        }
      },
      "required": [
        "status",
        "provider",
        "authority_sha256",
        "operation_status",
        "signature_request_id",
        "provider_status",
        "created_at",
        "attempt_count",
        "automatic_retry_performed",
        "create_retry_allowed",
        "access_token_persisted"
      ],
      "type": "object"
    },
    {
      "additionalProperties": false,
      "properties": {
        "error": {
          "additionalProperties": false,
          "properties": {
            "code": {
              "enum": [
                "internal_validation_error",
                "path_policy_denied",
                "tool_execution_failed"
              ],
              "type": "string"
            },
            "error_schema_version": {
              "const": 1
            }
          },
          "required": [
            "error_schema_version",
            "code"
          ],
          "type": "object"
        },
        "status": {
          "const": "failed"
        }
      },
      "required": [
        "status",
        "error"
      ],
      "type": "object"
    },
    {
      "additionalProperties": false,
      "properties": {
        "error": {
          "additionalProperties": false,
          "properties": {
            "code": {
              "pattern": "^LUMIN_[A-Z0-9_]+$",
              "type": "string"
            },
            "error_schema_version": {
              "const": 1
            }
          },
          "required": [
            "error_schema_version",
            "code"
          ],
          "type": "object"
        },
        "status": {
          "const": "failed"
        }
      },
      "required": [
        "status",
        "error"
      ],
      "type": "object"
    }
  ],
  "type": "object"
}
sha256:2c80b39894de82b4256b6d9a756fe710ac1fa42c8881692104c8c1654e12f972

Description hash: sha256:875628b48373576af598b2512743ada6cb0c7d0ff0ff01a2513455366ca719f0

Interface hash: sha256:962c2894a5fd5d4fde32061dde767c4d59f73d594d24c2b111e560c378a60266

Other observed Modelara metadata
{
  "id": "mcp:pdf-tools/send_lumin_request",
  "title": "Send Lumin Signing Request",
  "source": {
    "type": "mcp",
    "server": "pdf-tools",
    "operation": "send_lumin_request"
  },
  "declared": {
    "read_only": "false",
    "destructive": "true",
    "idempotent": "false",
    "open_world": "true"
  },
  "safety": {
    "idempotent": "false",
    "retry_safe": "false"
  },
  "metadata": {
    "mcp.annotations": "present"
  },
  "fingerprint": "sha256:1fff1e7a9edb64b57dcd580e177f37cad8814a98dcbda1789d5ceeeadbebe4a4"
}
tooldestructive0.14.00.14.0
set_active_documentpdf-toolkit:tool:set_active_document
Observed interface and hashes

Set or rehydrate the toolkit's active document state from a viewer session. Intended for the viewer to resync the canonical active_path and optional backup_path after MCP/server restarts.

Input schema

{
  "properties": {
    "backup_path": {
      "description": "Optional backup path previously created for this document.",
      "type": "string"
    },
    "last_mutation_at": {
      "description": "Optional ISO-8601 timestamp of the last mutation.",
      "type": "string"
    },
    "last_mutation_tool": {
      "description": "Optional last mutation tool name to preserve across rehydration.",
      "type": "string"
    },
    "pdf_path": {
      "description": "Canonical active PDF path currently shown in the viewer.",
      "type": "string"
    }
  },
  "required": [
    "pdf_path"
  ],
  "type": "object"
}
sha256:84392d8b1ffb20305f9a9d39e71a4c785f338841d0be72f0542ef7da900127af

Output schema

{
  "anyOf": [
    {
      "additionalProperties": false,
      "properties": {
        "active_path": {
          "type": "string"
        },
        "backup_path": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ]
        },
        "fieldCount": {
          "type": "integer"
        },
        "fields": {
          "items": {
            "additionalProperties": false,
            "properties": {
              "currentValue": {
                "anyOf": [
                  {
                    "type": "string"
                  },
                  {
                    "type": "boolean"
                  },
                  {
                    "items": {
                      "type": "string"
                    },
                    "type": "array"
                  }
                ]
              },
              "name": {
                "type": "string"
              },
              "options": {
                "items": {
                  "type": "string"
                },
                "type": "array"
              },
              "type": {
                "enum": [
                  "text",
                  "checkbox",
                  "radio",
                  "dropdown",
                  "unknown"
                ],
                "type": "string"
              }
            },
            "required": [
              "name",
              "type",
              "options",
              "currentValue"
            ],
            "type": "object"
          },
          "type": "array"
        },
        "hasFormFields": {
          "type": "boolean"
        },
        "initialPage": {
          "type": "integer"
        },
        "last_mutation_at": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ]
        },
        "last_mutation_tool": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ]
        },
        "pdfPath": {
          "type": "string"
        },
        "totalBytes": {
          "type": "integer"
        }
      },
      "required": [
        "pdfPath",
        "totalBytes",
        "initialPage",
        "fields",
        "fieldCount",
        "hasFormFields",
        "active_path",
        "backup_path",
        "last_mutation_tool",
        "last_mutation_at"
      ],
      "type": "object"
    },
    {
      "additionalProperties": false,
      "properties": {
        "error": {
          "additionalProperties": false,
          "properties": {
            "code": {
              "enum": [
                "internal_validation_error",
                "path_policy_denied",
                "tool_execution_failed"
              ],
              "type": "string"
            },
            "error_schema_version": {
              "const": 1
            }
          },
          "required": [
            "error_schema_version",
            "code"
          ],
          "type": "object"
        },
        "status": {
          "const": "failed"
        }
      },
      "required": [
        "status",
        "error"
      ],
      "type": "object"
    }
  ],
  "type": "object"
}
sha256:8228bb9d4087430cab91d0d0d44e3dcd935f4aba97580ee9cf3d99c339c9e135

Description hash: sha256:e3933d589a4dafeeb1dff9d39ef48adbb4f31fff0c127b6e4abd583105b3924b

Interface hash: sha256:7f71f0338eab81c0aa7e6fa2dee7b50cca1f3adc644e2b915f8b96fff5e7a7f0

Other observed Modelara metadata
{
  "id": "mcp:pdf-tools/set_active_document",
  "title": "Set Active Document",
  "source": {
    "type": "mcp",
    "server": "pdf-tools",
    "operation": "set_active_document"
  },
  "declared": {
    "read_only": "false",
    "destructive": "false",
    "idempotent": "false",
    "open_world": "false"
  },
  "safety": {
    "idempotent": "false",
    "retry_safe": "false"
  },
  "metadata": {
    "mcp.annotations": "present"
  },
  "fingerprint": "sha256:aeaade8f63cea68cce3145e06ed4628cfe38011bb7f1f4089f8e03c9e102d69f"
}
toolwrite0.12.1No change observed
split_pdfpdf-toolkit:tool:split_pdf
Observed interface and hashes

Split a PDF into multiple files by page ranges (e.g. '1-5,6-10') or at regular intervals (e.g. 'every 5'). New outputs need no identity; every existing destination requires one exact entry in expected_output_identities. Any identity or output failure aborts the whole split set. All paths must be absolute paths on the user's local machine.

Input schema

{
  "properties": {
    "expected_output_identities": {
      "description": "Exact identities for generated batch destinations that already exist. Omit new destinations. Any stale, duplicate, unrelated, or missing entry aborts the whole batch.",
      "items": {
        "additionalProperties": false,
        "properties": {
          "canonical_path": {
            "description": "Exact canonical_path returned by get_pdf_identity for the existing destination.",
            "type": "string"
          },
          "output_path": {
            "description": "Computed absolute output path this identity authorizes replacing.",
            "type": "string"
          },
          "sha256": {
            "description": "Exact SHA-256 returned by get_pdf_identity for the existing destination.",
            "pattern": "^[a-f0-9]{64}$",
            "type": "string"
          },
          "size_bytes": {
            "description": "Exact size_bytes returned by get_pdf_identity for the existing destination.",
            "minimum": 0,
            "type": "integer"
          }
        },
        "required": [
          "output_path",
          "canonical_path",
          "size_bytes",
          "sha256"
        ],
        "type": "object"
      },
      "maxItems": 1000,
      "type": "array"
    },
    "input_path": {
      "description": "Path to the PDF file to split",
      "type": "string"
    },
    "output_directory": {
      "description": "Directory where split PDFs will be saved",
      "type": "string"
    },
    "page_ranges": {
      "description": "Page ranges: '1-5,6-10,11-15' or 'every 5' for uniform splits",
      "type": "string"
    },
    "password": {
      "description": "Password for an encrypted PDF. Supply the user or owner password and the document is decrypted in memory, changed, and then saved with exactly the encryption and permissions it already had (encrypted inputs are limited to 16 MiB). The protection is never removed, changed, or added by this tool. Leave it unset for an unencrypted document. If the document's own permissions deny the change being made, the owner password is required, because that is the credential which authorises overriding them.",
      "type": "string"
    }
  },
  "required": [
    "input_path",
    "page_ranges",
    "output_directory"
  ],
  "type": "object"
}
sha256:d1ac07b18e01df4890243cb31db8b0037f4951fda63367eb2de3dfaf04f346b9

Output schema

{
  "anyOf": [
    {
      "additionalProperties": false,
      "properties": {
        "file_count": {
          "type": "integer"
        },
        "files": {
          "items": {
            "additionalProperties": false,
            "properties": {
              "end_page": {
                "type": "integer"
              },
              "filename": {
                "type": "string"
              },
              "output_path": {
                "type": "string"
              },
              "page_count": {
                "type": "integer"
              },
              "start_page": {
                "type": "integer"
              }
            },
            "required": [
              "filename",
              "output_path",
              "start_page",
              "end_page",
              "page_count"
            ],
            "type": "object"
          },
          "type": "array"
        },
        "input_path": {
          "type": "string"
        },
        "output_directory": {
          "type": "string"
        }
      },
      "required": [
        "input_path",
        "output_directory",
        "file_count",
        "files"
      ],
      "type": "object"
    },
    {
      "additionalProperties": false,
      "properties": {
        "error": {
          "additionalProperties": false,
          "properties": {
            "code": {
              "enum": [
                "internal_validation_error",
                "path_policy_denied",
                "tool_execution_failed"
              ],
              "type": "string"
            },
            "error_schema_version": {
              "const": 1
            }
          },
          "required": [
            "error_schema_version",
            "code"
          ],
          "type": "object"
        },
        "status": {
          "const": "failed"
        }
      },
      "required": [
        "status",
        "error"
      ],
      "type": "object"
    },
    {
      "additionalProperties": false,
      "properties": {
        "error": {
          "additionalProperties": false,
          "properties": {
            "code": {
              "const": "PDF_RESOURCE_LIMIT_EXCEEDED"
            },
            "error_schema_version": {
              "const": 1
            }
          },
          "required": [
            "error_schema_version",
            "code"
          ],
          "type": "object"
        },
        "status": {
          "const": "failed"
        }
      },
      "required": [
        "status",
        "error"
      ],
      "type": "object"
    }
  ],
  "type": "object"
}
sha256:de77ee57fcd11a8b05466a4813176efc7eed0e752421b025a41dbe8d6743c1df

Description hash: sha256:4a44a648b537e83927e6a287f91868df5fadd262a7cc7c7321746c4c9b5ac147

Interface hash: sha256:acb460d6cb515285987790a0c21ed73b2b501188d0c666c106638742e4feb161

Other observed Modelara metadata
{
  "id": "mcp:pdf-tools/split_pdf",
  "title": "Split PDF",
  "source": {
    "type": "mcp",
    "server": "pdf-tools",
    "operation": "split_pdf"
  },
  "declared": {
    "read_only": "false",
    "destructive": "true",
    "idempotent": "true",
    "open_world": "false"
  },
  "safety": {
    "idempotent": "true",
    "retry_safe": "unknown"
  },
  "metadata": {
    "mcp.annotations": "present"
  },
  "fingerprint": "sha256:212be0e0582b234d383f32e15a98b9a292de77895b543c30c20c1ca6385da86b"
}
tooldestructive0.12.1No change observed
start_lumin_authorizationpdf-toolkit:tool:start_lumin_authorization
Observed interface and hashes

Connect a Lumin account through secure browser login using OAuth PKCE. Follow the returned next_step instructions. Account creation and passwords belong on Lumin's website, never in tool arguments or chat. If this installation is not configured, ask its maintainer to enable the integration rather than asking the user to create a developer app. This does not send a PDF or create a signing request. Call finish_lumin_authorization after the user finishes in the browser.

Input schema

{
  "additionalProperties": false,
  "properties": {},
  "type": "object"
}
sha256:fc182e1a69a66dadc6c6ee98df9606d1d4fd90fb51b082083aaa8c230cb4765c

Output schema

{
  "anyOf": [
    {
      "additionalProperties": false,
      "properties": {
        "authorization_session_id": {
          "type": "string"
        },
        "browser_opened": {
          "const": true
        },
        "callback_expires_at": {
          "type": "string"
        },
        "next_step": {
          "type": "string"
        },
        "pdf_sent": {
          "const": false
        },
        "provider": {
          "const": "lumin_sign"
        },
        "status": {
          "const": "awaiting_user_authorization"
        }
      },
      "required": [
        "status",
        "next_step",
        "provider",
        "authorization_session_id",
        "callback_expires_at",
        "browser_opened",
        "pdf_sent"
      ],
      "type": "object"
    },
    {
      "additionalProperties": false,
      "properties": {
        "error": {
          "additionalProperties": false,
          "properties": {
            "code": {
              "enum": [
                "internal_validation_error",
                "path_policy_denied",
                "tool_execution_failed"
              ],
              "type": "string"
            },
            "error_schema_version": {
              "const": 1
            }
          },
          "required": [
            "error_schema_version",
            "code"
          ],
          "type": "object"
        },
        "status": {
          "const": "failed"
        }
      },
      "required": [
        "status",
        "error"
      ],
      "type": "object"
    },
    {
      "additionalProperties": false,
      "properties": {
        "error": {
          "additionalProperties": false,
          "properties": {
            "code": {
              "pattern": "^LUMIN_[A-Z0-9_]+$",
              "type": "string"
            },
            "error_schema_version": {
              "const": 1
            }
          },
          "required": [
            "error_schema_version",
            "code"
          ],
          "type": "object"
        },
        "status": {
          "const": "failed"
        }
      },
      "required": [
        "status",
        "error"
      ],
      "type": "object"
    }
  ],
  "type": "object"
}
sha256:fda6958e570fb69ff10d9407fa0872463745ffb86ded58729a5757581b9798dd

Description hash: sha256:68c325348ecf8c83f16f6d9ea09a664930d2b316f0b40975281d37d9c125e947

Interface hash: sha256:baacc9d0a2921d8c26fef860604550fbcb57417d83bcb11ac9c7f435cf6027d2

Other observed Modelara metadata
{
  "id": "mcp:pdf-tools/start_lumin_authorization",
  "title": "Connect Lumin Account",
  "source": {
    "type": "mcp",
    "server": "pdf-tools",
    "operation": "start_lumin_authorization"
  },
  "declared": {
    "read_only": "false",
    "destructive": "false",
    "idempotent": "false",
    "open_world": "true"
  },
  "safety": {
    "idempotent": "false",
    "retry_safe": "false"
  },
  "metadata": {
    "mcp.annotations": "present"
  },
  "fingerprint": "sha256:4234e44347f32f2f21af9a0c2aa3a896dea3f90637d5aaf99d1c164c93e1402a"
}
toolwrite0.14.00.14.0
submit_extraction_proposalpdf-toolkit:tool:submit_extraction_proposal
Observed interface and hashes

Append one explicitly unverified value proposal for a pending schema leaf, bound to one or more returned chunk IDs. This does not promote or trust the value.

Input schema

{
  "additionalProperties": false,
  "properties": {
    "chunk_ids": {
      "items": {
        "pattern": "^chunk\\.[a-f0-9]{64}$",
        "type": "string"
      },
      "maxItems": 32,
      "minItems": 1,
      "type": "array"
    },
    "leaf_pointer": {
      "type": "string"
    },
    "parent_generation_sha256": {
      "pattern": "^[a-f0-9]{64}$",
      "type": "string"
    },
    "proposed_value": {},
    "workspace_id": {
      "type": "string"
    },
    "workspace_identity_sha256": {
      "pattern": "^[a-f0-9]{64}$",
      "type": "string"
    }
  },
  "required": [
    "workspace_id",
    "workspace_identity_sha256",
    "parent_generation_sha256",
    "leaf_pointer",
    "proposed_value",
    "chunk_ids"
  ],
  "type": "object"
}
sha256:f79434ea5212465626a8824519b07f8905c069afae4f1947f11090035e1d5073

Output schema

{
  "anyOf": [
    {
      "additionalProperties": false,
      "properties": {
        "event": {
          "additionalProperties": false,
          "properties": {
            "chunk_ids": {
              "items": {
                "pattern": "^chunk\\.[a-f0-9]{64}$",
                "type": "string"
              },
              "type": "array"
            },
            "contract": {
              "additionalProperties": false,
              "properties": {
                "name": {
                  "const": "pdf-tools.verified-extraction-workspace-event"
                },
                "version": {
                  "const": "1.1.0-experimental"
                }
              },
              "required": [
                "name",
                "version"
              ],
              "type": "object"
            },
            "event_id": {
              "pattern": "^event\\.[a-f0-9]{64}$",
              "type": "string"
            },
            "event_sequence": {
              "minimum": 1,
              "type": "integer"
            },
            "kind": {
              "const": "proposal_submitted"
            },
            "leaf_pointer": {
              "type": "string"
            },
            "proposed_value": {},
            "verification": {
              "additionalProperties": false,
              "properties": {
                "reason": {
                  "const": "not_replayed"
                },
                "status": {
                  "const": "unverified"
                }
              },
              "required": [
                "status",
                "reason"
              ],
              "type": "object"
            },
            "workspace_identity_sha256": {
              "pattern": "^[a-f0-9]{64}$",
              "type": "string"
            }
          },
          "required": [
            "contract",
            "event_sequence",
            "kind",
            "workspace_identity_sha256",
            "leaf_pointer",
            "proposed_value",
            "chunk_ids",
            "verification",
            "event_id"
          ],
          "type": "object"
        },
        "generation_sequence": {
          "minimum": 0,
          "type": "integer"
        },
        "generation_sha256": {
          "pattern": "^[a-f0-9]{64}$",
          "type": "string"
        },
        "state": {
          "const": "complete"
        },
        "workspace_identity_sha256": {
          "pattern": "^[a-f0-9]{64}$",
          "type": "string"
        }
      },
      "required": [
        "workspace_identity_sha256",
        "generation_sha256",
        "generation_sequence",
        "event",
        "state"
      ],
      "type": "object"
    },
    {
      "additionalProperties": false,
      "properties": {
        "error": {
          "additionalProperties": false,
          "properties": {
            "code": {
              "enum": [
                "internal_validation_error",
                "path_policy_denied",
                "tool_execution_failed"
              ],
              "type": "string"
            },
            "error_schema_version": {
              "const": 1
            }
          },
          "required": [
            "error_schema_version",
            "code"
          ],
          "type": "object"
        },
        "status": {
          "const": "failed"
        }
      },
      "required": [
        "status",
        "error"
      ],
      "type": "object"
    }
  ],
  "type": "object"
}
sha256:6526e5a29d77fbe17fe3af784d5829fa5e23027ff3a1bc346b29818a935a19c3

Description hash: sha256:f725227c981be284e50f45d5907f79f4df2506124ed4614a2bf83f5e5ca826d2

Interface hash: sha256:5e7b921f4e632141a810951b04c733510ac45fc29ea8b9a2eae44f44988d5b99

Other observed Modelara metadata
{
  "id": "mcp:pdf-tools/submit_extraction_proposal",
  "title": "Submit Extraction Proposal",
  "source": {
    "type": "mcp",
    "server": "pdf-tools",
    "operation": "submit_extraction_proposal"
  },
  "declared": {
    "read_only": "false",
    "destructive": "false",
    "idempotent": "false",
    "open_world": "false"
  },
  "safety": {
    "idempotent": "false",
    "retry_safe": "false"
  },
  "metadata": {
    "mcp.annotations": "present"
  },
  "fingerprint": "sha256:dfcd7ba5d47d69ee191939fbfbf4c1d0b856777328973bf37d2c6a28d47d7d4a"
}
toolwrite0.13.00.13.0
validate_pdfpdf-toolkit:tool:validate_pdf
Observed interface and hashes

Inspect AcroForm value coverage and the PDF's actual Required flags without mutating the document. Returns explicit complete, partial, no-fields, and indeterminate states plus a narrow required-field claim boundary; it does not determine legal validity, business-rule validity, signature validity, or readiness to submit.

Input schema

{
  "properties": {
    "password": {
      "description": "Password for an encrypted PDF. Supply the user or owner password and the document is decrypted in memory to complete this read (encrypted inputs are limited to 16 MiB). Leave it unset for an unencrypted document, or for an encrypted one that opens without a password. A document that needs a password cannot be read without it, and this tool never removes or weakens a document's protection.",
      "type": "string"
    },
    "pdf_path": {
      "description": "Absolute path to the fillable PDF on the user's machine.",
      "type": "string"
    }
  },
  "required": [
    "pdf_path"
  ],
  "type": "object"
}
sha256:60cc9762703a476582946a4ab28c634b33272a4f0f65f9fb305b6b53d3e43274

Output schema

{
  "anyOf": [
    {
      "additionalProperties": false,
      "properties": {
        "all_value_fields_filled": {
          "anyOf": [
            {
              "type": "boolean"
            },
            {
              "type": "null"
            }
          ]
        },
        "can_claim_form_ready": {
          "const": false
        },
        "can_claim_required_fields_complete": {
          "type": "boolean"
        },
        "empty_count": {
          "type": "integer"
        },
        "empty_fields": {
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        "error_codes": {
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        "fields": {
          "items": {
            "additionalProperties": false,
            "properties": {
              "error_code": {
                "anyOf": [
                  {
                    "type": "string"
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "kind": {
                "enum": [
                  "text",
                  "checkbox",
                  "radio",
                  "dropdown",
                  "option_list",
                  "signature",
                  "button",
                  "unknown"
                ],
                "type": "string"
              },
              "name": {
                "type": "string"
              },
              "required": {
                "anyOf": [
                  {
                    "type": "boolean"
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "required_name_hint": {
                "type": "boolean"
              },
              "required_status": {
                "enum": [
                  "not_required",
                  "unknown",
                  "satisfied",
                  "missing"
                ],
                "type": "string"
              },
              "type": {
                "type": "string"
              },
              "value_status": {
                "enum": [
                  "observed",
                  "empty",
                  "unchecked",
                  "unknown",
                  "read_error",
                  "not_applicable"
                ],
                "type": "string"
              }
            },
            "required": [
              "name",
              "type",
              "kind",
              "required",
              "required_name_hint",
              "value_status",
              "required_status",
              "error_code"
            ],
            "type": "object"
          },
          "type": "array"
        },
        "file_name": {
          "type": "string"
        },
        "filled_count": {
          "type": "integer"
        },
        "has_form_fields": {
          "type": "boolean"
        },
        "heuristic_required_candidates": {
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        "indeterminate_required_count": {
          "type": "integer"
        },
        "indeterminate_required_fields": {
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        "limitations": {
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        "missing_required_count": {
          "type": "integer"
        },
        "missing_required_fields": {
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        "not_applicable_count": {
          "type": "integer"
        },
        "observed_count": {
          "type": "integer"
        },
        "observed_fields": {
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        "pdf_path": {
          "type": "string"
        },
        "read_error_count": {
          "type": "integer"
        },
        "read_error_fields": {
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        "required_field_count": {
          "type": "integer"
        },
        "required_field_validation_status": {
          "enum": [
            "complete",
            "incomplete",
            "indeterminate",
            "no_fields",
            "no_required_flags"
          ],
          "type": "string"
        },
        "required_fields_complete": {
          "anyOf": [
            {
              "type": "boolean"
            },
            {
              "type": "null"
            }
          ]
        },
        "requiredness_unknown_count": {
          "type": "integer"
        },
        "requiredness_unknown_fields": {
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        "retry_guidance": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ]
        },
        "schema_version": {
          "const": "1.0"
        },
        "total_field_count": {
          "type": "integer"
        },
        "unchecked_count": {
          "type": "integer"
        },
        "unchecked_fields": {
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        "unknown_count": {
          "type": "integer"
        },
        "unknown_fields": {
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        "validation_conclusive": {
          "type": "boolean"
        },
        "validation_status": {
          "enum": [
            "complete",
            "partial",
            "incomplete",
            "indeterminate",
            "no_fields",
            "no_value_fields"
          ],
          "type": "string"
        },
        "value_field_count": {
          "type": "integer"
        },
        "warning_codes": {
          "items": {
            "type": "string"
          },
          "type": "array"
        }
      },
      "required": [
        "schema_version",
        "pdf_path",
        "file_name",
        "validation_status",
        "required_field_validation_status",
        "validation_conclusive",
        "has_form_fields",
        "required_fields_complete",
        "all_value_fields_filled",
        "can_claim_required_fields_complete",
        "can_claim_form_ready",
        "total_field_count",
        "value_field_count",
        "observed_count",
        "filled_count",
        "empty_count",
        "unchecked_count",
        "unknown_count",
        "read_error_count",
        "not_applicable_count",
        "required_field_count",
        "missing_required_count",
        "indeterminate_required_count",
        "requiredness_unknown_count",
        "fields",
        "observed_fields",
        "empty_fields",
        "unchecked_fields",
        "unknown_fields",
        "read_error_fields",
        "missing_required_fields",
        "indeterminate_required_fields",
        "requiredness_unknown_fields",
        "heuristic_required_candidates",
        "error_codes",
        "warning_codes",
        "retry_guidance",
        "limitations"
      ],
      "type": "object"
    },
    {
      "additionalProperties": false,
      "properties": {
        "error": {
          "additionalProperties": false,
          "properties": {
            "code": {
              "enum": [
                "internal_validation_error",
                "path_policy_denied",
                "tool_execution_failed"
              ],
              "type": "string"
            },
            "error_schema_version": {
              "const": 1
            }
          },
          "required": [
            "error_schema_version",
            "code"
          ],
          "type": "object"
        },
        "status": {
          "const": "failed"
        }
      },
      "required": [
        "status",
        "error"
      ],
      "type": "object"
    },
    {
      "additionalProperties": false,
      "properties": {
        "all_value_fields_filled": {
          "anyOf": [
            {
              "type": "boolean"
            },
            {
              "type": "null"
            }
          ]
        },
        "can_claim_form_ready": {
          "const": false
        },
        "can_claim_required_fields_complete": {
          "type": "boolean"
        },
        "empty_count": {
          "type": "null"
        },
        "empty_fields": {
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        "error_codes": {
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        "fields": {
          "items": {
            "additionalProperties": false,
            "properties": {
              "error_code": {
                "anyOf": [
                  {
                    "type": "string"
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "kind": {
                "enum": [
                  "text",
                  "checkbox",
                  "radio",
                  "dropdown",
                  "option_list",
                  "signature",
                  "button",
                  "unknown"
                ],
                "type": "string"
              },
              "name": {
                "type": "string"
              },
              "required": {
                "anyOf": [
                  {
                    "type": "boolean"
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "required_name_hint": {
                "type": "boolean"
              },
              "required_status": {
                "enum": [
                  "not_required",
                  "unknown",
                  "satisfied",
                  "missing"
                ],
                "type": "string"
              },
              "type": {
                "type": "string"
              },
              "value_status": {
                "enum": [
                  "observed",
                  "empty",
                  "unchecked",
                  "unknown",
                  "read_error",
                  "not_applicable"
                ],
                "type": "string"
              }
            },
            "required": [
              "name",
              "type",
              "kind",
              "required",
              "required_name_hint",
              "value_status",
              "required_status",
              "error_code"
            ],
            "type": "object"
          },
          "type": "array"
        },
        "file_name": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ]
        },
        "filled_count": {
          "type": "null"
        },
        "has_form_fields": {
          "type": "null"
        },
        "heuristic_required_candidates": {
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        "indeterminate_required_count": {
          "type": "null"
        },
        "indeterminate_required_fields": {
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        "limitations": {
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        "missing_required_count": {
          "type": "null"
        },
        "missing_required_fields": {
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        "not_applicable_count": {
          "type": "null"
        },
        "observed_count": {
          "type": "null"
        },
        "observed_fields": {
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        "pdf_path": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ]
        },
        "read_error_count": {
          "type": "null"
        },
        "read_error_fields": {
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        "required_field_count": {
          "type": "null"
        },
        "required_field_validation_status": {
          "const": "failed"
        },
        "required_fields_complete": {
          "anyOf": [
            {
              "type": "boolean"
            },
            {
              "type": "null"
            }
          ]
        },
        "requiredness_unknown_count": {
          "type": "null"
        },
        "requiredness_unknown_fields": {
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        "retry_guidance": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ]
        },
        "schema_version": {
          "const": "1.0"
        },
        "total_field_count": {
          "type": "null"
        },
        "unchecked_count": {
          "type": "null"
        },
        "unchecked_fields": {
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        "unknown_count": {
          "type": "null"
        },
        "unknown_fields": {
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        "validation_conclusive": {
          "type": "boolean"
        },
        "validation_status": {
          "const": "failed"
        },
        "value_field_count": {
          "type": "null"
        },
        "warning_codes": {
          "items": {
            "type": "string"
          },
          "type": "array"
        }
      },
      "required": [
        "schema_version",
        "pdf_path",
        "file_name",
        "validation_status",
        "required_field_validation_status",
        "validation_conclusive",
        "has_form_fields",
        "required_fields_complete",
        "all_value_fields_filled",
        "can_claim_required_fields_complete",
        "can_claim_form_ready",
        "total_field_count",
        "value_field_count",
        "observed_count",
        "filled_count",
        "empty_count",
        "unchecked_count",
        "unknown_count",
        "read_error_count",
        "not_applicable_count",
        "required_field_count",
        "missing_required_count",
        "indeterminate_required_count",
        "requiredness_unknown_count",
        "fields",
        "observed_fields",
        "empty_fields",
        "unchecked_fields",
        "unknown_fields",
        "read_error_fields",
        "missing_required_fields",
        "indeterminate_required_fields",
        "requiredness_unknown_fields",
        "heuristic_required_candidates",
        "error_codes",
        "warning_codes",
        "retry_guidance",
        "limitations"
      ],
      "type": "object"
    }
  ],
  "type": "object"
}
sha256:6ef7a4dca4178e8d9d9d296210bb13111dc3c05c7a6ebe6506274079a10eb686

Description hash: sha256:1573839a10827e19105da48172fa5111d49fc0118801777f4b130a74b895586e

Interface hash: sha256:3ef2524198d2c4e96b7250b8ef89a27bf6681cb4d71e3c09eafd993130ce6ba3

Other observed Modelara metadata
{
  "id": "mcp:pdf-tools/validate_pdf",
  "title": "Validate PDF Form",
  "source": {
    "type": "mcp",
    "server": "pdf-tools",
    "operation": "validate_pdf"
  },
  "declared": {
    "read_only": "true",
    "destructive": "false",
    "idempotent": "true",
    "open_world": "false"
  },
  "safety": {
    "idempotent": "true",
    "retry_safe": "true"
  },
  "metadata": {
    "mcp.annotations": "present"
  },
  "fingerprint": "sha256:e12e283aaa62117b052ec1931b8795a3df7f29043afc8976fcc24759440e502a"
}
toolread0.12.1No change observed
verify_extraction_proposalpdf-toolkit:tool:verify_extraction_proposal
Observed interface and hashes

Deterministically replay one proposal against fresh PDF bytes, the retained schema, and exact cited chunk byte ranges, then append the typed result. No model, network, or numeric confidence.

Input schema

{
  "additionalProperties": false,
  "properties": {
    "citations": {
      "items": {
        "additionalProperties": false,
        "properties": {
          "chunk_id": {
            "pattern": "^chunk\\.[a-f0-9]{64}$",
            "type": "string"
          },
          "end_utf8_byte": {
            "minimum": 1,
            "type": "integer"
          },
          "quote_sha256": {
            "pattern": "^[a-f0-9]{64}$",
            "type": "string"
          },
          "start_utf8_byte": {
            "minimum": 0,
            "type": "integer"
          }
        },
        "required": [
          "chunk_id",
          "start_utf8_byte",
          "end_utf8_byte",
          "quote_sha256"
        ],
        "type": "object"
      },
      "maxItems": 32,
      "type": "array"
    },
    "method": {
      "type": "object"
    },
    "password": {
      "type": "string"
    },
    "pdf_path": {
      "type": "string"
    },
    "proposal_event_id": {
      "pattern": "^event\\.[a-f0-9]{64}$",
      "type": "string"
    },
    "proposal_generation_sha256": {
      "pattern": "^[a-f0-9]{64}$",
      "type": "string"
    },
    "workspace_id": {
      "type": "string"
    },
    "workspace_identity_sha256": {
      "pattern": "^[a-f0-9]{64}$",
      "type": "string"
    }
  },
  "required": [
    "pdf_path",
    "workspace_id",
    "workspace_identity_sha256",
    "proposal_generation_sha256",
    "proposal_event_id",
    "citations",
    "method"
  ],
  "type": "object"
}
sha256:f1b4b32bf787a410212e510ee9c83774068b4d05518146ab99e66773aee68514

Output schema

{
  "anyOf": [
    {
      "additionalProperties": false,
      "properties": {
        "event": {
          "additionalProperties": false,
          "properties": {
            "contract": {
              "additionalProperties": false,
              "properties": {
                "name": {
                  "const": "pdf-tools.verified-extraction-workspace-event"
                },
                "version": {
                  "const": "1.1.0-experimental"
                }
              },
              "required": [
                "name",
                "version"
              ],
              "type": "object"
            },
            "event_id": {
              "pattern": "^event\\.[a-f0-9]{64}$",
              "type": "string"
            },
            "event_sequence": {
              "minimum": 1,
              "type": "integer"
            },
            "kind": {
              "const": "proposal_verified"
            },
            "leaf_pointer": {
              "type": "string"
            },
            "proposal_event_id": {
              "pattern": "^event\\.[a-f0-9]{64}$",
              "type": "string"
            },
            "verification_result": {
              "additionalProperties": false,
              "properties": {
                "calculation": {},
                "caller_confidence_accepted_as_proof": {
                  "const": false
                },
                "caller_geometry_accepted_as_proof": {
                  "const": false
                },
                "caller_text_accepted_as_proof": {
                  "const": false
                },
                "chunk_policy_sha256": {
                  "pattern": "^[a-f0-9]{64}$",
                  "type": "string"
                },
                "citations": {
                  "items": {},
                  "type": "array"
                },
                "claim_boundary": {
                  "type": "string"
                },
                "contract": {
                  "type": "object"
                },
                "derived_value": {},
                "document_map_sha256": {
                  "pattern": "^[a-f0-9]{64}$",
                  "type": "string"
                },
                "generation_sha256": {
                  "pattern": "^[a-f0-9]{64}$",
                  "type": "string"
                },
                "leaf_pointer": {
                  "type": "string"
                },
                "method": {
                  "type": "object"
                },
                "package_inclusion": {
                  "const": "enabled_experimental"
                },
                "proposal_event": {
                  "additionalProperties": false,
                  "properties": {
                    "chunk_ids": {
                      "items": {
                        "pattern": "^chunk\\.[a-f0-9]{64}$",
                        "type": "string"
                      },
                      "type": "array"
                    },
                    "contract": {
                      "additionalProperties": false,
                      "properties": {
                        "name": {
                          "const": "pdf-tools.verified-extraction-workspace-event"
                        },
                        "version": {
                          "const": "1.1.0-experimental"
                        }
                      },
                      "required": [
                        "name",
                        "version"
                      ],
                      "type": "object"
                    },
                    "event_id": {
                      "pattern": "^event\\.[a-f0-9]{64}$",
                      "type": "string"
                    },
                    "event_sequence": {
                      "minimum": 1,
                      "type": "integer"
                    },
                    "kind": {
                      "const": "proposal_submitted"
                    },
                    "leaf_pointer": {
                      "type": "string"
                    },
                    "proposed_value": {},
                    "verification": {
                      "additionalProperties": false,
                      "properties": {
                        "reason": {
                          "const": "not_replayed"
                        },
                        "status": {
                          "const": "unverified"
                        }
                      },
                      "required": [
                        "status",
                        "reason"
                      ],
                      "type": "object"
                    },
                    "workspace_identity_sha256": {
                      "pattern": "^[a-f0-9]{64}$",
                      "type": "string"
                    }
                  },
                  "required": [
                    "contract",
                    "event_sequence",
                    "kind",
                    "workspace_identity_sha256",
                    "leaf_pointer",
                    "proposed_value",
                    "chunk_ids",
                    "verification",
                    "event_id"
                  ],
                  "type": "object"
                },
                "proposal_event_id": {
                  "pattern": "^event\\.[a-f0-9]{64}$",
                  "type": "string"
                },
                "proposed_value": {},
                "proposed_value_sha256": {
                  "pattern": "^[a-f0-9]{64}$",
                  "type": "string"
                },
                "reason_codes": {
                  "items": {
                    "type": "string"
                  },
                  "type": "array"
                },
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "sha256": {
                      "pattern": "^[a-f0-9]{64}$",
                      "type": "string"
                    },
                    "size_bytes": {
                      "minimum": 1,
                      "type": "integer"
                    }
                  },
                  "required": [
                    "sha256",
                    "size_bytes"
                  ],
                  "type": "object"
                },
                "schema_replayed": {
                  "const": true
                },
                "search_scope": {},
                "source": {
                  "additionalProperties": false,
                  "properties": {
                    "sha256": {
                      "pattern": "^[a-f0-9]{64}$",
                      "type": "string"
                    },
                    "size_bytes": {
                      "minimum": 1,
                      "type": "integer"
                    }
                  },
                  "required": [
                    "sha256",
                    "size_bytes"
                  ],
                  "type": "object"
                },
                "source_replayed": {
                  "const": true
                },
                "status": {
                  "enum": [
                    "verified_exact",
                    "computed_with_inputs",
                    "source_supported",
                    "not_found",
                    "ambiguous",
                    "unverified_reasoning",
                    "citation_mismatch",
                    "chunk_missing"
                  ],
                  "type": "string"
                },
                "table_topology_proven": {
                  "const": false
                },
                "verification_sha256": {
                  "pattern": "^[a-f0-9]{64}$",
                  "type": "string"
                },
                "workspace_identity_sha256": {
                  "pattern": "^[a-f0-9]{64}$",
                  "type": "string"
                }
              },
              "required": [
                "contract",
                "workspace_identity_sha256",
                "generation_sha256",
                "proposal_event_id",
                "proposal_event",
                "leaf_pointer",
                "proposed_value",
                "proposed_value_sha256",
                "source",
                "schema",
                "document_map_sha256",
                "chunk_policy_sha256",
                "status",
                "reason_codes",
                "citations",
                "method",
                "derived_value",
                "calculation",
                "search_scope",
                "source_replayed",
                "schema_replayed",
                "caller_text_accepted_as_proof",
                "caller_geometry_accepted_as_proof",
                "caller_confidence_accepted_as_proof",
                "table_topology_proven",
                "claim_boundary",
                "package_inclusion",
                "verification_sha256"
              ],
              "type": "object"
            },
            "workspace_identity_sha256": {
              "pattern": "^[a-f0-9]{64}$",
              "type": "string"
            }
          },
          "required": [
            "contract",
            "event_sequence",
            "kind",
            "workspace_identity_sha256",
            "leaf_pointer",
            "proposal_event_id",
            "verification_result",
            "event_id"
          ],
          "type": "object"
        },
        "generation_sequence": {
          "minimum": 0,
          "type": "integer"
        },
        "generation_sha256": {
          "pattern": "^[a-f0-9]{64}$",
          "type": "string"
        },
        "result": {
          "additionalProperties": false,
          "properties": {
            "calculation": {},
            "caller_confidence_accepted_as_proof": {
              "const": false
            },
            "caller_geometry_accepted_as_proof": {
              "const": false
            },
            "caller_text_accepted_as_proof": {
              "const": false
            },
            "chunk_policy_sha256": {
              "pattern": "^[a-f0-9]{64}$",
              "type": "string"
            },
            "citations": {
              "items": {},
              "type": "array"
            },
            "claim_boundary": {
              "type": "string"
            },
            "contract": {
              "type": "object"
            },
            "derived_value": {},
            "document_map_sha256": {
              "pattern": "^[a-f0-9]{64}$",
              "type": "string"
            },
            "generation_sha256": {
              "pattern": "^[a-f0-9]{64}$",
              "type": "string"
            },
            "leaf_pointer": {
              "type": "string"
            },
            "method": {
              "type": "object"
            },
            "package_inclusion": {
              "const": "enabled_experimental"
            },
            "proposal_event": {
              "additionalProperties": false,
              "properties": {
                "chunk_ids": {
                  "items": {
                    "pattern": "^chunk\\.[a-f0-9]{64}$",
                    "type": "string"
                  },
                  "type": "array"
                },
                "contract": {
                  "additionalProperties": false,
                  "properties": {
                    "name": {
                      "const": "pdf-tools.verified-extraction-workspace-event"
                    },
                    "version": {
                      "const": "1.1.0-experimental"
                    }
                  },
                  "required": [
                    "name",
                    "version"
                  ],
                  "type": "object"
                },
                "event_id": {
                  "pattern": "^event\\.[a-f0-9]{64}$",
                  "type": "string"
                },
                "event_sequence": {
                  "minimum": 1,
                  "type": "integer"
                },
                "kind": {
                  "const": "proposal_submitted"
                },
                "leaf_pointer": {
                  "type": "string"
                },
                "proposed_value": {},
                "verification": {
                  "additionalProperties": false,
                  "properties": {
                    "reason": {
                      "const": "not_replayed"
                    },
                    "status": {
                      "const": "unverified"
                    }
                  },
                  "required": [
                    "status",
                    "reason"
                  ],
                  "type": "object"
                },
                "workspace_identity_sha256": {
                  "pattern": "^[a-f0-9]{64}$",
                  "type": "string"
                }
              },
              "required": [
                "contract",
                "event_sequence",
                "kind",
                "workspace_identity_sha256",
                "leaf_pointer",
                "proposed_value",
                "chunk_ids",
                "verification",
                "event_id"
              ],
              "type": "object"
            },
            "proposal_event_id": {
              "pattern": "^event\\.[a-f0-9]{64}$",
              "type": "string"
            },
            "proposed_value": {},
            "proposed_value_sha256": {
              "pattern": "^[a-f0-9]{64}$",
              "type": "string"
            },
            "reason_codes": {
              "items": {
                "type": "string"
              },
              "type": "array"
            },
            "schema": {
              "additionalProperties": false,
              "properties": {
                "sha256": {
                  "pattern": "^[a-f0-9]{64}$",
                  "type": "string"
                },
                "size_bytes": {
                  "minimum": 1,
                  "type": "integer"
                }
              },
              "required": [
                "sha256",
                "size_bytes"
              ],
              "type": "object"
            },
            "schema_replayed": {
              "const": true
            },
            "search_scope": {},
            "source": {
              "additionalProperties": false,
              "properties": {
                "sha256": {
                  "pattern": "^[a-f0-9]{64}$",
                  "type": "string"
                },
                "size_bytes": {
                  "minimum": 1,
                  "type": "integer"
                }
              },
              "required": [
                "sha256",
                "size_bytes"
              ],
              "type": "object"
            },
            "source_replayed": {
              "const": true
            },
            "status": {
              "enum": [
                "verified_exact",
                "computed_with_inputs",
                "source_supported",
                "not_found",
                "ambiguous",
                "unverified_reasoning",
                "citation_mismatch",
                "chunk_missing"
              ],
              "type": "string"
            },
            "table_topology_proven": {
              "const": false
            },
            "verification_sha256": {
              "pattern": "^[a-f0-9]{64}$",
              "type": "string"
            },
            "workspace_identity_sha256": {
              "pattern": "^[a-f0-9]{64}$",
              "type": "string"
            }
          },
          "required": [
            "contract",
            "workspace_identity_sha256",
            "generation_sha256",
            "proposal_event_id",
            "proposal_event",
            "leaf_pointer",
            "proposed_value",
            "proposed_value_sha256",
            "source",
            "schema",
            "document_map_sha256",
            "chunk_policy_sha256",
            "status",
            "reason_codes",
            "citations",
            "method",
            "derived_value",
            "calculation",
            "search_scope",
            "source_replayed",
            "schema_replayed",
            "caller_text_accepted_as_proof",
            "caller_geometry_accepted_as_proof",
            "caller_confidence_accepted_as_proof",
            "table_topology_proven",
            "claim_boundary",
            "package_inclusion",
            "verification_sha256"
          ],
          "type": "object"
        },
        "state": {
          "const": "complete"
        },
        "workspace_identity_sha256": {
          "pattern": "^[a-f0-9]{64}$",
          "type": "string"
        }
      },
      "required": [
        "workspace_identity_sha256",
        "generation_sha256",
        "generation_sequence",
        "event",
        "result",
        "state"
      ],
      "type": "object"
    },
    {
      "additionalProperties": false,
      "properties": {
        "error": {
          "additionalProperties": false,
          "properties": {
            "code": {
              "enum": [
                "internal_validation_error",
                "path_policy_denied",
                "tool_execution_failed"
              ],
              "type": "string"
            },
            "error_schema_version": {
              "const": 1
            }
          },
          "required": [
            "error_schema_version",
            "code"
          ],
          "type": "object"
        },
        "status": {
          "const": "failed"
        }
      },
      "required": [
        "status",
        "error"
      ],
      "type": "object"
    }
  ],
  "type": "object"
}
sha256:55fec9329c27744caee91232672945ad00115b68b84e3a35ff730cb140b36375

Description hash: sha256:a201d205ddcc4232db718e9ded0821769319d5ec191e646832ad6bb117eef891

Interface hash: sha256:e2193fdf7d39e5cd4116b9434e225a51793bb6286c4ef9e9be8ed701451a53a5

Other observed Modelara metadata
{
  "id": "mcp:pdf-tools/verify_extraction_proposal",
  "title": "Verify Extraction Proposal",
  "source": {
    "type": "mcp",
    "server": "pdf-tools",
    "operation": "verify_extraction_proposal"
  },
  "declared": {
    "read_only": "false",
    "destructive": "false",
    "idempotent": "false",
    "open_world": "false"
  },
  "safety": {
    "idempotent": "false",
    "retry_safe": "false"
  },
  "metadata": {
    "mcp.annotations": "present"
  },
  "fingerprint": "sha256:181587cc8c50797f435aba65f7cddd4d11c34cd61af24b28d52068cabecb6683"
}
toolwrite0.13.00.13.0
verify_table_proposalpdf-toolkit:tool:verify_table_proposal
Observed interface and hashes

Deterministically check an untrusted table-structure proposal against a fresh, independently source-validated parse of the current PDF. The caller supplies only a region/token identity and item-to-cell assignments; text, geometry, header evidence, and packet fields are regenerated from source bytes. Acceptance means source-derived content passed coverage and ordering checks and the rectangular grid agrees with every available source ruling segment. Borderless or otherwise ambiguous geometry rejects. Consistency does not prove unique topology. No OCR, model, network, mutation, or numeric confidence.

Input schema

{
  "additionalProperties": false,
  "properties": {
    "cells": {
      "description": "Untrusted structural assignments. Cell text is never accepted from the caller.",
      "items": {
        "additionalProperties": false,
        "properties": {
          "colspan": {
            "maximum": 1000,
            "minimum": 1,
            "type": "integer"
          },
          "column": {
            "maximum": 999,
            "minimum": 0,
            "type": "integer"
          },
          "item_ids": {
            "items": {
              "maxLength": 128,
              "minLength": 1,
              "type": "string"
            },
            "maxItems": 400,
            "type": "array"
          },
          "row": {
            "maximum": 999,
            "minimum": 0,
            "type": "integer"
          },
          "rowspan": {
            "maximum": 1000,
            "minimum": 1,
            "type": "integer"
          }
        },
        "required": [
          "row",
          "column",
          "rowspan",
          "colspan",
          "item_ids"
        ],
        "type": "object"
      },
      "maxItems": 1000,
      "minItems": 1,
      "type": "array"
    },
    "password": {
      "description": "Password for an encrypted PDF, when required.",
      "type": "string"
    },
    "pdf_path": {
      "description": "Absolute path, or ~/ path, to the same local PDF used to obtain the proposal packet.",
      "type": "string"
    },
    "proposal_token": {
      "description": "B1 SHA-256 token binding the source SHA-256, extraction IR version, and region identity.",
      "pattern": "^[a-f0-9]{64}$",
      "type": "string"
    },
    "region_id": {
      "description": "Deterministic B1 abandoned-region identity, such as p1-t1.",
      "pattern": "^p[1-9][0-9]*-t[1-9][0-9]*$",
      "type": "string"
    }
  },
  "required": [
    "pdf_path",
    "region_id",
    "proposal_token",
    "cells"
  ],
  "type": "object"
}
sha256:7cb8535c271f11538e0df69024dbbcc331aa3e67f735290b795f1638d1437ff9

Output schema

{
  "anyOf": [
    {
      "additionalProperties": false,
      "properties": {
        "checks": {
          "additionalProperties": false,
          "properties": {
            "cell_input": {
              "enum": [
                "passed",
                "failed",
                "not_run"
              ],
              "type": "string"
            },
            "column_order": {
              "enum": [
                "passed",
                "failed",
                "not_run"
              ],
              "type": "string"
            },
            "content_source": {
              "enum": [
                "passed",
                "failed",
                "not_run"
              ],
              "type": "string"
            },
            "coverage": {
              "enum": [
                "passed",
                "failed",
                "not_run"
              ],
              "type": "string"
            },
            "cut_line_consistency": {
              "enum": [
                "passed",
                "failed",
                "not_run"
              ],
              "type": "string"
            },
            "header_evidence": {
              "enum": [
                "passed",
                "failed",
                "not_run"
              ],
              "type": "string"
            },
            "one_cell": {
              "enum": [
                "passed",
                "failed",
                "not_run"
              ],
              "type": "string"
            },
            "rectangular_grid": {
              "enum": [
                "passed",
                "failed",
                "not_run"
              ],
              "type": "string"
            },
            "region_evidence": {
              "enum": [
                "passed",
                "failed",
                "not_run"
              ],
              "type": "string"
            },
            "row_non_straddle": {
              "enum": [
                "passed",
                "failed",
                "not_run"
              ],
              "type": "string"
            },
            "row_order": {
              "enum": [
                "passed",
                "failed",
                "not_run"
              ],
              "type": "string"
            },
            "ruled_line_agreement": {
              "enum": [
                "passed",
                "failed",
                "not_run"
              ],
              "type": "string"
            },
            "token_binding": {
              "enum": [
                "passed",
                "failed",
                "not_run"
              ],
              "type": "string"
            },
            "topology_ambiguity": {
              "enum": [
                "passed",
                "failed",
                "not_run"
              ],
              "type": "string"
            }
          },
          "required": [
            "token_binding",
            "region_evidence",
            "cell_input",
            "coverage",
            "one_cell",
            "row_non_straddle",
            "row_order",
            "column_order",
            "rectangular_grid",
            "cut_line_consistency",
            "ruled_line_agreement",
            "topology_ambiguity",
            "header_evidence",
            "content_source"
          ],
          "type": "object"
        },
        "claim_boundary": {
          "const": "Accepted cell content is constructed only from reparsed source text items, and the proposed grid is well formed and consistent with all source-replayed ruling geometry available. GFM output is a syntax-escaped rectangular projection; row and column spans remain authoritative only in the structured cells. Consistency is not proof of unique topology; ambiguous or unsupported geometry is rejected."
        },
        "layout": {
          "additionalProperties": false,
          "properties": {
            "name": {
              "const": "pdf-tools.extraction-ir"
            },
            "parser_name": {
              "const": "pdfjs-dist"
            },
            "parser_version": {
              "const": "5.4.624"
            },
            "version": {
              "const": "1.6.0"
            }
          },
          "required": [
            "name",
            "version",
            "parser_name",
            "parser_version"
          ],
          "type": "object"
        },
        "reason_codes": {
          "items": {
            "enum": [
              "TABLE_PROPOSAL_TOKEN_MISMATCH",
              "TABLE_PROPOSAL_REGION_NOT_FOUND",
              "TABLE_PROPOSAL_REGION_TRUNCATED",
              "TABLE_PROPOSAL_REGION_UNSUPPORTED",
              "TABLE_PROPOSAL_CELL_INVALID",
              "TABLE_PROPOSAL_ITEM_UNKNOWN",
              "TABLE_PROPOSAL_ITEM_DUPLICATED",
              "TABLE_PROPOSAL_ITEM_MISSING",
              "TABLE_PROPOSAL_LINE_STRADDLE",
              "TABLE_PROPOSAL_ROW_ORDER",
              "TABLE_PROPOSAL_COLUMN_ORDER",
              "TABLE_PROPOSAL_HEADER_UNSUPPORTED",
              "TABLE_PROPOSAL_GRID_INVALID",
              "TABLE_PROPOSAL_CUTS_INCONSISTENT",
              "TABLE_PROPOSAL_RULING_CONFLICT",
              "TABLE_PROPOSAL_TOPOLOGY_AMBIGUOUS"
            ],
            "type": "string"
          },
          "type": "array"
        },
        "region": {
          "additionalProperties": false,
          "properties": {
            "abandonment_reason": {
              "anyOf": [
                {
                  "enum": [
                    "TABLE_TOPOLOGY_UNKNOWN",
                    "TABLE_RULING_UNSUPPORTED"
                  ],
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ]
            },
            "page": {
              "minimum": 1,
              "type": "integer"
            },
            "region_id": {
              "pattern": "^p[1-9][0-9]*-t[1-9][0-9]*$",
              "type": "string"
            }
          },
          "required": [
            "region_id",
            "page",
            "abandonment_reason"
          ],
          "type": "object"
        },
        "source": {
          "additionalProperties": false,
          "properties": {
            "file_name": {
              "type": "string"
            },
            "sha256": {
              "pattern": "^[a-f0-9]{64}$",
              "type": "string"
            },
            "size_bytes": {
              "minimum": 0,
              "type": "integer"
            }
          },
          "required": [
            "file_name",
            "sha256",
            "size_bytes"
          ],
          "type": "object"
        },
        "source_reparsed": {
          "const": true
        },
        "status": {
          "enum": [
            "accepted",
            "rejected"
          ],
          "type": "string"
        },
        "table": {
          "anyOf": [
            {
              "additionalProperties": false,
              "properties": {
                "cells": {
                  "items": {
                    "additionalProperties": false,
                    "properties": {
                      "colspan": {
                        "minimum": 1,
                        "type": "integer"
                      },
                      "column": {
                        "minimum": 0,
                        "type": "integer"
                      },
                      "item_ids": {
                        "items": {
                          "type": "string"
                        },
                        "type": "array"
                      },
                      "row": {
                        "minimum": 0,
                        "type": "integer"
                      },
                      "rowspan": {
                        "minimum": 1,
                        "type": "integer"
                      },
                      "text": {
                        "type": "string"
                      }
                    },
                    "required": [
                      "row",
                      "column",
                      "rowspan",
                      "colspan",
                      "item_ids",
                      "text"
                    ],
                    "type": "object"
                  },
                  "type": "array"
                },
                "column_count": {
                  "minimum": 1,
                  "type": "integer"
                },
                "content_origin": {
                  "const": "reparsed_pdf_text_layer"
                },
                "markdown": {
                  "type": "string"
                },
                "markdown_bytes": {
                  "minimum": 1,
                  "type": "integer"
                },
                "markdown_format": {
                  "const": "gfm"
                },
                "markdown_sha256": {
                  "pattern": "^[a-f0-9]{64}$",
                  "type": "string"
                },
                "markdown_span_projection": {
                  "const": "anchor_text_with_empty_continuation_cells"
                },
                "row_count": {
                  "minimum": 1,
                  "type": "integer"
                }
              },
              "required": [
                "row_count",
                "column_count",
                "cells",
                "content_origin",
                "markdown",
                "markdown_format",
                "markdown_span_projection",
                "markdown_bytes",
                "markdown_sha256"
              ],
              "type": "object"
            },
            {
              "type": "null"
            }
          ]
        },
        "verifier": {
          "additionalProperties": false,
          "properties": {
            "name": {
              "const": "pdf-tools.table-proposal-verifier"
            },
            "version": {
              "const": "0.3.0"
            }
          },
          "required": [
            "name",
            "version"
          ],
          "type": "object"
        }
      },
      "required": [
        "verifier",
        "status",
        "reason_codes",
        "source",
        "layout",
        "region",
        "source_reparsed",
        "checks",
        "table",
        "claim_boundary"
      ],
      "type": "object"
    },
    {
      "additionalProperties": false,
      "properties": {
        "error": {
          "additionalProperties": false,
          "properties": {
            "code": {
              "enum": [
                "internal_validation_error",
                "path_policy_denied",
                "tool_execution_failed"
              ],
              "type": "string"
            },
            "error_schema_version": {
              "const": 1
            }
          },
          "required": [
            "error_schema_version",
            "code"
          ],
          "type": "object"
        },
        "status": {
          "const": "failed"
        }
      },
      "required": [
        "status",
        "error"
      ],
      "type": "object"
    },
    {
      "additionalProperties": false,
      "properties": {
        "error": {
          "additionalProperties": false,
          "properties": {
            "code": {
              "enum": [
                "PASSWORD_REQUIRED",
                "PASSWORD_INCORRECT"
              ],
              "type": "string"
            },
            "error_schema_version": {
              "const": 1
            }
          },
          "required": [
            "error_schema_version",
            "code"
          ],
          "type": "object"
        },
        "status": {
          "const": "failed"
        }
      },
      "required": [
        "status",
        "error"
      ],
      "type": "object"
    },
    {
      "additionalProperties": false,
      "properties": {
        "error": {
          "additionalProperties": false,
          "properties": {
            "code": {
              "const": "PDF_RESOURCE_LIMIT_EXCEEDED"
            },
            "error_schema_version": {
              "const": 1
            }
          },
          "required": [
            "error_schema_version",
            "code"
          ],
          "type": "object"
        },
        "status": {
          "const": "failed"
        }
      },
      "required": [
        "status",
        "error"
      ],
      "type": "object"
    }
  ],
  "type": "object"
}
sha256:149283e8c3386e227322bf7a072296a1bfaaa1e90e93db6ca05521e3f59b72b5

Description hash: sha256:1ea02701ea9dac4a099cc565bd0c673e4ebd731dadc1aef749adeada63866ee0

Interface hash: sha256:7f914a2c9a39c7a0ca593ef7fcc5ac8a4b0f74e044146b4c284864ecf0b663c4

Other observed Modelara metadata
{
  "id": "mcp:pdf-tools/verify_table_proposal",
  "title": "Verify Table Proposal",
  "source": {
    "type": "mcp",
    "server": "pdf-tools",
    "operation": "verify_table_proposal"
  },
  "declared": {
    "read_only": "true",
    "destructive": "false",
    "idempotent": "true",
    "open_world": "false"
  },
  "safety": {
    "idempotent": "true",
    "retry_safe": "true"
  },
  "metadata": {
    "mcp.annotations": "present"
  },
  "fingerprint": "sha256:52e5b948c57cb2b9529a497df4c9fc9b74180d92d89f6a19bf19241c8eeb9d4b"
}
toolread0.12.1No change observed

STATIC COMPARISONS

Release history

2 release transitions
  1. 6 added0 removed13 schema4 write1 destructive0 unknown

    Nov 5, 2026· Pending human review

  2. 7 added0 removed3 schema3 write1 destructive0 unknown

    Nov 5, 2026· Pending human review