{
  "notice": "bxzxxr MCP archive: a record of what public MCP servers declared when we listed them (we never call their tools). It is data, not a rating: nothing here says a server is safe, secure, verified or trustworthy, and a server can change after we looked. Secrets we detected are redacted; redacted tool lists are withheld and only their hash is shown.",
  "infrastructure": {
    "host": "pdfops.dev",
    "site": "pdfops.dev",
    "addresses": [
      {
        "address": "216.150.1.129",
        "endpoints": 450,
        "shared_infrastructure": true,
        "network": {
          "asn": 16509,
          "name": "AMAZON-02 - Amazon.com, Inc.",
          "prefix": "216.150.1.0/24",
          "country": "US"
        }
      },
      {
        "address": "216.150.16.129",
        "endpoints": 436,
        "shared_infrastructure": true,
        "network": {
          "asn": 16509,
          "name": "AMAZON-02 - Amazon.com, Inc.",
          "prefix": "216.150.16.0/24",
          "country": "US"
        }
      }
    ],
    "addresses_recorded": true,
    "address_history": [
      {
        "addresses": [
          "216.150.1.129",
          "216.150.16.129"
        ],
        "first_seen": "2026-11-22T17:32:02.483Z",
        "last_seen": "2026-11-22T17:32:02.483Z",
        "checks": 1
      },
      {
        "addresses": [
          "216.150.16.193",
          "216.150.1.193"
        ],
        "first_seen": "2026-11-21T12:31:01.258Z",
        "last_seen": "2026-11-21T12:31:01.258Z",
        "checks": 1
      }
    ],
    "hosting": [
      {
        "value": "Vercel",
        "evidence": "Server header \"Vercel\""
      }
    ],
    "software": [],
    "server_info": {
      "name": "pdfops",
      "version": "1.0.0",
      "protocol_version": "2025-06-18"
    },
    "headers": {
      "server": "Vercel",
      "strict-transport-security": "max-age=31536000; includeSubDomains; preload"
    },
    "auth": null
  },
  "related": {
    "same_address": {
      "total": 637,
      "sample": [
        {
          "id": "26",
          "url": "https://mrk.ae/api/mcp",
          "server_name": "ae.mrk/dubai-property",
          "last_state": "listed",
          "last_checked_at": "2026-11-22T04:31:08.438Z"
        },
        {
          "id": "144",
          "url": "https://mcp.agentgates.ai/compute",
          "server_name": "ai.agentgates/compute",
          "last_state": "listed",
          "last_checked_at": "2026-11-22T04:33:02.000Z"
        },
        {
          "id": "300",
          "url": "https://app.augenix.ai/api/mcp/public",
          "server_name": "ai.augenix/build",
          "last_state": "listed",
          "last_checked_at": "2026-11-22T04:38:01.449Z"
        },
        {
          "id": "461",
          "url": "https://callmcp.ai/mcp",
          "server_name": "ai.callmcp/server",
          "last_state": "listed",
          "last_checked_at": "2026-11-22T04:41:01.824Z"
        },
        {
          "id": "465",
          "url": "https://www.canaryusers.ai/api/mcp",
          "server_name": "ai.canaryusers/canaryusers",
          "last_state": "listed",
          "last_checked_at": "2026-11-22T04:41:01.864Z"
        },
        {
          "id": "523",
          "url": "https://agentmart.ciphyr.ai/mcp",
          "server_name": "ai.ciphyr.agentmart/agentmart",
          "last_state": "listed",
          "last_checked_at": "2026-11-22T04:42:02.049Z"
        },
        {
          "id": "524",
          "url": "https://agentmart.ciphyr.ai/mcp/core",
          "server_name": "ai.ciphyr.agentmart/core",
          "last_state": "listed",
          "last_checked_at": "2026-11-22T04:44:00.984Z"
        },
        {
          "id": "540",
          "url": "https://www.clearthesis.ai/mcp",
          "server_name": "ai.clearthesis/clearthesis",
          "last_state": "listed",
          "last_checked_at": "2026-11-22T04:43:00.925Z"
        },
        {
          "id": "670",
          "url": "https://www.decisionlog.ai/api/mcp",
          "server_name": "ai.decisionlog/mcp",
          "last_state": "listed",
          "last_checked_at": "2026-11-22T04:45:03.762Z"
        },
        {
          "id": "906",
          "url": "https://www.frontierdesk.ai/mcp",
          "server_name": "ai.frontierdesk/desk",
          "last_state": "listed",
          "last_checked_at": "2026-11-22T04:52:01.102Z"
        },
        {
          "id": "1078",
          "url": "https://api.gosummer.ai/mcp",
          "server_name": "ai.gosummer/summer",
          "last_state": "listed",
          "last_checked_at": "2026-11-22T04:54:00.852Z"
        },
        {
          "id": "1105",
          "url": "https://guestlogic.ai/mcp",
          "server_name": "ai.guestlogic/guest-logic",
          "last_state": "listed",
          "last_checked_at": "2026-11-22T04:55:02.067Z"
        },
        {
          "id": "1374",
          "url": "https://api.last-price.ai/api/mcp/rpc?profile=lean",
          "server_name": "ai.last-price/pricing",
          "last_state": "listed",
          "last_checked_at": "2026-11-22T05:00:04.106Z"
        },
        {
          "id": "1375",
          "url": "https://api.last-price.ai/api/mcp/rpc",
          "server_name": "ai.last-price/pricing",
          "last_state": "listed",
          "last_checked_at": "2026-11-22T05:02:01.487Z"
        },
        {
          "id": "1480",
          "url": "https://makerportal.ai/api/mcp",
          "server_name": "ai.makerportal/compute",
          "last_state": "listed",
          "last_checked_at": "2026-11-22T05:04:17.776Z"
        },
        {
          "id": "1574",
          "url": "https://www.mosaya.ai/api/mcp",
          "server_name": "ai.mosaya/practice",
          "last_state": "listed",
          "last_checked_at": "2026-11-22T06:43:09.232Z"
        },
        {
          "id": "1616",
          "url": "https://nerdnoir.ai/api/mcp",
          "server_name": "ai.nerdnoir/nerdy",
          "last_state": "listed",
          "last_checked_at": "2026-11-22T06:44:01.679Z"
        },
        {
          "id": "1704",
          "url": "https://opensolid.ai/mcp",
          "server_name": "ai.opensolid/opensolid",
          "last_state": "listed",
          "last_checked_at": "2026-11-22T06:45:02.095Z"
        },
        {
          "id": "1815",
          "url": "https://polargate.ai/api/mcp",
          "server_name": "ai.polargate/polargate",
          "last_state": "listed",
          "last_checked_at": "2026-11-22T06:46:01.165Z"
        },
        {
          "id": "2068",
          "url": "https://satohub.ai/api/mcp",
          "server_name": "ai.satohub/onchain-agents",
          "last_state": "listed",
          "last_checked_at": "2026-11-22T06:48:30.648Z"
        }
      ]
    },
    "same_site": {
      "total": 0,
      "sample": []
    },
    "same_tool_list": {
      "total": 0,
      "sample": []
    },
    "same_publisher": {
      "publisher": "dev.pdfops",
      "total": 0,
      "sample": []
    },
    "same_repository": {
      "repository_url": "https://github.com/pdfops/pdfops-mcp",
      "total": 0,
      "sample": []
    },
    "note": "Shared addresses on big platforms (Cloudflare, Vercel and the like) put unrelated servers together; those are marked shared_infrastructure. A match is a pivot, not a link between operators."
  },
  "endpoint": {
    "id": "20488",
    "server_name": "dev.pdfops/pdfops-mcp",
    "url": "https://pdfops.dev/api/mcp",
    "host": "pdfops.dev",
    "transport": "streamable-http",
    "last_checked_at": "2026-11-22T17:32:02.483Z",
    "last_state": "listed",
    "last_detail": null,
    "consecutive_failures": 0,
    "current_sha": "a5ef521b6692a74d0d648a2bd649d8072b875131fee9d69522d02fe21e3dc17d",
    "first_listed_at": "2026-11-21T12:31:01.258Z",
    "created_at": "2026-11-21T07:25:09.278Z",
    "resolved_addresses": [
      "216.150.1.129",
      "216.150.16.129"
    ]
  },
  "server": {
    "name": "dev.pdfops/pdfops-mcp",
    "title": null,
    "description": "PDF tools for AI agents: fill, merge, edit, read text and tables, create, protect and invoice PDFs.",
    "version": "0.5.0",
    "registry_status": "active",
    "repository_url": "https://github.com/pdfops/pdfops-mcp",
    "website_url": "https://pdfops.dev",
    "published_at": "2026-11-22T04:36:05.921Z",
    "updated_at": "2026-11-22T04:36:05.921Z",
    "first_seen": "2026-11-21T07:25:08.647Z"
  },
  "other_endpoints": [],
  "intel": {
    "capabilities": [],
    "evm_addresses": [],
    "chains": [],
    "tokens": [],
    "computed_at": "2026-11-22T17:32:06.915Z"
  },
  "operator": {
    "key": "pdfops.dev",
    "name": "pdfops.dev",
    "platform": false
  },
  "needs_sign_in": false,
  "reachability": {
    "window_days": 30,
    "checks": 2,
    "answered": 2,
    "answered_percent": 100,
    "avg_listing_latency_ms": 716,
    "first_check_in_window": "2026-11-21T12:31:01.258Z",
    "consecutive_failures_now": 0,
    "days": [
      {
        "day": "2026-11-21",
        "checks": 1,
        "answered": 1,
        "last_state": "listed"
      },
      {
        "day": "2026-11-22",
        "checks": 1,
        "answered": 1,
        "last_state": "listed"
      }
    ]
  },
  "tool_list": {
    "sha256": "a5ef521b6692a74d0d648a2bd649d8072b875131fee9d69522d02fe21e3dc17d",
    "tools": 23,
    "resources": 0,
    "prompts": 0,
    "first_seen": "2026-11-22T17:32:03.380Z",
    "tool_names": [
      "pdf_inspect",
      "pdf_fill",
      "pdf_merge",
      "pdf_invoice",
      "pdfops_usage",
      "pdf_extract_pages",
      "pdf_delete_pages",
      "pdf_rotate",
      "pdf_split",
      "pdf_watermark",
      "pdf_page_numbers",
      "pdf_unlock",
      "pdf_protect",
      "pdf_metadata",
      "pdf_set_metadata",
      "pdf_edit",
      "pdf_extract_text",
      "pdf_text_to_pdf",
      "pdf_find_text",
      "pdf_add_fields",
      "pdf_image_to_pdf",
      "pdf_add_attachment",
      "pdf_html_to_pdf"
    ],
    "declared": {
      "tools": [
        {
          "name": "pdf_inspect",
          "title": "Inspect PDF form fields",
          "description": "List a PDF's AcroForm form fields — names, types, options, current values, per-field maxLength where declared — plus a paste-ready fillTemplate object for pdf_fill and a hasXFA flag (hybrid AcroForm/XFA inputs lose their XFA layer when filled). A PDF with no fillable form returns count 0. Read-only: the PDF is fetched but never modified. Call this FIRST when filling an unfamiliar PDF, since pdf_fill rejects unknown field names and over-length values.",
          "inputSchema": {
            "type": "object",
            "required": [
              "pdf_path"
            ],
            "properties": {
              "password": {
                "type": "string",
                "description": "Password to open the input, only needed for a user-password PDF (owner-locked files with an empty user password open without it)."
              },
              "pdf_path": {
                "type": "string",
                "description": "PDF source: an https:// URL or a data:application/pdf;base64,… URI (this hosted server cannot read local file paths)."
              }
            },
            "additionalProperties": false
          },
          "outputSchema": {
            "type": "object",
            "required": [
              "count",
              "hasXFA",
              "truncated",
              "fields",
              "fillTemplate"
            ],
            "properties": {
              "count": {
                "type": "integer",
                "description": "Number of form fields found; 0 when the PDF has no fillable form"
              },
              "fields": {
                "type": "array",
                "items": {
                  "type": "object",
                  "required": [
                    "name",
                    "type",
                    "readOnly"
                  ],
                  "properties": {
                    "raw": {},
                    "name": {
                      "type": "string"
                    },
                    "type": {
                      "type": "string",
                      "description": "text, checkbox, dropdown, radio, optionlist, or unsupported"
                    },
                    "label": {
                      "type": "string",
                      "description": "Alternate (tooltip) name, only when the form declares one; pdf_fill also accepts it as a field key"
                    },
                    "value": {
                      "type": "string"
                    },
                    "checked": {
                      "type": "boolean"
                    },
                    "options": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      },
                      "description": "Permitted values for radio/dropdown/optionlist fields"
                    },
                    "readOnly": {
                      "type": "boolean"
                    },
                    "maxLength": {
                      "type": "integer",
                      "description": "Longer values are rejected by pdf_fill"
                    }
                  },
                  "additionalProperties": false
                },
                "description": "One entry per form field, in document order"
              },
              "hasXFA": {
                "type": "boolean",
                "description": "True for hybrid AcroForm/XFA documents, whose XFA layer is dropped when filled"
              },
              "truncated": {
                "type": "boolean",
                "description": "True when the form exceeded an API enumeration cap; fields is then a prefix, not the full list"
              },
              "fillTemplate": {
                "type": "object",
                "description": "Field name to empty-or-current value, ready to edit and pass to pdf_fill",
                "additionalProperties": {
                  "type": "string"
                }
              }
            },
            "additionalProperties": false
          },
          "annotations": {
            "readOnlyHint": true,
            "openWorldHint": true,
            "idempotentHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "pdf_fill",
          "title": "Fill PDF form",
          "description": "Fill AcroForm form fields in a PDF and return the result. Field names must exist in the PDF (use pdf_inspect first). All values are strings; checkboxes take \"true\"/\"false\"; dropdown/radio/optionlist values must be one of the field's options; text values must respect the field's maxLength from pdf_inspect. The source PDF is never modified. Returns the filled PDF inline as an application/pdf resource. Owner-locked PDFs (empty user password, common for government blanks) fill without a password; a user-password PDF needs the password parameter, otherwise it is rejected with encrypted_pdf.",
          "inputSchema": {
            "type": "object",
            "required": [
              "pdf_path",
              "fields"
            ],
            "properties": {
              "fields": {
                "type": "object",
                "description": "Field name → string value (from pdf_inspect's fillTemplate)",
                "additionalProperties": {
                  "type": "string"
                }
              },
              "flatten": {
                "type": "boolean",
                "description": "Bake values into page content and drop the AcroForm so fields are no longer editable"
              },
              "password": {
                "type": "string",
                "description": "Password to open the input, only needed for a user-password PDF (owner-locked files with an empty user password open without it)."
              },
              "pdf_path": {
                "type": "string",
                "description": "Template PDF source: an https:// URL or a data:application/pdf;base64,… URI (this hosted server cannot read local file paths)."
              }
            },
            "additionalProperties": false
          },
          "outputSchema": {
            "type": "object",
            "required": [
              "bytes"
            ],
            "properties": {
              "bytes": {
                "type": "integer",
                "description": "Size of the produced PDF in bytes"
              },
              "warning": {
                "type": "string",
                "description": "Present as xfa-layer-dropped when a hybrid AcroForm/XFA input lost its XFA layer"
              },
              "field_map": {
                "type": "object",
                "description": "Present only when a key was matched forgivingly: {provided key: actual field name}. Exact-name keys are omitted",
                "additionalProperties": {
                  "type": "string"
                }
              },
              "resource_uri": {
                "type": "string",
                "description": "pdfops:// uri of the inline application/pdf resource"
              }
            },
            "additionalProperties": false
          },
          "annotations": {
            "readOnlyHint": false,
            "openWorldHint": true,
            "idempotentHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "pdf_merge",
          "title": "Merge PDFs",
          "description": "Merge two or more PDFs into one, in the order given, and return the result. JPG and PNG images are accepted among the sources and each becomes one page the size of the image (use pdf_image_to_pdf for A4 or Letter pages, margins and more options); the type is read from the bytes. Sources are read only and never modified. Returns the merged PDF inline as an application/pdf resource. This tool only concatenates whole documents: it does not reorder, rotate or delete pages within them, and it does not fill forms — use pdf_fill for a fillable form and pdf_invoice to build a document from data. An unreadable or rejected input fails with an error, so a partial merge is never returned.",
          "inputSchema": {
            "type": "object",
            "required": [
              "pdf_paths"
            ],
            "properties": {
              "password": {
                "type": "string",
                "description": "Password to open the input, only needed for a user-password PDF (owner-locked files with an empty user password open without it). Applies to every input."
              },
              "pdf_paths": {
                "type": "array",
                "items": {
                  "type": "string"
                },
                "minItems": 2,
                "description": "In order, each a PDF or a JPG or PNG image source: an https:// URL or a data:application/pdf;base64,… (or data:image/jpeg;base64,… / data:image/png;base64,…) URI (this hosted server cannot read local file paths). An image becomes one page."
              }
            },
            "additionalProperties": false
          },
          "outputSchema": {
            "type": "object",
            "required": [
              "bytes"
            ],
            "properties": {
              "bytes": {
                "type": "integer",
                "description": "Size of the produced PDF in bytes"
              },
              "resource_uri": {
                "type": "string",
                "description": "pdfops:// uri of the inline application/pdf resource"
              }
            },
            "additionalProperties": false
          },
          "annotations": {
            "readOnlyHint": false,
            "openWorldHint": true,
            "idempotentHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "pdf_invoice",
          "title": "Generate invoice PDF",
          "description": "Generate a complete, professionally laid-out invoice PDF from structured data — no template needed. Deterministic: the same input produces byte-identical output (safe to re-run). Note: without a paid PDFops key the output carries a small \"Generated with pdfops.dev\" footer line. Returns the invoice inline as an application/pdf resource. Use this when you have invoice DATA and no document; if you already have an invoice PDF or a fillable template to populate, use pdf_fill instead. Set invoice.e_invoice to \"factur-x\" to produce an e-invoice instead: a PDF/A-3 file with the invoice data embedded as factur-x.xml (UN/CEFACT Cross Industry Invoice, profile EN 16931, also called COMFORT). Several more fields then become required, and a missing one fails with einvoice_fields_required naming every missing field: invoice_number, date, currency (no default), due or payment_terms, from.country and to.country (ISO 3166-1 alpha-2 codes), from.vat_id (or from.tax_id with from.registration_id), tax_category when tax_rate is 0, and a UN/ECE Recommendation 20 unit code on every item. Amounts in the XML and on the page come from the same exact decimal arithmetic: each line is rounded to 2 decimals, VAT is computed once on the summed basis. On that path text is limited to Latin letters, Latin Extended-A, the euro sign and common punctuation (other characters fail with unrenderable_text); leading and trailing whitespace is trimmed, over-long or control-character text is refused with a 400, and long text wraps onto further lines or pages on the page and is carried in full in the XML. Per-item tax fields and other unknown fields are refused, and a buyer tax_id is refused (use to.vat_id). Checked in testing with the Mustang validator 2.26.0 (PDF/A-3 via veraPDF, XSD, EN 16931 schematron); this is not a statement of legal compliance, and XRechnung and Peppol output are not produced.",
          "inputSchema": {
            "type": "object",
            "required": [
              "invoice"
            ],
            "properties": {
              "invoice": {
                "type": "object",
                "required": [
                  "from",
                  "to",
                  "items"
                ],
                "properties": {
                  "to": {
                    "anyOf": [
                      {
                        "type": "string"
                      },
                      {
                        "type": "object",
                        "required": [
                          "name"
                        ],
                        "properties": {
                          "city": {
                            "type": "string",
                            "maxLength": 35
                          },
                          "name": {
                            "type": "string"
                          },
                          "lines": {
                            "type": "array",
                            "items": {
                              "type": "string"
                            }
                          },
                          "street": {
                            "type": "string",
                            "maxLength": 200
                          },
                          "tax_id": {
                            "type": "string",
                            "maxLength": 35,
                            "description": "National tax number. With e_invoice it is accepted for the seller only: EN 16931 has no buyer tax number, so to.tax_id is refused (use to.vat_id)."
                          },
                          "vat_id": {
                            "type": "string",
                            "maxLength": 35,
                            "description": "VAT identification number. With e_invoice it must start with a two-letter capital country prefix, such as DE123456789 (EL for Greece), and the seller needs vat_id, or tax_id plus registration_id."
                          },
                          "country": {
                            "type": "string",
                            "pattern": "^([A-Z]{2}|1A)$",
                            "description": "ISO 3166-1 alpha-2 country code in capitals (1A for Kosovo, as in the EN 16931 list). Required when e_invoice is set."
                          },
                          "postcode": {
                            "type": "string",
                            "maxLength": 35
                          },
                          "registration_id": {
                            "type": "string",
                            "maxLength": 35,
                            "description": "Legal registration number, for example a commercial register number."
                          }
                        },
                        "additionalProperties": false
                      }
                    ]
                  },
                  "due": {
                    "type": "string",
                    "description": "Shown as given. With e_invoice it must be a calendar date in YYYY-MM-DD form."
                  },
                  "date": {
                    "type": "string",
                    "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
                    "description": "Calendar date in YYYY-MM-DD form (other formats are rejected with invalid_date). Shown on the invoice; also pins metadata for determinism"
                  },
                  "from": {
                    "anyOf": [
                      {
                        "type": "string"
                      },
                      {
                        "type": "object",
                        "required": [
                          "name"
                        ],
                        "properties": {
                          "city": {
                            "type": "string",
                            "maxLength": 35
                          },
                          "name": {
                            "type": "string"
                          },
                          "lines": {
                            "type": "array",
                            "items": {
                              "type": "string"
                            }
                          },
                          "street": {
                            "type": "string",
                            "maxLength": 200
                          },
                          "tax_id": {
                            "type": "string",
                            "maxLength": 35,
                            "description": "National tax number. With e_invoice it is accepted for the seller only: EN 16931 has no buyer tax number, so to.tax_id is refused (use to.vat_id)."
                          },
                          "vat_id": {
                            "type": "string",
                            "maxLength": 35,
                            "description": "VAT identification number. With e_invoice it must start with a two-letter capital country prefix, such as DE123456789 (EL for Greece), and the seller needs vat_id, or tax_id plus registration_id."
                          },
                          "country": {
                            "type": "string",
                            "pattern": "^([A-Z]{2}|1A)$",
                            "description": "ISO 3166-1 alpha-2 country code in capitals (1A for Kosovo, as in the EN 16931 list). Required when e_invoice is set."
                          },
                          "postcode": {
                            "type": "string",
                            "maxLength": 35
                          },
                          "registration_id": {
                            "type": "string",
                            "maxLength": 35,
                            "description": "Legal registration number, for example a commercial register number."
                          }
                        },
                        "additionalProperties": false
                      }
                    ]
                  },
                  "iban": {
                    "type": "string",
                    "description": "IBAN to pay into; the checksum is verified. Used only with e_invoice: written as SEPA credit transfer (code 58) for a EUR invoice and a SEPA-area IBAN, otherwise as credit transfer (code 30)."
                  },
                  "items": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "required": [
                        "description",
                        "unit_price"
                      ],
                      "properties": {
                        "unit": {
                          "type": "string",
                          "maxLength": 3,
                          "description": "UN/ECE Recommendation 20 unit code, for example C62 (one), HUR (hour), KGM (kilogram). Required when e_invoice is set."
                        },
                        "quantity": {
                          "type": "number",
                          "exclusiveMinimum": 0
                        },
                        "unit_price": {
                          "type": "number",
                          "minimum": 0
                        },
                        "description": {
                          "type": "string"
                        }
                      },
                      "additionalProperties": false
                    },
                    "maxItems": 100,
                    "minItems": 1
                  },
                  "notes": {
                    "type": "string",
                    "maxLength": 1000
                  },
                  "currency": {
                    "type": "string",
                    "pattern": "^[A-Z]{3}$"
                  },
                  "tax_rate": {
                    "type": "number",
                    "maximum": 100,
                    "minimum": 0
                  },
                  "e_invoice": {
                    "enum": [
                      "factur-x"
                    ],
                    "type": "string",
                    "description": "Produce a Factur-X (ZUGFeRD) EN 16931 e-invoice: PDF/A-3 with factur-x.xml embedded. Makes several fields required, see the tool description."
                  },
                  "tax_category": {
                    "enum": [
                      "S",
                      "Z",
                      "E",
                      "AE",
                      "O"
                    ],
                    "type": "string",
                    "description": "EN 16931 VAT category: S standard rate (the default when tax_rate is above 0), Z zero rate, E exempt, AE reverse charge, O not subject to VAT. Required with e_invoice when tax_rate is 0 or omitted. Ignored without e_invoice."
                  },
                  "payment_terms": {
                    "type": "string",
                    "maxLength": 200,
                    "description": "Payment terms text. With e_invoice, either this or a due date is required."
                  },
                  "invoice_number": {
                    "type": "string"
                  },
                  "tax_exemption_reason": {
                    "type": "string",
                    "maxLength": 200,
                    "description": "Reason text, required with e_invoice for tax_category E, AE and O."
                  }
                },
                "description": "Invoice data",
                "additionalProperties": false
              }
            },
            "additionalProperties": false
          },
          "outputSchema": {
            "type": "object",
            "required": [
              "bytes"
            ],
            "properties": {
              "bytes": {
                "type": "integer",
                "description": "Size of the produced PDF in bytes"
              },
              "resource_uri": {
                "type": "string",
                "description": "pdfops:// uri of the inline application/pdf resource"
              }
            },
            "additionalProperties": false
          },
          "annotations": {
            "readOnlyHint": false,
            "openWorldHint": true,
            "idempotentHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "pdfops_usage",
          "title": "Check PDFops quota",
          "description": "Check the current PDFops API quota for the configured key: tier, limit, used, remaining, the billing period, and the reset timestamp. Read-only and safe to call before a batch to confirm there is headroom. Uses the API key this connection authenticated with.",
          "inputSchema": {
            "type": "object",
            "properties": {}
          },
          "outputSchema": {
            "type": "object",
            "required": [
              "tier",
              "limit",
              "used",
              "remaining",
              "period",
              "resets_at"
            ],
            "properties": {
              "tier": {
                "type": "string",
                "description": "Plan name, e.g. free"
              },
              "used": {
                "type": "integer"
              },
              "limit": {
                "type": "integer",
                "description": "Calls allowed in the current period"
              },
              "period": {
                "type": "string",
                "description": "Billing period the counts belong to, YYYY-MM"
              },
              "remaining": {
                "type": "integer"
              },
              "resets_at": {
                "type": "string",
                "description": "ISO 8601 timestamp when used resets to 0"
              }
            },
            "additionalProperties": false
          },
          "annotations": {
            "readOnlyHint": true,
            "openWorldHint": true,
            "idempotentHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "pdf_extract_pages",
          "title": "Extract pages from PDF",
          "description": "Keep only the listed pages of a PDF, in the order given, and return them as a new PDF. Because order follows the spec, it also reorders pages (\"3,1,2\") and can duplicate them. Use this to pull a section out of a document; use pdf_delete_pages to remove pages instead, pdf_split for several output files, and pdf_merge to join documents. Returns the result inline as an application/pdf resource; the source is never modified. Fails with invalid_pages if a page is out of range.",
          "inputSchema": {
            "type": "object",
            "required": [
              "pdf_path",
              "pages"
            ],
            "properties": {
              "pages": {
                "type": "string",
                "description": "1-based page spec, e.g. \"1-3,5,8-\" (open-ended range runs to the last page)"
              },
              "password": {
                "type": "string",
                "description": "Password to open the input, only needed for a user-password PDF (owner-locked files with an empty user password open without it)."
              },
              "pdf_path": {
                "type": "string",
                "description": "PDF source: an https:// URL or a data:application/pdf;base64,… URI (this hosted server cannot read local file paths)."
              }
            },
            "additionalProperties": false
          },
          "outputSchema": {
            "type": "object",
            "required": [
              "bytes"
            ],
            "properties": {
              "bytes": {
                "type": "integer",
                "description": "Size of the produced PDF in bytes"
              },
              "resource_uri": {
                "type": "string",
                "description": "pdfops:// uri of the inline application/pdf resource"
              }
            },
            "additionalProperties": false
          },
          "annotations": {
            "readOnlyHint": false,
            "openWorldHint": true,
            "idempotentHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "pdf_delete_pages",
          "title": "Delete pages from PDF",
          "description": "Remove the listed pages from a PDF and return the remaining pages in their original order. Use this to drop a cover, blank or sensitive pages; use pdf_extract_pages when it is easier to name the pages to keep. Returns the result inline as an application/pdf resource; the source is never modified. Deleting every page fails with no_pages_left.",
          "inputSchema": {
            "type": "object",
            "required": [
              "pdf_path",
              "pages"
            ],
            "properties": {
              "pages": {
                "type": "string",
                "description": "1-based pages to REMOVE, e.g. \"2,4-6,9-\""
              },
              "password": {
                "type": "string",
                "description": "Password to open the input, only needed for a user-password PDF (owner-locked files with an empty user password open without it)."
              },
              "pdf_path": {
                "type": "string",
                "description": "PDF source: an https:// URL or a data:application/pdf;base64,… URI (this hosted server cannot read local file paths)."
              }
            },
            "additionalProperties": false
          },
          "outputSchema": {
            "type": "object",
            "required": [
              "bytes"
            ],
            "properties": {
              "bytes": {
                "type": "integer",
                "description": "Size of the produced PDF in bytes"
              },
              "resource_uri": {
                "type": "string",
                "description": "pdfops:// uri of the inline application/pdf resource"
              }
            },
            "additionalProperties": false
          },
          "annotations": {
            "readOnlyHint": false,
            "openWorldHint": true,
            "idempotentHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "pdf_rotate",
          "title": "Rotate PDF pages",
          "description": "Rotate pages of a PDF clockwise by 90, 180 or 270 degrees (or -90). Rotation adds to each page's existing rotation. Omit pages to rotate every page. Use this to fix sideways scans. Returns the result inline as an application/pdf resource; the source is never modified.",
          "inputSchema": {
            "type": "object",
            "required": [
              "pdf_path",
              "degrees"
            ],
            "properties": {
              "pages": {
                "type": "string",
                "description": "1-based page spec such as \"1-3,5\"; default all pages"
              },
              "degrees": {
                "enum": [
                  90,
                  180,
                  270,
                  -90
                ],
                "type": "integer",
                "description": "Clockwise rotation to add"
              },
              "password": {
                "type": "string",
                "description": "Password to open the input, only needed for a user-password PDF (owner-locked files with an empty user password open without it)."
              },
              "pdf_path": {
                "type": "string",
                "description": "PDF source: an https:// URL or a data:application/pdf;base64,… URI (this hosted server cannot read local file paths)."
              }
            },
            "additionalProperties": false
          },
          "outputSchema": {
            "type": "object",
            "required": [
              "bytes"
            ],
            "properties": {
              "bytes": {
                "type": "integer",
                "description": "Size of the produced PDF in bytes"
              },
              "resource_uri": {
                "type": "string",
                "description": "pdfops:// uri of the inline application/pdf resource"
              }
            },
            "additionalProperties": false
          },
          "annotations": {
            "readOnlyHint": false,
            "openWorldHint": true,
            "idempotentHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "pdf_split",
          "title": "Split PDF into parts",
          "description": "Split one PDF into several PDFs, either by explicit ranges (each comma group becomes one part: \"1-2,3-5\" gives two parts) or into fixed-size chunks (every=2 on 5 pages gives 1-2, 3-4, 5). Give exactly one of ranges or every. Returns each part inline as an application/pdf resource plus a structured parts list (pages, page_count, bytes, resource_uri). Limited to 100 parts and about 4 MB of total output; use pdf_extract_pages for a single range.",
          "inputSchema": {
            "type": "object",
            "required": [
              "pdf_path"
            ],
            "properties": {
              "every": {
                "type": "integer",
                "minimum": 1,
                "description": "Chunk size in pages; the last part may be shorter"
              },
              "ranges": {
                "type": "string",
                "description": "1-based page spec; each comma group becomes one part, e.g. \"1-2,3-5\""
              },
              "password": {
                "type": "string",
                "description": "Password to open the input, only needed for a user-password PDF (owner-locked files with an empty user password open without it)."
              },
              "pdf_path": {
                "type": "string",
                "description": "PDF source: an https:// URL or a data:application/pdf;base64,… URI (this hosted server cannot read local file paths)."
              }
            },
            "additionalProperties": false
          },
          "outputSchema": {
            "type": "object",
            "required": [
              "count",
              "parts"
            ],
            "properties": {
              "count": {
                "type": "integer",
                "description": "Number of parts produced"
              },
              "parts": {
                "type": "array",
                "items": {
                  "type": "object",
                  "required": [
                    "pages",
                    "page_count",
                    "bytes",
                    "resource_uri"
                  ],
                  "properties": {
                    "bytes": {
                      "type": "integer"
                    },
                    "pages": {
                      "type": "string"
                    },
                    "page_count": {
                      "type": "integer"
                    },
                    "resource_uri": {
                      "type": "string",
                      "description": "pdfops:// uri of this part's inline application/pdf resource"
                    }
                  },
                  "additionalProperties": false
                }
              }
            },
            "additionalProperties": false
          },
          "annotations": {
            "readOnlyHint": false,
            "openWorldHint": true,
            "idempotentHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "pdf_watermark",
          "title": "Add text watermark to PDF",
          "description": "Stamp a diagonal text watermark on pages of a PDF (default: centered, 45 degrees, grey, 15% opacity). Text is upright and centered for any page size or existing page rotation. Standard Helvetica only: characters outside WinAnsi (e.g. CJK, emoji) fail with unsupported_characters. Use this for DRAFT / CONFIDENTIAL stamps; use pdf_page_numbers for numbering. Returns the result inline as an application/pdf resource; the source is never modified.",
          "inputSchema": {
            "type": "object",
            "required": [
              "pdf_path",
              "text"
            ],
            "properties": {
              "size": {
                "type": "number",
                "maximum": 200,
                "minimum": 6,
                "description": "Font size in points, default 48"
              },
              "text": {
                "type": "string",
                "maxLength": 200,
                "description": "Watermark text, WinAnsi characters only"
              },
              "color": {
                "type": "string",
                "description": "Hex #rgb or #rrggbb, default #808080"
              },
              "pages": {
                "type": "string",
                "description": "1-based page spec such as \"1-3,5\"; default all pages"
              },
              "opacity": {
                "type": "number",
                "maximum": 1,
                "minimum": 0.05,
                "description": "Default 0.15"
              },
              "password": {
                "type": "string",
                "description": "Password to open the input, only needed for a user-password PDF (owner-locked files with an empty user password open without it)."
              },
              "pdf_path": {
                "type": "string",
                "description": "PDF source: an https:// URL or a data:application/pdf;base64,… URI (this hosted server cannot read local file paths)."
              },
              "position": {
                "enum": [
                  "center",
                  "top",
                  "bottom"
                ],
                "type": "string",
                "description": "Default center"
              },
              "rotation": {
                "type": "number",
                "description": "Degrees counter-clockwise as the viewer sees it, default 45"
              }
            },
            "additionalProperties": false
          },
          "outputSchema": {
            "type": "object",
            "required": [
              "bytes"
            ],
            "properties": {
              "bytes": {
                "type": "integer",
                "description": "Size of the produced PDF in bytes"
              },
              "resource_uri": {
                "type": "string",
                "description": "pdfops:// uri of the inline application/pdf resource"
              }
            },
            "additionalProperties": false
          },
          "annotations": {
            "readOnlyHint": false,
            "openWorldHint": true,
            "idempotentHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "pdf_page_numbers",
          "title": "Add page numbers to PDF",
          "description": "Print page numbers on a PDF using a format template with {n} (page number) and {total} (page count), e.g. \"Page {n} of {total}\". Default is \"{n} / {total}\" at bottom-center, 10 pt. Numbers sit upright for any page size or rotation. Standard Helvetica only (WinAnsi characters). Page i always shows start+i-1 even when pages selects only some pages. Returns the result inline as an application/pdf resource; the source is never modified.",
          "inputSchema": {
            "type": "object",
            "required": [
              "pdf_path"
            ],
            "properties": {
              "size": {
                "type": "number",
                "maximum": 72,
                "minimum": 4,
                "description": "Font size in points, default 10"
              },
              "pages": {
                "type": "string",
                "description": "1-based page spec such as \"1-3,5\"; default all pages"
              },
              "start": {
                "type": "integer",
                "maximum": 100000,
                "minimum": 0,
                "description": "Number shown on page 1, default 1"
              },
              "format": {
                "type": "string",
                "maxLength": 100,
                "description": "Template with {n} and {total}, default \"{n} / {total}\""
              },
              "margin": {
                "type": "number",
                "maximum": 200,
                "minimum": 0,
                "description": "Distance in points from the page edge, default 24"
              },
              "password": {
                "type": "string",
                "description": "Password to open the input, only needed for a user-password PDF (owner-locked files with an empty user password open without it)."
              },
              "pdf_path": {
                "type": "string",
                "description": "PDF source: an https:// URL or a data:application/pdf;base64,… URI (this hosted server cannot read local file paths)."
              },
              "position": {
                "enum": [
                  "bottom-center",
                  "bottom-right",
                  "bottom-left",
                  "top-center",
                  "top-right",
                  "top-left"
                ],
                "type": "string",
                "description": "Default bottom-center"
              }
            },
            "additionalProperties": false
          },
          "outputSchema": {
            "type": "object",
            "required": [
              "bytes"
            ],
            "properties": {
              "bytes": {
                "type": "integer",
                "description": "Size of the produced PDF in bytes"
              },
              "resource_uri": {
                "type": "string",
                "description": "pdfops:// uri of the inline application/pdf resource"
              }
            },
            "additionalProperties": false
          },
          "annotations": {
            "readOnlyHint": false,
            "openWorldHint": true,
            "idempotentHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "pdf_unlock",
          "title": "Remove PDF restrictions",
          "description": "Save a PDF without encryption so print/copy/modify restrictions are gone. Works for owner-locked files (empty user password) with no password, and for user-password files when you pass the password. It does NOT crack unknown passwords: a wrong or missing user password fails with encrypted_pdf. A PDF that was not encrypted is returned re-saved, with note \"not-encrypted\". Returns the result inline as an application/pdf resource; the source is never modified.",
          "inputSchema": {
            "type": "object",
            "required": [
              "pdf_path"
            ],
            "properties": {
              "password": {
                "type": "string",
                "description": "Password to open the input, only needed for a user-password PDF (owner-locked files with an empty user password open without it)."
              },
              "pdf_path": {
                "type": "string",
                "description": "PDF source: an https:// URL or a data:application/pdf;base64,… URI (this hosted server cannot read local file paths)."
              }
            },
            "additionalProperties": false
          },
          "outputSchema": {
            "type": "object",
            "required": [
              "bytes"
            ],
            "properties": {
              "note": {
                "type": "string",
                "description": "Present as \"not-encrypted\" when the input had no encryption"
              },
              "bytes": {
                "type": "integer",
                "description": "Size of the produced PDF in bytes"
              },
              "resource_uri": {
                "type": "string",
                "description": "pdfops:// uri of the inline application/pdf resource"
              }
            },
            "additionalProperties": false
          },
          "annotations": {
            "readOnlyHint": false,
            "openWorldHint": true,
            "idempotentHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "pdf_protect",
          "title": "Password-protect PDF",
          "description": "Encrypt a PDF with a password. user_password is required to open the result; owner_password lifts the permission restrictions. Give at least one (each 1 to 32 Latin-1 chars). permissions lists what stays ALLOWED from print, copy, modify, annotate, fill-forms (default all, except modify when an owner password is set; an empty list allows none). Restrictions only bind viewers when an owner password is set. Not byte-deterministic (random salts). Returns the result inline as an application/pdf resource; the source is never modified.",
          "inputSchema": {
            "type": "object",
            "required": [
              "pdf_path"
            ],
            "properties": {
              "password": {
                "type": "string",
                "description": "Password to open the input, only needed for a user-password PDF (owner-locked files with an empty user password open without it)."
              },
              "pdf_path": {
                "type": "string",
                "description": "PDF source: an https:// URL or a data:application/pdf;base64,… URI (this hosted server cannot read local file paths)."
              },
              "permissions": {
                "type": "array",
                "items": {
                  "enum": [
                    "print",
                    "copy",
                    "modify",
                    "annotate",
                    "fill-forms"
                  ],
                  "type": "string"
                },
                "description": "Actions to ALLOW; omit for the default, [] for none"
              },
              "user_password": {
                "type": "string",
                "maxLength": 128,
                "description": "Password required to open the output"
              },
              "owner_password": {
                "type": "string",
                "maxLength": 128,
                "description": "Password that lifts the restrictions"
              }
            },
            "additionalProperties": false
          },
          "outputSchema": {
            "type": "object",
            "required": [
              "bytes"
            ],
            "properties": {
              "bytes": {
                "type": "integer",
                "description": "Size of the produced PDF in bytes"
              },
              "resource_uri": {
                "type": "string",
                "description": "pdfops:// uri of the inline application/pdf resource"
              }
            },
            "additionalProperties": false
          },
          "annotations": {
            "readOnlyHint": false,
            "openWorldHint": true,
            "idempotentHint": false,
            "destructiveHint": false
          }
        },
        {
          "name": "pdf_metadata",
          "title": "Read PDF metadata",
          "description": "Read a PDF's document info: page_count, per-page width/height (points) and rotation, title, author, subject, keywords, creator, producer, creation_date, modification_date (ISO 8601, null when absent), whether it was encrypted, and has_form / form_field_count. Call this to learn a document's size and shape before splitting, rotating or filling. Read-only: the PDF is fetched but never modified.",
          "inputSchema": {
            "type": "object",
            "required": [
              "pdf_path"
            ],
            "properties": {
              "password": {
                "type": "string",
                "description": "Password to open the input, only needed for a user-password PDF (owner-locked files with an empty user password open without it)."
              },
              "pdf_path": {
                "type": "string",
                "description": "PDF source: an https:// URL or a data:application/pdf;base64,… URI (this hosted server cannot read local file paths)."
              }
            },
            "additionalProperties": false
          },
          "outputSchema": {
            "type": "object",
            "required": [
              "page_count",
              "pages",
              "encrypted",
              "has_form",
              "form_field_count"
            ],
            "properties": {
              "pages": {
                "type": "array",
                "items": {
                  "type": "object",
                  "required": [
                    "width",
                    "height",
                    "rotation"
                  ],
                  "properties": {
                    "width": {
                      "type": "number"
                    },
                    "height": {
                      "type": "number"
                    },
                    "rotation": {
                      "type": "number"
                    }
                  },
                  "additionalProperties": false
                }
              },
              "title": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "author": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "creator": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "subject": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "has_form": {
                "type": "boolean"
              },
              "keywords": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "producer": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "encrypted": {
                "type": "boolean"
              },
              "page_count": {
                "type": "integer"
              },
              "creation_date": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "form_field_count": {
                "type": "integer"
              },
              "modification_date": {
                "type": [
                  "string",
                  "null"
                ]
              }
            },
            "additionalProperties": true
          },
          "annotations": {
            "readOnlyHint": true,
            "openWorldHint": true,
            "idempotentHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "pdf_set_metadata",
          "title": "Set PDF metadata",
          "description": "Write document info fields (title, author, subject, creator, keywords) into a PDF. Give at least one; an empty string sets an empty value. Unicode is fine. Keywords may be a list or a comma-separated string. The output is saved unencrypted. Use pdf_metadata to read the current values. Returns the result inline as an application/pdf resource; the source is never modified.",
          "inputSchema": {
            "type": "object",
            "required": [
              "pdf_path"
            ],
            "properties": {
              "title": {
                "type": "string",
                "maxLength": 1000
              },
              "author": {
                "type": "string",
                "maxLength": 1000
              },
              "creator": {
                "type": "string",
                "maxLength": 1000
              },
              "subject": {
                "type": "string",
                "maxLength": 1000
              },
              "keywords": {
                "anyOf": [
                  {
                    "type": "string"
                  },
                  {
                    "type": "array",
                    "items": {
                      "type": "string"
                    }
                  }
                ],
                "description": "Comma-separated string or list of keywords"
              },
              "password": {
                "type": "string",
                "description": "Password to open the input, only needed for a user-password PDF (owner-locked files with an empty user password open without it)."
              },
              "pdf_path": {
                "type": "string",
                "description": "PDF source: an https:// URL or a data:application/pdf;base64,… URI (this hosted server cannot read local file paths)."
              }
            },
            "additionalProperties": false
          },
          "outputSchema": {
            "type": "object",
            "required": [
              "bytes"
            ],
            "properties": {
              "bytes": {
                "type": "integer",
                "description": "Size of the produced PDF in bytes"
              },
              "resource_uri": {
                "type": "string",
                "description": "pdfops:// uri of the inline application/pdf resource"
              }
            },
            "additionalProperties": false
          },
          "annotations": {
            "readOnlyHint": false,
            "openWorldHint": true,
            "idempotentHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "pdf_edit",
          "title": "Add text, images, a signature or a barcode/QR code to a PDF",
          "description": "Stamp text and images (logos, signature images, photos) onto specific pages of an existing PDF at exact positions. Coordinates are PDF points measured from the bottom-left corner of the page as the viewer sees it (1 inch = 72 pt; US Letter is 612 x 792), so stamps land upright on any page size or rotation. Text uses standard fonts (WinAnsi characters only: CJK and emoji fail with unsupported_characters) and can wrap to max_width. Images are PNG or JPEG, up to 2 MB each and 10 distinct images per call (the PDF and all images together must stay under 4.5 MB), given as an https:// URL or a data:image/png;base64,... URI. Barcodes (QR, Data Matrix, PDF417, Aztec, Code 128, Code 39, EAN-13/8, UPC-A, ITF-14, Interleaved 2 of 5, GS1-128) are generated from a value and drawn as vector paths, so they scan at any print size (up to 25 per call). Use pdf_fill for fillable form fields and pdf_watermark for a diagonal stamp on every page. Returns the result inline as an application/pdf resource; the source is never modified.",
          "inputSchema": {
            "type": "object",
            "required": [
              "pdf_path",
              "items"
            ],
            "properties": {
              "items": {
                "type": "array",
                "items": {
                  "type": "object",
                  "required": [
                    "type",
                    "page",
                    "x",
                    "y"
                  ],
                  "properties": {
                    "x": {
                      "type": "number",
                      "description": "Points from the left edge. Text: left of the first line's baseline. Image or barcode: left edge."
                    },
                    "y": {
                      "type": "number",
                      "description": "Points from the bottom edge. Text: the first line's baseline. Image or barcode: bottom edge."
                    },
                    "font": {
                      "enum": [
                        "Helvetica",
                        "Helvetica-Bold",
                        "Helvetica-Oblique",
                        "Times-Roman",
                        "Times-Bold",
                        "Courier"
                      ],
                      "type": "string",
                      "description": "type=text: default Helvetica"
                    },
                    "page": {
                      "type": "integer",
                      "minimum": 1,
                      "description": "1-based page number"
                    },
                    "size": {
                      "type": "number",
                      "maximum": 200,
                      "minimum": 4,
                      "description": "type=text: font size in points, default 12"
                    },
                    "text": {
                      "type": "string",
                      "maxLength": 2000,
                      "minLength": 1,
                      "description": "type=text: the text; \\n starts a new line"
                    },
                    "type": {
                      "enum": [
                        "text",
                        "image",
                        "barcode"
                      ],
                      "type": "string"
                    },
                    "color": {
                      "type": "string",
                      "description": "type=text or barcode: hex #rgb or #rrggbb, default #000000"
                    },
                    "image": {
                      "type": "string",
                      "description": "type=image: PNG or JPEG as an https:// URL or a data:image/png;base64,… URI"
                    },
                    "value": {
                      "type": "string",
                      "maxLength": 3000,
                      "minLength": 1,
                      "description": "type=barcode: data to encode; format rules apply (ean13 = 12 or 13 digits, gs1-128 = bracketed AIs like (01)09506000134352)"
                    },
                    "width": {
                      "type": "number",
                      "minimum": 0.1,
                      "description": "type=image or barcode: width in points. Images and 2D codes: give only width or height to keep the aspect ratio (2D codes default to 72 pt). Linear codes: a missing side keeps 1 pt per module and 1 inch tall"
                    },
                    "format": {
                      "enum": [
                        "qrcode",
                        "datamatrix",
                        "pdf417",
                        "azteccode",
                        "code128",
                        "code39",
                        "ean13",
                        "ean8",
                        "upca",
                        "itf14",
                        "interleaved2of5",
                        "gs1-128"
                      ],
                      "type": "string",
                      "description": "type=barcode: symbology"
                    },
                    "height": {
                      "type": "number",
                      "minimum": 0.1,
                      "description": "type=image or barcode: height in points"
                    },
                    "opacity": {
                      "type": "number",
                      "maximum": 1,
                      "minimum": 0.05,
                      "description": "Default 1"
                    },
                    "rotation": {
                      "type": "number",
                      "maximum": 360,
                      "minimum": -360,
                      "description": "type=text: degrees counter-clockwise as the viewer sees it, default 0"
                    },
                    "max_width": {
                      "type": "number",
                      "minimum": 1,
                      "description": "type=text: wrap words to this width in points"
                    },
                    "background": {
                      "type": "string",
                      "description": "type=barcode: optional hex fill behind the symbol; no quiet zone is added, so leave a margin"
                    },
                    "line_height": {
                      "type": "number",
                      "maximum": 5,
                      "minimum": 0.5,
                      "description": "type=text: line spacing as a multiple of size, default 1.2"
                    },
                    "include_text": {
                      "type": "boolean",
                      "description": "type=barcode: print the human-readable value under linear codes, default false"
                    },
                    "error_correction": {
                      "enum": [
                        "L",
                        "M",
                        "Q",
                        "H"
                      ],
                      "type": "string",
                      "description": "type=barcode, qrcode only: error correction level, default M"
                    }
                  },
                  "additionalProperties": false
                },
                "maxItems": 100,
                "minItems": 1,
                "description": "Stamps to draw, in order (later items draw on top)."
              },
              "password": {
                "type": "string",
                "description": "Password to open the input, only needed for a user-password PDF (owner-locked files with an empty user password open without it)."
              },
              "pdf_path": {
                "type": "string",
                "description": "PDF source: an https:// URL or a data:application/pdf;base64,… URI (this hosted server cannot read local file paths)."
              }
            },
            "additionalProperties": false
          },
          "outputSchema": {
            "type": "object",
            "required": [
              "bytes"
            ],
            "properties": {
              "bytes": {
                "type": "integer",
                "description": "Size of the produced PDF in bytes"
              },
              "resource_uri": {
                "type": "string",
                "description": "pdfops:// uri of the inline application/pdf resource"
              }
            },
            "additionalProperties": false
          },
          "annotations": {
            "readOnlyHint": false,
            "openWorldHint": true,
            "idempotentHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "pdf_extract_text",
          "title": "Extract text and tables from a PDF",
          "description": "Read the text of a born-digital PDF (one made by software: invoices, statements, reports, contracts, forms), page by page, in reading order, plus any tables found from the text layout as rows of cells. Scanned PDFs (images of pages) have no text layer and come back listed in pages_without_text: OCR is not supported. Set include_lines to also get each line with its position in PDF points from the bottom-left of the page as the viewer sees it, the same frame pdf_edit uses, so you can stamp text next to something you found. Up to 200 pages per call; pass pages to read a large document in parts. To search for specific text instead, use pdf_find_text. With tables_format xlsx the tables come back as one Excel workbook instead (one sheet per table, all cells text). Read-only: the source is never modified.",
          "inputSchema": {
            "type": "object",
            "required": [
              "pdf_path"
            ],
            "properties": {
              "pages": {
                "type": "string",
                "description": "Pages to read, 1-based: \"1-3,5,8-\". Default: all pages."
              },
              "password": {
                "type": "string",
                "description": "Password to open the input, only needed for a user-password PDF (owner-locked files with an empty user password open without it)."
              },
              "pdf_path": {
                "type": "string",
                "description": "PDF source: an https:// URL or a data:application/pdf;base64,… URI (this hosted server cannot read local file paths)."
              },
              "include_lines": {
                "type": "boolean",
                "description": "Also return every line of text with x, y, width and font size in points. Default false (smaller output)."
              },
              "tables_format": {
                "enum": [
                  "json",
                  "csv",
                  "xlsx"
                ],
                "type": "string",
                "description": "csv adds a csv string (RFC 4180, CRLF line ends) to each table next to rows. xlsx instead returns one Excel workbook, one sheet per table (\"Page 3 Table 1\"), as an inline resource with a short summary (no text, lines or rows); every cell is a text string, never a formula, and numbers are not converted. xlsx fails with no_tables when the pages read have no table (if the read stopped early the error says so and names the pages value to continue with), and with an error when the workbook is over 4,000,000 bytes (read fewer pages). Default json. In csv cell values are returned verbatim: a cell starting with = + - or @ can run as a formula if the CSV is opened in a spreadsheet, so sanitise before opening."
              }
            },
            "additionalProperties": false
          },
          "outputSchema": {
            "type": "object",
            "oneOf": [
              {
                "required": [
                  "page_count",
                  "pages",
                  "pages_without_text",
                  "truncated"
                ]
              },
              {
                "required": [
                  "bytes",
                  "resource_uri",
                  "truncated",
                  "cells_truncated"
                ]
              }
            ],
            "properties": {
              "bytes": {
                "type": "integer",
                "description": "Only with tables_format=xlsx: size of the workbook"
              },
              "pages": {
                "type": "array",
                "items": {
                  "type": "object",
                  "required": [
                    "page",
                    "width",
                    "height",
                    "text",
                    "tables"
                  ],
                  "properties": {
                    "page": {
                      "type": "integer"
                    },
                    "text": {
                      "type": "string"
                    },
                    "lines": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "required": [
                          "text",
                          "x",
                          "y",
                          "width",
                          "font_size"
                        ],
                        "properties": {
                          "x": {
                            "type": "number"
                          },
                          "y": {
                            "type": "number"
                          },
                          "text": {
                            "type": "string"
                          },
                          "width": {
                            "type": "number"
                          },
                          "font_size": {
                            "type": "number"
                          }
                        },
                        "additionalProperties": false
                      }
                    },
                    "width": {
                      "type": "number"
                    },
                    "height": {
                      "type": "number"
                    },
                    "tables": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "required": [
                          "x",
                          "y",
                          "width",
                          "height",
                          "rows"
                        ],
                        "properties": {
                          "x": {
                            "type": "number"
                          },
                          "y": {
                            "type": "number"
                          },
                          "csv": {
                            "type": "string",
                            "description": "Present only with tables_format=csv"
                          },
                          "rows": {
                            "type": "array",
                            "items": {
                              "type": "array",
                              "items": {
                                "type": "string"
                              }
                            }
                          },
                          "width": {
                            "type": "number"
                          },
                          "height": {
                            "type": "number"
                          }
                        },
                        "additionalProperties": false
                      }
                    }
                  },
                  "additionalProperties": false
                }
              },
              "truncated": {
                "type": "boolean"
              },
              "page_count": {
                "type": "integer",
                "description": "Pages in the document"
              },
              "resource_uri": {
                "type": "string",
                "description": "Only with tables_format=xlsx: where the workbook resource is attached"
              },
              "truncated_by": {
                "type": "array",
                "items": {
                  "enum": [
                    "pages",
                    "output",
                    "sheets",
                    "columns",
                    "rows"
                  ],
                  "type": "string"
                },
                "description": "Only with tables_format=xlsx and truncated: which cap stopped the read or cut the workbook"
              },
              "cells_truncated": {
                "type": "boolean",
                "description": "Only with tables_format=xlsx: a cell over 32,767 characters was cut"
              },
              "pages_without_text": {
                "type": "array",
                "items": {
                  "type": "integer"
                }
              }
            },
            "description": "Without tables_format=xlsx: page_count, pages, pages_without_text and truncated. With xlsx: bytes, resource_uri, truncated, cells_truncated, and truncated_by when truncated.",
            "additionalProperties": false
          },
          "annotations": {
            "readOnlyHint": true,
            "openWorldHint": true,
            "idempotentHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "pdf_text_to_pdf",
          "title": "Create a PDF from Markdown, plain text or CSV",
          "description": "Create a new PDF from Markdown, plain text or a CSV table, with no template and no input PDF. This is NOT HTML-to-PDF: it does not render HTML or CSS, and it has no custom fonts or images (images in Markdown stay literal text). Text is set in the standard Helvetica family, code and monospace text in Courier, on Letter or A4 pages. Markdown supports headings 1-6, bold, italic, inline code, links (printed as text plus the URL; http(s) and mailto links are also clickable), fenced code blocks, bullet and numbered lists, one-level blockquotes, horizontal rules, pipe tables (header shaded and repeated per page; column alignment ignored) and \\pagebreak; anything else prints as typed. format text keeps spaces and line breaks exactly. format csv draws a table whose first row is the header (up to 20 columns, 10,000 rows, 100,000 cells). content is capped at 512 KiB and the output at 200 pages. WinAnsi characters only (English and Western European letters and common punctuation): emoji, Cyrillic, Greek and CJK fail with unsupported_characters, naming the character and its line and column. Very large tables or heavy inline formatting fail with content_too_complex. Deterministic: the same input gives byte-identical output, and the PDF carries no PDFops footer. Returns the PDF inline as an application/pdf resource. To add text to an existing PDF use pdf_edit; to build an invoice from data use pdf_invoice.",
          "inputSchema": {
            "type": "object",
            "required": [
              "content"
            ],
            "properties": {
              "title": {
                "type": "string",
                "maxLength": 200,
                "description": "PDF Title metadata (not printed on the page), up to 200 characters."
              },
              "format": {
                "enum": [
                  "markdown",
                  "text",
                  "csv"
                ],
                "type": "string",
                "description": "How to read content. Default markdown."
              },
              "margin": {
                "type": "number",
                "maximum": 144,
                "minimum": 18,
                "description": "Page margin in points, 18-144. Default 54."
              },
              "content": {
                "type": "string",
                "description": "The document: Markdown (default), plain text or CSV, up to 512 KiB of UTF-8."
              },
              "font_size": {
                "type": "number",
                "maximum": 36,
                "minimum": 6,
                "description": "Body text size in points, 6-36. Default 11."
              },
              "monospace": {
                "type": "boolean",
                "description": "Set the text in Courier. Only used with format text. Default false."
              },
              "page_size": {
                "enum": [
                  "a4",
                  "letter"
                ],
                "type": "string",
                "description": "Default letter."
              },
              "page_numbers": {
                "type": "boolean",
                "description": "Print \"Page n of N\" at the bottom of every page. Default false."
              }
            },
            "additionalProperties": false
          },
          "outputSchema": {
            "type": "object",
            "required": [
              "bytes"
            ],
            "properties": {
              "bytes": {
                "type": "integer",
                "description": "Size of the produced PDF in bytes"
              },
              "resource_uri": {
                "type": "string",
                "description": "pdfops:// uri of the inline application/pdf resource"
              }
            },
            "additionalProperties": false
          },
          "annotations": {
            "readOnlyHint": false,
            "openWorldHint": false,
            "idempotentHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "pdf_find_text",
          "title": "Find text in a PDF",
          "description": "Search a born-digital PDF (one made by software: invoices, statements, reports, contracts, forms) for a word, phrase or pattern and get each hit with its page and box in PDF points from the bottom-left of the page as the viewer sees it, y on the text baseline: the same frame pdf_edit uses, so a hit's x, y, width and height tell you where to stamp. Case-insensitive unless case_sensitive is true. Set regex to treat query as a regular expression from a safe subset (literals, classes, dot, anchors, word boundaries, groups, alternation, quantifiers including lazy ones); backreferences, lookahead, lookbehind, named groups, property escapes and inline flags are rejected. A match never spans lines. Scanned PDFs have no text layer: their pages are listed in pages_without_text (no OCR). While next_page is not null, call again with pages set to next_page followed by a dash (for example 4-) to continue with no gaps or repeated hits. If truncated is true but next_page is null, hits on a page listed in pages_skipped beyond max_hits cannot be retrieved: raise max_hits or narrow the query. Read-only: the source is never modified.",
          "inputSchema": {
            "type": "object",
            "required": [
              "pdf_path",
              "query"
            ],
            "properties": {
              "pages": {
                "type": "string",
                "description": "Pages to search, 1-based: \"1-3,5,8-\". Default: all pages. At most 200 pages per call."
              },
              "query": {
                "type": "string",
                "maxLength": 200,
                "description": "Text to find, or a pattern when regex is true. At most 200 characters."
              },
              "regex": {
                "type": "boolean",
                "description": "Treat query as a regular expression (the supported subset). Default false."
              },
              "max_hits": {
                "type": "integer",
                "maximum": 1000,
                "minimum": 1,
                "description": "Stop once more hits than this exist. Default 100."
              },
              "password": {
                "type": "string",
                "description": "Password to open the input, only needed for a user-password PDF (owner-locked files with an empty user password open without it)."
              },
              "pdf_path": {
                "type": "string",
                "description": "PDF source: an https:// URL or a data:application/pdf;base64,… URI (this hosted server cannot read local file paths)."
              },
              "whole_word": {
                "type": "boolean",
                "description": "Only report matches with no letter, digit, underscore or combining mark directly before or after. Default false."
              },
              "case_sensitive": {
                "type": "boolean",
                "description": "Default false: matching ignores case."
              }
            },
            "additionalProperties": false
          },
          "outputSchema": {
            "type": "object",
            "required": [
              "count",
              "truncated",
              "hits",
              "pages_without_text",
              "pages_scanned",
              "next_page"
            ],
            "properties": {
              "hits": {
                "type": "array",
                "items": {
                  "type": "object",
                  "required": [
                    "page",
                    "text",
                    "line",
                    "x",
                    "y",
                    "width",
                    "height"
                  ],
                  "properties": {
                    "x": {
                      "type": "number"
                    },
                    "y": {
                      "type": "number",
                      "description": "Baseline"
                    },
                    "line": {
                      "type": "string",
                      "description": "The line the match is on"
                    },
                    "page": {
                      "type": "integer"
                    },
                    "text": {
                      "type": "string",
                      "description": "The matched text as it appears on the page"
                    },
                    "width": {
                      "type": "number"
                    },
                    "height": {
                      "type": "number",
                      "description": "Font size; the box spans y to y + height"
                    },
                    "line_truncated": {
                      "type": "boolean",
                      "description": "Present only when line was cut"
                    }
                  },
                  "additionalProperties": false
                }
              },
              "count": {
                "type": "integer",
                "description": "Hits returned"
              },
              "next_page": {
                "type": [
                  "integer",
                  "null"
                ],
                "description": "First page not fully searched, or null when finished"
              },
              "truncated": {
                "type": "boolean",
                "description": "The scan stopped before every selected page was searched; continue from next_page while it is not null; null with truncated means hits beyond max_hits on a page in pages_skipped were dropped"
              },
              "lines_skipped": {
                "type": "integer"
              },
              "pages_scanned": {
                "type": "integer"
              },
              "pages_skipped": {
                "type": "array",
                "items": {
                  "type": "object",
                  "required": [
                    "page",
                    "reason"
                  ],
                  "properties": {
                    "page": {
                      "type": "integer"
                    },
                    "reason": {
                      "enum": [
                        "max_hits",
                        "output_cap",
                        "work_budget",
                        "page_output_cap"
                      ],
                      "type": "string"
                    }
                  },
                  "additionalProperties": false
                }
              },
              "pages_without_text": {
                "type": "array",
                "items": {
                  "type": "integer"
                }
              }
            },
            "additionalProperties": false
          },
          "annotations": {
            "readOnlyHint": true,
            "openWorldHint": true,
            "idempotentHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "pdf_add_fields",
          "title": "Add fillable form fields to a PDF",
          "description": "Create standard fillable AcroForm fields in an existing PDF at exact positions: text, multiline text, checkbox, radio group, dropdown and signature box. Coordinates are PDF points measured from the bottom-left corner of the page as the viewer sees it (1 inch = 72 pt; US Letter is 612 x 792), the same frame and 1-based page numbers as pdf_edit; x and y are the field's bottom-left corner and the whole rectangle must lie inside the page (each side at least 4 pt). Every entry needs type, name and page; every type except radio also needs x, y, width and height; radio and dropdown need options. Unknown keys are rejected. A radio entry is one group whose options each carry their own value, x, y, width and height. name is 1-200 characters with no dot, unique in the request and not already a field name in the PDF (a name that equals the first part of an existing dotted name is also taken). Text takes multiline, max_length, default and font_size; checkbox takes checked; dropdown takes options (strings), default and font_size. All entries also take required, read_only, border (default true) and background (default false). font_size is a number from 1 to 200 or \"auto\". If omitted, text, multiline text and dropdown fields get a fixed size of min(12 pt, the largest size at which one line fits the field height), at least 4 pt, so they draw predictably when filled; a value longer than the box is then clipped, not shrunk. \"auto\" stores size 0, and pdf_fill then sizes the text to the box when the blank field is first filled (a short value is enlarged, a long one shrunk) and keeps that size, so a later, longer value is clipped: for predictable text omit font_size or set a number. Defaults and dropdown options use standard fonts (WinAnsi characters only: euro sign and curly quotes work, Polish L-stroke and CJK fail). The signature type creates an EMPTY signature field for a signing tool to use: nothing is signed, it is not an e-signature. At most 200 entries and 200 widgets per call, and 2,000 fields in the finished form. Fields are plain AcroForm with no JavaScript. Fill the result with pdf_fill (pdf_inspect lists the new fields). Returns the PDF inline as an application/pdf resource; the source is never modified.",
          "inputSchema": {
            "type": "object",
            "required": [
              "pdf_path",
              "fields"
            ],
            "properties": {
              "fields": {
                "type": "array",
                "items": {
                  "type": "object",
                  "required": [
                    "type",
                    "name",
                    "page"
                  ],
                  "properties": {
                    "x": {
                      "type": "number",
                      "description": "Left edge in points from the page's left. Not used by radio."
                    },
                    "y": {
                      "type": "number",
                      "description": "Bottom edge in points from the page's bottom. Not used by radio."
                    },
                    "name": {
                      "type": "string",
                      "pattern": "^[^.]+$",
                      "maxLength": 200,
                      "minLength": 1,
                      "description": "Field name: no dot, unique, not already in the PDF."
                    },
                    "page": {
                      "type": "integer",
                      "minimum": 1,
                      "description": "1-based page number."
                    },
                    "type": {
                      "enum": [
                        "text",
                        "checkbox",
                        "radio",
                        "dropdown",
                        "signature"
                      ],
                      "type": "string"
                    },
                    "width": {
                      "type": "number",
                      "minimum": 4,
                      "description": "Width in points. Not used by radio."
                    },
                    "border": {
                      "type": "boolean",
                      "description": "Draw a black 1 pt outline. Default true."
                    },
                    "height": {
                      "type": "number",
                      "minimum": 4,
                      "description": "Height in points. Not used by radio."
                    },
                    "checked": {
                      "type": "boolean",
                      "description": "Checkbox only: start ticked. Default false."
                    },
                    "default": {
                      "type": "string",
                      "description": "Text, radio (one option value) or dropdown (one option): the starting value."
                    },
                    "options": {
                      "type": "array",
                      "items": {
                        "anyOf": [
                          {
                            "type": "string"
                          },
                          {
                            "type": "object",
                            "required": [
                              "value",
                              "x",
                              "y",
                              "width",
                              "height"
                            ],
                            "properties": {
                              "x": {
                                "type": "number"
                              },
                              "y": {
                                "type": "number"
                              },
                              "value": {
                                "type": "string",
                                "maxLength": 200,
                                "minLength": 1,
                                "description": "Option value, unique in the group, not \"Off\"."
                              },
                              "width": {
                                "type": "number",
                                "minimum": 4
                              },
                              "height": {
                                "type": "number",
                                "minimum": 4
                              }
                            },
                            "additionalProperties": false
                          }
                        ]
                      },
                      "maxItems": 100,
                      "minItems": 1,
                      "description": "Dropdown: strings. Radio: objects with value, x, y, width and height."
                    },
                    "required": {
                      "type": "boolean",
                      "description": "Set the field's Required flag. Default false."
                    },
                    "font_size": {
                      "anyOf": [
                        {
                          "type": "number",
                          "maximum": 200,
                          "minimum": 1
                        },
                        {
                          "enum": [
                            "auto"
                          ],
                          "type": "string"
                        }
                      ],
                      "description": "Text and dropdown: points (1-200), or \"auto\" (size chosen at the first fill, then kept). Omitted: a fixed min(12, largest size that fits one line in the height), at least 4."
                    },
                    "multiline": {
                      "type": "boolean",
                      "description": "Text only: allow several lines. Default false."
                    },
                    "read_only": {
                      "type": "boolean",
                      "description": "Set the field's ReadOnly flag. Default false."
                    },
                    "background": {
                      "type": "boolean",
                      "description": "Paint an opaque white background. Default false (none)."
                    },
                    "max_length": {
                      "type": "integer",
                      "maximum": 65535,
                      "minimum": 1,
                      "description": "Text only: maximum characters."
                    }
                  },
                  "additionalProperties": false
                },
                "maxItems": 200,
                "minItems": 1,
                "description": "Fields to create. Nothing is added unless every entry is valid. Required keys: every entry type, name, page; text, checkbox, dropdown and signature also x, y, width, height; radio and dropdown also options (radio options carry their own rectangles)."
              },
              "password": {
                "type": "string",
                "description": "Password to open the input, only needed for a user-password PDF (owner-locked files with an empty user password open without it)."
              },
              "pdf_path": {
                "type": "string",
                "description": "PDF source: an https:// URL or a data:application/pdf;base64,… URI (this hosted server cannot read local file paths)."
              }
            },
            "additionalProperties": false
          },
          "outputSchema": {
            "type": "object",
            "required": [
              "bytes"
            ],
            "properties": {
              "bytes": {
                "type": "integer",
                "description": "Size of the produced PDF in bytes"
              },
              "warning": {
                "type": "string",
                "description": "Present as xfa-layer-dropped when a hybrid AcroForm/XFA input lost its XFA layer"
              },
              "resource_uri": {
                "type": "string",
                "description": "pdfops:// uri of the inline application/pdf resource"
              }
            },
            "additionalProperties": false
          },
          "annotations": {
            "readOnlyHint": false,
            "openWorldHint": true,
            "idempotentHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "pdf_image_to_pdf",
          "title": "Make a PDF from JPG and PNG images",
          "description": "Make a PDF from JPG and PNG images: one image per page, in the order given. Each image is an https:// URL or a data:image/jpeg;base64,… or data:image/png;base64,… URI (this hosted server cannot read local file paths); the type is detected from the bytes, not the name. At most 100 images, each up to 4 MB, 4.5 MB in total. page_size \"fit\" (default) makes each page the image's own size at 72 dpi (1 px = 1 pt; pages longer than 5,000 pt on a side are scaled down, tiny images are enlarged to a 3 pt minimum); \"a4\" or \"letter\" put the image on a standard page, centred, shrunk to fit inside the margin and never enlarged. orientation (auto, portrait, landscape; default auto picks per image) applies to a4 and letter only. margin is 0-200 pt (default 0 for fit, where the page grows by the margin on every side; 36 for a4 and letter). A JPEG's EXIF orientation is applied, so phone photos come out upright. PNG: 8-bit and 16-bit, palette, grey, interlaced and transparent files work (transparency is kept); animated PNGs, other formats (GIF, WebP, HEIC, TIFF, SVG) and PDFs are rejected. JPEG: baseline and progressive, grey, RGB and Adobe-style CMYK. Very large images fail with image_too_large (PNG over 10 megapixels or a memory estimate; JPEG over 250 megapixels), and many large PNGs in one call with images_too_large_together. Deterministic: the same images give byte-identical output. To join images with existing PDFs use pdf_merge, which also accepts images. Returns the PDF inline as an application/pdf resource.",
          "inputSchema": {
            "type": "object",
            "required": [
              "image_paths"
            ],
            "properties": {
              "margin": {
                "type": "number",
                "maximum": 200,
                "minimum": 0,
                "description": "Points, 0-200. Default 0 for fit, 36 for a4 and letter."
              },
              "page_size": {
                "enum": [
                  "fit",
                  "a4",
                  "letter"
                ],
                "type": "string",
                "description": "fit (default): page = image size. a4 or letter: standard page, image centred and shrunk to fit."
              },
              "image_paths": {
                "type": "array",
                "items": {
                  "type": "string"
                },
                "maxItems": 100,
                "minItems": 1,
                "description": "In order, one page each: an https:// URL or a data:image/jpeg;base64,… / data:image/png;base64,… URI (this hosted server cannot read local file paths)."
              },
              "orientation": {
                "enum": [
                  "auto",
                  "portrait",
                  "landscape"
                ],
                "type": "string",
                "description": "a4 and letter only; auto (default) picks portrait or landscape per image."
              }
            },
            "additionalProperties": false
          },
          "outputSchema": {
            "type": "object",
            "required": [
              "bytes"
            ],
            "properties": {
              "bytes": {
                "type": "integer",
                "description": "Size of the produced PDF in bytes"
              },
              "resource_uri": {
                "type": "string",
                "description": "pdfops:// uri of the inline application/pdf resource"
              }
            },
            "additionalProperties": false
          },
          "annotations": {
            "readOnlyHint": false,
            "openWorldHint": true,
            "idempotentHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "pdf_add_attachment",
          "title": "Embed files in a PDF",
          "description": "Embed one or more files (for example an XML or CSV data file) in a PDF as attachments. Each entry in files has a source (an https:// URL or a data: URI with base64, never a local path) and optional name, mime_type, description (at most 1,000 characters) and relationship (Alternative, Data, Source, Supplement or Unspecified, default Unspecified; the PDF/A-3 AFRelationship value). name is 1-255 characters and at most 255 UTF-8 bytes with no / or backslash or control characters, and defaults to the last part of an https:// URL path (a data: URI needs a name). mime_type looks like text/xml, with no parameters and no #. At most 10 files and 3 MB in total per call, and at most 200 attachments in the finished PDF. A PDF whose list of embedded files has over 2,000 entries (name_tree_too_large) or an unreadable existing name (attachments_too_complex) is refused. A name already used by an attachment in the PDF (as a key or as an entry's /UF or /F), or twice in the call, is refused. Existing content, including any existing attachments, is kept. Each file keeps its full name; the lookup key for qpdf --show-attachment is plain ASCII and is returned in the result as keys. Unknown keys are rejected. The whole file is saved again, so an existing digital signature on the PDF stops validating. Returns the PDF inline as an application/pdf resource; the source is never modified.",
          "inputSchema": {
            "type": "object",
            "required": [
              "pdf_path",
              "files"
            ],
            "properties": {
              "files": {
                "type": "array",
                "items": {
                  "type": "object",
                  "required": [
                    "source"
                  ],
                  "properties": {
                    "name": {
                      "type": "string",
                      "maxLength": 255,
                      "minLength": 1,
                      "description": "Attachment name. Default: last part of the URL path."
                    },
                    "source": {
                      "type": "string",
                      "description": "File source: an https:// URL or a data:<type>;base64,… URI."
                    },
                    "mime_type": {
                      "type": "string",
                      "description": "For example text/xml."
                    },
                    "description": {
                      "type": "string",
                      "maxLength": 1000
                    },
                    "relationship": {
                      "enum": [
                        "Alternative",
                        "Data",
                        "Source",
                        "Supplement",
                        "Unspecified"
                      ],
                      "type": "string",
                      "description": "PDF/A-3 AFRelationship. Default Unspecified."
                    }
                  },
                  "additionalProperties": false
                },
                "maxItems": 10,
                "minItems": 1,
                "description": "Files to embed. Nothing is added unless every entry is valid."
              },
              "password": {
                "type": "string",
                "description": "Password to open the input, only needed for a user-password PDF (owner-locked files with an empty user password open without it)."
              },
              "pdf_path": {
                "type": "string",
                "description": "PDF source: an https:// URL or a data:application/pdf;base64,… URI (this hosted server cannot read local file paths)."
              }
            },
            "additionalProperties": false
          },
          "outputSchema": {
            "type": "object",
            "required": [
              "bytes"
            ],
            "properties": {
              "keys": {
                "type": "array",
                "items": {
                  "type": "object",
                  "required": [
                    "name",
                    "key"
                  ],
                  "properties": {
                    "key": {
                      "type": "string",
                      "description": "The name tree key"
                    },
                    "name": {
                      "type": "string",
                      "description": "The file name, cut to 40 characters"
                    }
                  },
                  "additionalProperties": false
                },
                "description": "One entry per added file, in order: the ASCII key for qpdf --show-attachment (qpdf --list-attachments shows it)"
              },
              "bytes": {
                "type": "integer",
                "description": "Size of the produced PDF in bytes"
              },
              "resource_uri": {
                "type": "string",
                "description": "pdfops:// uri of the inline application/pdf resource"
              }
            },
            "additionalProperties": false
          },
          "annotations": {
            "readOnlyHint": false,
            "openWorldHint": true,
            "idempotentHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "pdf_html_to_pdf",
          "title": "Create a PDF from HTML",
          "description": "Render an HTML string to a PDF with a headless browser, so layout, CSS (flexbox, grid, print styles), images and web fonts come out as in a browser print. It takes HTML text only: there is no URL input, and JavaScript is switched off, so scripts do not run and pages that build themselves with JavaScript render empty. External resources (images, stylesheets, fonts) load only over https from public hosts; anything else (http, file, private or internal addresses, redirects to them) is blocked and skipped, and the PDF is still made. Data URIs work and are the safest way to include images. Letter or A4, portrait or landscape, margin in points (default 36), backgrounds printed by default, optional scale. html is capped at 1 MB, the document at 50 pages and 16 MB, external resources at 50 requests and 40 MB, and rendering at 15 seconds. Frames, iframes, objects, embeds, audio and video are not rendered, and an inline or fetched image is decoded and checked first. Common fonts (Helvetica, Arial, Times, Courier and generic families) render as Liberation faces, metric-compatible with the originals. Once the renderer is reached every outcome costs 5 of your monthly request quota, not 1, failures included; a cheap refusal before a browser starts (for example an inline image refused: image_too_large or unsupported_image, with the image named in the message) costs 1; only input validation errors and a busy or unreachable renderer cost nothing. Images: 16 megapixels at most each (96 in total), PNG, JPEG, GIF, WebP or SVG (simplified: scripts, style sheets, filters, masks, embedded images and links are removed; inline style colours are kept); AVIF, BMP, ICO, TIFF, animated PNG and colour-bitmap fonts are not supported, and an image in an unsupported format or over a limit fails the request (a missing image, such as a 404 or a tracking pixel, is skipped). Returns the PDF inline as an application/pdf resource, up to 4,000,000 bytes (larger results fail with an error pointing to POST /api/html-to-pdf, which streams up to 16 MB). For Markdown, text or CSV with no HTML use pdf_text_to_pdf; to build an invoice from data use pdf_invoice.",
          "inputSchema": {
            "type": "object",
            "required": [
              "html"
            ],
            "properties": {
              "html": {
                "type": "string",
                "description": "The document as HTML text, up to 1 MB of UTF-8. A full document or a fragment."
              },
              "scale": {
                "type": "number",
                "maximum": 2,
                "minimum": 0.1,
                "description": "Page content scale, 0.1-2. Default 1."
              },
              "margin": {
                "type": "number",
                "maximum": 144,
                "minimum": 0,
                "description": "Margin on every side in points, 0-144. Default 36."
              },
              "landscape": {
                "type": "boolean",
                "description": "Landscape orientation. Default false."
              },
              "page_size": {
                "enum": [
                  "a4",
                  "letter"
                ],
                "type": "string",
                "description": "Default letter."
              },
              "print_background": {
                "type": "boolean",
                "description": "Print background colors and images. Default true."
              }
            },
            "additionalProperties": false
          },
          "outputSchema": {
            "type": "object",
            "required": [
              "bytes"
            ],
            "properties": {
              "bytes": {
                "type": "integer",
                "description": "Size of the produced PDF in bytes"
              },
              "pages": {
                "type": "integer",
                "description": "Pages in the PDF"
              },
              "resource_uri": {
                "type": "string",
                "description": "pdfops:// uri of the inline application/pdf resource"
              },
              "blocked_requests": {
                "type": "integer",
                "description": "External requests the page made that were blocked by the network policy"
              }
            },
            "additionalProperties": false
          },
          "annotations": {
            "readOnlyHint": false,
            "openWorldHint": true,
            "idempotentHint": true,
            "destructiveHint": false
          }
        }
      ],
      "tools_omitted": 0,
      "resources": [],
      "prompts": []
    },
    "instructions": "PDF tools backed by the PDFops API. Pass PDFs as https:// URLs or data:application/pdf;base64 URIs (no local paths); produced PDFs come back inline as application/pdf resources. Call pdf_inspect before pdf_fill on an unfamiliar form; pdf_fill also accepts visible labels or near-miss field names and reports how each was matched. Use pdf_metadata to read page count and sizes before page operations. pdf_extract_text reads the text and tables of a born-digital PDF and pdf_find_text searches it for text or a pattern with page positions (no OCR). pdf_text_to_pdf makes a PDF from Markdown, plain text or CSV with no HTML engine. pdf_html_to_pdf renders HTML you supply (no URL input, no JavaScript, https-only external resources) to a PDF; each render costs 5 requests of quota once the renderer is reached, failures included. pdf_add_fields creates fillable fields in a PDF at given positions; fill them with pdf_fill. pdf_image_to_pdf makes a PDF from JPG and PNG images (one per page); pdf_merge also takes images. pdf_add_attachment embeds files in a PDF."
  },
  "changes": {
    "total": 1,
    "latest": [
      {
        "observed_at": "2026-11-22T17:32:02.483Z",
        "from_sha": "c08bdd029ac5a570c4aab260badca32462c759b889aa97e9e008820a7d95f57e",
        "to_sha": "a5ef521b6692a74d0d648a2bd649d8072b875131fee9d69522d02fe21e3dc17d",
        "summary": {
          "tool_added": 27,
          "tool_changed": 4,
          "tool_removed": 1
        },
        "diff": [
          {
            "op": "changed",
            "kind": "tool",
            "name": "pdf_invoice",
            "path": "/description",
            "after": "Generate a complete, professionally laid-out invoice PDF from structured data — no template needed. Deterministic: the same input produces byte-identical output (safe to re-run). Note: without a paid PDFops key the output carries a small \"Generated with pdfops.dev\" footer line. Returns the invoice inline as an application/pdf resource. Use this when you have invoice DATA and no document; if you already have an invoice PDF or a fillable template to populate, use pdf_fill instead. Set invoice.e_invoice to \"factur-x\" to produce an e-invoice instead: a PDF/A-3 file with the invoice data embedded as factur-x.xml (UN/CEFACT Cross Industry Invoice, profile EN 16931, also called COMFORT). Several more fields then become required, and a missing one fails with einvoice_fields_required naming every missing field: invoice_number, date, currency (no default), due or payment_terms, from.country and to.country (ISO 3166-1 alpha-2 codes), from.vat_id (or from.tax_id with from.registration_id), tax_category when tax_rate is 0, and a UN/ECE Recommendation 20 unit code on every item. Amounts in the XML and on the page come from the same exact decimal arithmetic: each line is rounded to 2 decimals, VAT is computed once on the summed basis. On that path text is limited to Latin letters, Latin Extended-A, the euro sign and common punctuation (other characters fail with unrenderable_text); leading and trailing whitespace is trimmed, over-long or control-character text is refused with a 400, and long text wraps onto further lines or pages on the page and is carried in full in the XML. Per-item tax fields and other unknown fields are refused, and a buyer tax_id is refused (use to.vat_id). Checked in testing with the Mustang validator 2.26.0 (PDF/A-3 via veraPDF, XSD, EN 16931 schematron); this is not a statement of legal compliance, and XRechnung and Peppol output are not produced.",
            "before": "Generate a complete, professionally laid-out invoice PDF from structured data — no template needed. Deterministic: the same input produces byte-identical output (safe to re-run). Note: without a paid PDFops key the output carries a small \"Generated with pdfops.dev\" footer line. Returns the invoice inline as an application/pdf resource. Use this when you have invoice DATA and no document; if you already have an invoice PDF or a fillable template to populate, use pdf_fill instead."
          },
          {
            "op": "added",
            "kind": "tool",
            "name": "pdf_invoice",
            "path": "/inputSchema/properties/invoice/properties/due/description",
            "after": "Shown as given. With e_invoice it must be a calendar date in YYYY-MM-DD form."
          },
          {
            "op": "added",
            "kind": "tool",
            "name": "pdf_invoice",
            "path": "/inputSchema/properties/invoice/properties/e_invoice",
            "after": {
              "enum": [
                "factur-x"
              ],
              "type": "string",
              "description": "Produce a Factur-X (ZUGFeRD) EN 16931 e-invoice: PDF/A-3 with factur-x.xml embedded. Makes several fields required, see the tool description."
            }
          },
          {
            "op": "added",
            "kind": "tool",
            "name": "pdf_invoice",
            "path": "/inputSchema/properties/invoice/properties/from/anyOf/1/properties/city",
            "after": {
              "type": "string",
              "maxLength": 35
            }
          },
          {
            "op": "added",
            "kind": "tool",
            "name": "pdf_invoice",
            "path": "/inputSchema/properties/invoice/properties/from/anyOf/1/properties/country",
            "after": {
              "type": "string",
              "pattern": "^([A-Z]{2}|1A)$",
              "description": "ISO 3166-1 alpha-2 country code in capitals (1A for Kosovo, as in the EN 16931 list). Required when e_invoice is set."
            }
          },
          {
            "op": "added",
            "kind": "tool",
            "name": "pdf_invoice",
            "path": "/inputSchema/properties/invoice/properties/from/anyOf/1/properties/postcode",
            "after": {
              "type": "string",
              "maxLength": 35
            }
          },
          {
            "op": "added",
            "kind": "tool",
            "name": "pdf_invoice",
            "path": "/inputSchema/properties/invoice/properties/from/anyOf/1/properties/registration_id",
            "after": {
              "type": "string",
              "maxLength": 35,
              "description": "Legal registration number, for example a commercial register number."
            }
          },
          {
            "op": "added",
            "kind": "tool",
            "name": "pdf_invoice",
            "path": "/inputSchema/properties/invoice/properties/from/anyOf/1/properties/street",
            "after": {
              "type": "string",
              "maxLength": 200
            }
          },
          {
            "op": "added",
            "kind": "tool",
            "name": "pdf_invoice",
            "path": "/inputSchema/properties/invoice/properties/from/anyOf/1/properties/tax_id",
            "after": {
              "type": "string",
              "maxLength": 35,
              "description": "National tax number. With e_invoice it is accepted for the seller only: EN 16931 has no buyer tax number, so to.tax_id is refused (use to.vat_id)."
            }
          },
          {
            "op": "added",
            "kind": "tool",
            "name": "pdf_invoice",
            "path": "/inputSchema/properties/invoice/properties/from/anyOf/1/properties/vat_id",
            "after": {
              "type": "string",
              "maxLength": 35,
              "description": "VAT identification number. With e_invoice it must start with a two-letter capital country prefix, such as DE123456789 (EL for Greece), and the seller needs vat_id, or tax_id plus registration_id."
            }
          },
          {
            "op": "added",
            "kind": "tool",
            "name": "pdf_invoice",
            "path": "/inputSchema/properties/invoice/properties/iban",
            "after": {
              "type": "string",
              "description": "IBAN to pay into; the checksum is verified. Used only with e_invoice: written as SEPA credit transfer (code 58) for a EUR invoice and a SEPA-area IBAN, otherwise as credit transfer (code 30)."
            }
          },
          {
            "op": "added",
            "kind": "tool",
            "name": "pdf_invoice",
            "path": "/inputSchema/properties/invoice/properties/items/items/properties/unit",
            "after": {
              "type": "string",
              "maxLength": 3,
              "description": "UN/ECE Recommendation 20 unit code, for example C62 (one), HUR (hour), KGM (kilogram). Required when e_invoice is set."
            }
          },
          {
            "op": "added",
            "kind": "tool",
            "name": "pdf_invoice",
            "path": "/inputSchema/properties/invoice/properties/payment_terms",
            "after": {
              "type": "string",
              "maxLength": 200,
              "description": "Payment terms text. With e_invoice, either this or a due date is required."
            }
          },
          {
            "op": "added",
            "kind": "tool",
            "name": "pdf_invoice",
            "path": "/inputSchema/properties/invoice/properties/tax_category",
            "after": {
              "enum": [
                "S",
                "Z",
                "E",
                "AE",
                "O"
              ],
              "type": "string",
              "description": "EN 16931 VAT category: S standard rate (the default when tax_rate is above 0), Z zero rate, E exempt, AE reverse charge, O not subject to VAT. Required with e_invoice when tax_rate is 0 or omitted. Ignored without e_invoice."
            }
          },
          {
            "op": "added",
            "kind": "tool",
            "name": "pdf_invoice",
            "path": "/inputSchema/properties/invoice/properties/tax_exemption_reason",
            "after": {
              "type": "string",
              "maxLength": 200,
              "description": "Reason text, required with e_invoice for tax_category E, AE and O."
            }
          },
          {
            "op": "added",
            "kind": "tool",
            "name": "pdf_invoice",
            "path": "/inputSchema/properties/invoice/properties/to/anyOf/1/properties/city",
            "after": {
              "type": "string",
              "maxLength": 35
            }
          },
          {
            "op": "added",
            "kind": "tool",
            "name": "pdf_invoice",
            "path": "/inputSchema/properties/invoice/properties/to/anyOf/1/properties/country",
            "after": {
              "type": "string",
              "pattern": "^([A-Z]{2}|1A)$",
              "description": "ISO 3166-1 alpha-2 country code in capitals (1A for Kosovo, as in the EN 16931 list). Required when e_invoice is set."
            }
          },
          {
            "op": "added",
            "kind": "tool",
            "name": "pdf_invoice",
            "path": "/inputSchema/properties/invoice/properties/to/anyOf/1/properties/postcode",
            "after": {
              "type": "string",
              "maxLength": 35
            }
          },
          {
            "op": "added",
            "kind": "tool",
            "name": "pdf_invoice",
            "path": "/inputSchema/properties/invoice/properties/to/anyOf/1/properties/registration_id",
            "after": {
              "type": "string",
              "maxLength": 35,
              "description": "Legal registration number, for example a commercial register number."
            }
          },
          {
            "op": "added",
            "kind": "tool",
            "name": "pdf_invoice",
            "path": "/inputSchema/properties/invoice/properties/to/anyOf/1/properties/street",
            "after": {
              "type": "string",
              "maxLength": 200
            }
          },
          {
            "op": "added",
            "kind": "tool",
            "name": "pdf_invoice",
            "path": "/inputSchema/properties/invoice/properties/to/anyOf/1/properties/tax_id",
            "after": {
              "type": "string",
              "maxLength": 35,
              "description": "National tax number. With e_invoice it is accepted for the seller only: EN 16931 has no buyer tax number, so to.tax_id is refused (use to.vat_id)."
            }
          },
          {
            "op": "added",
            "kind": "tool",
            "name": "pdf_invoice",
            "path": "/inputSchema/properties/invoice/properties/to/anyOf/1/properties/vat_id",
            "after": {
              "type": "string",
              "maxLength": 35,
              "description": "VAT identification number. With e_invoice it must start with a two-letter capital country prefix, such as DE123456789 (EL for Greece), and the seller needs vat_id, or tax_id plus registration_id."
            }
          },
          {
            "op": "changed",
            "kind": "tool",
            "name": "pdf_extract_text",
            "path": "/description",
            "after": "Read the text of a born-digital PDF (one made by software: invoices, statements, reports, contracts, forms), page by page, in reading order, plus any tables found from the text layout as rows of cells. Scanned PDFs (images of pages) have no text layer and come back listed in pages_without_text: OCR is not supported. Set include_lines to also get each line with its position in PDF points from the bottom-left of the page as the viewer sees it, the same frame pdf_edit uses, so you can stamp text next to something you found. Up to 200 pages per call; pass pages to read a large document in parts. To search for specific text instead, use pdf_find_text. With tables_format xlsx the tables come back as one Excel workbook instead (one sheet per table, all cells text). Read-only: the source is never modified.",
            "before": "Read the text of a born-digital PDF (one made by software: invoices, statements, reports, contracts, forms), page by page, in reading order, plus any tables found from the text layout as rows of cells. Scanned PDFs (images of pages) have no text layer and come back listed in pages_without_text: OCR is not supported. Set include_lines to also get each line with its position in PDF points from the bottom-left of the page as the viewer sees it, the same frame pdf_edit uses, so you can stamp text next to something you found. Up to 200 pages per call; pass pages to read a large document in parts. To search for specific text instead, use pdf_find_text. Read-only: the source is never modified."
          },
          {
            "op": "changed",
            "kind": "tool",
            "name": "pdf_extract_text",
            "path": "/inputSchema/properties/tables_format/description",
            "after": "csv adds a csv string (RFC 4180, CRLF line ends) to each table next to rows. xlsx instead returns one Excel workbook, one sheet per table (\"Page 3 Table 1\"), as an inline resource with a short summary (no text, lines or rows); every cell is a text string, never a formula, and numbers are not converted. xlsx fails with no_tables when the pages read have no table (if the read stopped early the error says so and names the pages value to continue with), and with an error when the workbook is over 4,000,000 bytes (read fewer pages). Default json. In csv cell values are returned verbatim: a cell starting with = + - or @ can run as a formula if the CSV is opened in a spreadsheet, so sanitise before opening.",
            "before": "csv adds a csv string (RFC 4180, CRLF line ends) to each table next to rows. Default json. Cell values are returned verbatim: a cell starting with = + - or @ can run as a formula if the CSV is opened in a spreadsheet, so sanitise before opening."
          },
          {
            "op": "changed",
            "kind": "tool",
            "name": "pdf_extract_text",
            "path": "/inputSchema/properties/tables_format/enum",
            "after": [
              "json",
              "csv",
              "xlsx"
            ],
            "before": [
              "json",
              "csv"
            ]
          },
          {
            "op": "added",
            "kind": "tool",
            "name": "pdf_extract_text",
            "path": "/outputSchema/description",
            "after": "Without tables_format=xlsx: page_count, pages, pages_without_text and truncated. With xlsx: bytes, resource_uri, truncated, cells_truncated, and truncated_by when truncated."
          },
          {
            "op": "added",
            "kind": "tool",
            "name": "pdf_extract_text",
            "path": "/outputSchema/oneOf",
            "after": [
              {
                "required": [
                  "page_count",
                  "pages",
                  "pages_without_text",
                  "truncated"
                ]
              },
              {
                "required": [
                  "bytes",
                  "resource_uri",
                  "truncated",
                  "cells_truncated"
                ]
              }
            ]
          },
          {
            "op": "added",
            "kind": "tool",
            "name": "pdf_extract_text",
            "path": "/outputSchema/properties/bytes",
            "after": {
              "type": "integer",
              "description": "Only with tables_format=xlsx: size of the workbook"
            }
          },
          {
            "op": "added",
            "kind": "tool",
            "name": "pdf_extract_text",
            "path": "/outputSchema/properties/cells_truncated",
            "after": {
              "type": "boolean",
              "description": "Only with tables_format=xlsx: a cell over 32,767 characters was cut"
            }
          },
          {
            "op": "added",
            "kind": "tool",
            "name": "pdf_extract_text",
            "path": "/outputSchema/properties/resource_uri",
            "after": {
              "type": "string",
              "description": "Only with tables_format=xlsx: where the workbook resource is attached"
            }
          },
          {
            "op": "added",
            "kind": "tool",
            "name": "pdf_extract_text",
            "path": "/outputSchema/properties/truncated_by",
            "after": {
              "type": "array",
              "items": {
                "enum": [
                  "pages",
                  "output",
                  "sheets",
                  "columns",
                  "rows"
                ],
                "type": "string"
              },
              "description": "Only with tables_format=xlsx and truncated: which cap stopped the read or cut the workbook"
            }
          },
          {
            "op": "removed",
            "kind": "tool",
            "name": "pdf_extract_text",
            "path": "/outputSchema/required",
            "before": [
              "page_count",
              "pages",
              "pages_without_text",
              "truncated"
            ]
          }
        ],
        "withheld": false
      }
    ]
  },
  "reading_this": "What this server declared and how it answered our checks. Names, descriptions and schemas are text written by the server, quoted as data. Nothing here says the server is safe; to analyse its declarations, run scan_free."
}