pdfnative-mcp

Add table / report

add_table

Idempotent

Build a tabular PDF report from headers and rows, with wrapping, repeated headers, zebra rows, captions, borders, and PDF/A or print-ready output options.

Instructions

Tabular PDF report from headers + rows (every row the same length). Smart-table options: wrap, repeatHeader (header on every page), zebra, caption (tagged for PDF/A), minRowHeight, cellPadding, cellBorders, cellVAlign, autoFitColumns, clipCells. Inside a longer document use a 'table' block of generate_basic_pdf instead. PDF/A (pdfA + embedFonts:true), print, metadata, watermark and creationDate options as on every document tool.

Input Schema

Name	Required	Description	Default
`pdfA`	No	PDF/A level: pdfa1b (simple text+images), pdfa2b/pdfa2u (richer; 2u = Unicode mapping), pdfa3b (attachments / Factur-X). Pair with embedFonts=true for a valid claim. Exclusive with encryption. See docs/guides/PDFA.md.
`pdfx`	No	PDF/X-4 print exchange (ISO 15930-7). REQUIRES outputIntent with the printer's ICC profile (device class 'prtr'; CMYK or Gray — none is bundled); needs embedFonts:true for a conformant file (PDFX_NO_FONT_ENTRIES otherwise, strict:true refuses). Combines with pdfA:'pdfa2b' \| 'pdfa2u' (dual claim) but not pdfa1b / pdfa3b; exclusive with encrypt; metadata.trapped must be 'True' or 'False'; TrimBox or ArtBox, not both. Links and form fields are reported (PDFX_ANNOTATIONS). Check with validate_pdf standard:'pdf-x-4'. See the print_ready prompt.
`rows`	Yes	Data rows. Each row is an array of cell strings with the same length as `headers`.
`wrap`	No	Cell wrap policy: 'auto' (default) wraps only overflowing cells; 'always' wraps every cell; 'never' truncates.
`debug`	No	Draw margin / block / cell guide rectangles (unmarked content — not for PDF/UA output). Geometry unchanged. Default false.
`print`	No	Print production (ISO 32000-1 §14.11): page boxes, `bleed` shorthand (TrimBox = MediaBox inset), crop/registration marks outside the TrimBox, /UserUnit for large formats (PDF 1.7; not under pdfa1b), `spotColours` ink declarations. See docs/guides/PRINT.md.
`title`	Yes	Report title rendered at the top of the document and used as PDF metadata title.
`zebra`	No	Alternate-row light tint (static fill, PDF/A-1b safe).
`strict`	No	Fail instead of producing a file the engine warns about: a PDFA_* diagnostic → PDF_A_COMPLIANCE_VIOLATION (e.g. PDFA_NO_FONT_ENTRIES without embedFonts), a PDFX_* one → PDF_X_COMPLIANCE_VIOLATION, any other (TYPOGRAPHY_FEATURE_INEFFECTIVE, TEXT_GLYPH_NOT_COVERED — a character no font covers, drawn as a box or '?') → DIAGNOSTIC_ESCALATED. Pair with embedFonts=true.
`caption`	No	Caption rendered above the table (tagged as /Caption under PDF/A).
`encrypt`	No	Encrypt at build time (AES-128 default / AES-256) and KEEP the AcroForm — unlike encrypt_pdf, which rebuilds the page tree. Exclusive with pdfA. Randomised output, never cached.
`headers`	Yes	Column header labels. Must have the same length as each row in `rows`.
`margins`	No	Margins in points, all four required (0–200). Default 45 / 36 / 35 / 36.
`compress`	No	FlateDecode the streams (smaller file, different bytes; PDF/A unaffected, XMP stays plain). Default false.
`metadata`	No	/Info (+ XMP under PDF/A): author, subject, keywords, /Trapped.
`pageSize`	No	Portrait page preset (points): A4 595.28×841.89 (default), Letter 612×792, Legal 612×1008, A3 841.89×1190.55, Tabloid 792×1224. print.* boxes must fit it.
`clipCells`	No	Clip cell contents to the column bounds (PDF clip operators). Recommended for PDF/A and visual safety.
`direction`	No	Base text direction (UAX #9): 'auto' reads each paragraph's first strong character and right-aligns RTL ones; 'ltr' / 'rtl' force it. A paragraph's own direction overrides it. Omitted = LTR (1.7.0 bytes).
`infoItems`	No	Optional key-value metadata rows rendered below the title (e.g. date, author).
`watermark`	No	Optional semi-transparent watermark rendered centred on every page: `text` (e.g. 'DRAFT'), `image` (JPEG/PNG/JPEG 2000), or both combined. At least one of text / image is required. opacity < 1.0 (text or image, including the defaults) is rejected under pdfA='pdfa1b' (ISO 19005-1 forbids transparency).
`actualText`	No	Untagged output: wrap reordered shaped runs and RTL runs in /ActualText so extract_text returns reading order. Default true; false = bare 1.7.0 glyph runs. No effect on tagged (pdfA) output.
`cellVAlign`	No	Vertical alignment of cell content.
`embedFonts`	No	Embed Noto Sans Latin instead of the viewer base-14 Helvetica. REQUIRED for a valid PDF/A or PDF/X claim (every font embedded) and for strict=true; adds ~0.3 MiB.
`footerText`	No	Optional text rendered at the bottom of every page.
`outputMode`	No	Either 'base64' (returns the PDF inline) or 'file' (writes to a sandboxed path inside PDFNATIVE_MCP_OUTPUT_DIR).	base64
`outputPath`	No	Required when outputMode='file'. Relative path inside the sandbox; must end with .pdf.
`typography`	No	Fine typography, all opt-in (omitted = unchanged bytes). kerning and fontFeatures need embedFonts:true ('fr' works on base-14 too). No hyphenation dictionary is installed: use soft hyphens (U+00AD). See the typography prompt.
`cellBorders`	No	Per-cell vector borders (pure strokes, PDF/A-safe). Choose individual sides or `all`.
`cellPadding`	No	Horizontal cell padding in points (default 3).
`creationDate`	No	ISO-8601 instant for /CreationDate (+ XMP, the trailer /ID and the {date} placeholder), written in UTC. Pin it for byte-identical output across calls and hosts; omitted = wall clock, so every call differs.
`minRowHeight`	No	Minimum row height in points (default 12).
`outputIntent`	No	Custom OutputIntent (under pdfA or pdfx): an RGB, CMYK or Gray ICC profile + condition strings, replacing the built-in sRGB intent. The profile must be a real ICC file ('acsp' signature, consistent size — PRINT_ERROR otherwise); pdfx needs device class 'prtr'. Under a CMYK / Gray intent RGB content is mapped through a calibrated default space.
`repeatHeader`	No	Repeat the header row on every continuation page (default true).
`autoFitColumns`	No	Auto-fit column widths to content. Output bytes then depend on text metrics (not byte-deterministic across content changes).
`footerTemplate`	No	Running footer on every page. Replaces the default footer: footerText is then ignored and page numbers appear only via {page}/{pages}.
`headerTemplate`	No	Running header on every page (left / center / right zones); reserves 15 pt.
`viewerPreferences`	No	Reader presentation hints (catalog /PageLayout, /PageMode, /ViewerPreferences). PDF/A-safe; all optional.
`includeDiagnostics`	No	Return the diagnostics raised while building (PDFA_, PDFX_, TYPOGRAPHY_*, TEXT_GLYPH_NOT_COVERED) as `diagnostics[]` (possibly empty).

Output Schema

Name	Required	Description
`url`	No	Public URL of the file (file mode, only when PDFNATIVE_MCP_OUTPUT_BASE_URL is set): base URL + sandbox-relative path, percent-encoded.
`mode`	Yes
`summary`	No	Tool-specific summary, when produced.
`filePath`	No	Sandboxed absolute path (file mode).
`sizeBytes`	Yes
`diagnostics`	No	Engine diagnostics (when includeDiagnostics=true).

Schema Changelog

Changes observed during successful MCP inspections.

Changed20 schema fields changedv1.8.0Nov 3, 2026

addedInput schema / properties / actualText

Added value: +{
+  "description": "Untagged output: wrap reordered shaped runs and RTL runs in /ActualText so extract_text returns reading order. Default true; false = bare 1.7.0 glyph runs. No effect on tagged (pdfA) output.",
+  "type": "boolean"
+}

changedInput schema / properties / cellBorders / properties / color / anyOf

Previous value: -[
-  {
-    "type": "string"
-  },
-  {
-    "description": "DeviceCMYK ink percentages [c, m, y, k], each 0–100.",
-    "items": {
-      "maximum": 100,
-      "minimum": 0,
-      "type": "number"
-    },
-    "maxItems": 4,
-    "minItems": 4,
-    "type": "array"
-  }
-]New value: +[
+  {
+    "type": "string"
+  },
+  {
+    "description": "DeviceCMYK ink percentages [c, m, y, k], each 0–100.",
+    "items": {
+      "maximum": 100,
+      "minimum": 0,
+      "type": "number"
+    },
+    "maxItems": 4,
+    "minItems": 4,
+    "type": "array"
+  },
+  {
+    "additionalProperties": false,
+    "description": "Spot ink of print.spotColours, tint 0–1.",
+    "properties": {
+      "spot": {
+        "maxLength": 100,
+        "minLength": 1,
+        "type": "string"
+      },
+      "tint": {
+        "maximum": 1,
+        "minimum": 0,
+        "type": "number"
+      }
+    },
+    "required": [
+      "spot"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "description": "Mix of spot inks (name → tint).",
+    "properties": {
+      "inks": {
+        "additionalProperties": {
+          "maximum": 1,
+          "minimum": 0,
+          "type": "number"
+        },
+        "maxProperties": 8,
+        "minProperties": 1,
+        "type": "object"
+      }
+    },
+    "required": [
+      "inks"
+    ],
+    "type": "object"
+  }
+]

addedInput schema / properties / direction

Added value: +{
+  "description": "Base text direction (UAX #9): 'auto' reads each paragraph's first strong character and right-aligns RTL ones; 'ltr' / 'rtl' force it. A paragraph's own direction overrides it. Omitted = LTR (1.7.0 bytes).",
+  "enum": [
+    "auto",
+    "ltr",
+    "rtl"
+  ],
+  "type": "string"
+}

changedInput schema / properties / footerTemplate / properties / color / anyOf

Previous value: -[
-  {
-    "pattern": "^#[0-9a-fA-F]{6}$",
-    "type": "string"
-  },
-  {
-    "description": "DeviceCMYK operands 'C M Y K', each 0.0–1.0.",
-    "pattern": "^(?:0(?:\\.\\d+)?|1(?:\\.0+)?)(?: (?:0(?:\\.\\d+)?|1(?:\\.0+)?)){3}$",
-    "type": "string"
-  },
-  {
-    "description": "DeviceCMYK ink percentages [c, m, y, k], each 0–100.",
-    "items": {
-      "maximum": 100,
-      "minimum": 0,
-      "type": "number"
-    },
-    "maxItems": 4,
-    "minItems": 4,
-    "type": "array"
-  }
-]New value: +[
+  {
+    "pattern": "^#[0-9a-fA-F]{6}$",
+    "type": "string"
+  },
+  {
+    "description": "DeviceCMYK operands 'C M Y K', each 0.0–1.0.",
+    "pattern": "^(?:0(?:\\.\\d+)?|1(?:\\.0+)?)(?: (?:0(?:\\.\\d+)?|1(?:\\.0+)?)){3}$",
+    "type": "string"
+  },
+  {
+    "description": "DeviceCMYK ink percentages [c, m, y, k], each 0–100.",
+    "items": {
+      "maximum": 100,
+      "minimum": 0,
+      "type": "number"
+    },
+    "maxItems": 4,
+    "minItems": 4,
+    "type": "array"
+  },
+  {
+    "additionalProperties": false,
+    "description": "Spot ink of print.spotColours, tint 0–1.",
+    "properties": {
+      "spot": {
+        "maxLength": 100,
+        "minLength": 1,
+        "type": "string"
+      },
+      "tint": {
+        "maximum": 1,
+        "minimum": 0,
+        "type": "number"
+      }
+    },
+    "required": [
+      "spot"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "description": "Mix of spot inks (name → tint).",
+    "properties": {
+      "inks": {
+        "additionalProperties": {
+          "maximum": 1,
+          "minimum": 0,
+          "type": "number"
+        },
+        "maxProperties": 8,
+        "minProperties": 1,
+        "type": "object"
+      }
+    },
+    "required": [
+      "inks"
+    ],
+    "type": "object"
+  }
+]

changedInput schema / properties / headerTemplate / properties / color / anyOf

Previous value: -[
-  {
-    "pattern": "^#[0-9a-fA-F]{6}$",
-    "type": "string"
-  },
-  {
-    "description": "DeviceCMYK operands 'C M Y K', each 0.0–1.0.",
-    "pattern": "^(?:0(?:\\.\\d+)?|1(?:\\.0+)?)(?: (?:0(?:\\.\\d+)?|1(?:\\.0+)?)){3}$",
-    "type": "string"
-  },
-  {
-    "description": "DeviceCMYK ink percentages [c, m, y, k], each 0–100.",
-    "items": {
-      "maximum": 100,
-      "minimum": 0,
-      "type": "number"
-    },
-    "maxItems": 4,
-    "minItems": 4,
-    "type": "array"
-  }
-]New value: +[
+  {
+    "pattern": "^#[0-9a-fA-F]{6}$",
+    "type": "string"
+  },
+  {
+    "description": "DeviceCMYK operands 'C M Y K', each 0.0–1.0.",
+    "pattern": "^(?:0(?:\\.\\d+)?|1(?:\\.0+)?)(?: (?:0(?:\\.\\d+)?|1(?:\\.0+)?)){3}$",
+    "type": "string"
+  },
+  {
+    "description": "DeviceCMYK ink percentages [c, m, y, k], each 0–100.",
+    "items": {
+      "maximum": 100,
+      "minimum": 0,
+      "type": "number"
+    },
+    "maxItems": 4,
+    "minItems": 4,
+    "type": "array"
+  },
+  {
+    "additionalProperties": false,
+    "description": "Spot ink of print.spotColours, tint 0–1.",
+    "properties": {
+      "spot": {
+        "maxLength": 100,
+        "minLength": 1,
+        "type": "string"
+      },
+      "tint": {
+        "maximum": 1,
+        "minimum": 0,
+        "type": "number"
+      }
+    },
+    "required": [
+      "spot"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "description": "Mix of spot inks (name → tint).",
+    "properties": {
+      "inks": {
+        "additionalProperties": {
+          "maximum": 1,
+          "minimum": 0,
+          "type": "number"
+        },
+        "maxProperties": 8,
+        "minProperties": 1,
+        "type": "object"
+      }
+    },
+    "required": [
+      "inks"
+    ],
+    "type": "object"
+  }
+]

changedInput schema / properties / includeDiagnostics / description

Previous value: -"Return the diagnostics raised while building (PDFA_*, PDFX_*, TYPOGRAPHY_*) as `diagnostics[]` (possibly empty)."New value: +"Return the diagnostics raised while building (PDFA_*, PDFX_*, TYPOGRAPHY_*, TEXT_GLYPH_NOT_COVERED) as `diagnostics[]` (possibly empty)."

changedInput schema / properties / pdfx / description

Previous value: -"PDF/X-4 print exchange (ISO 15930-7). REQUIRES outputIntent with the printer's ICC profile (device class 'prtr'; CMYK or Gray — none is bundled); needs embedFonts:true for a conformant file (PDFX_NO_FONT_ENTRIES otherwise, strict:true refuses). Exclusive with pdfA and encrypt; metadata.trapped must be 'True' or 'False'; TrimBox or ArtBox, not both. Links and form fields are reported (PDFX_ANNOTATIONS). Check with validate_pdf standard:'pdf-x-4'. See the print_ready prompt."New value: +"PDF/X-4 print exchange (ISO 15930-7). REQUIRES outputIntent with the printer's ICC profile (device class 'prtr'; CMYK or Gray — none is bundled); needs embedFonts:true for a conformant file (PDFX_NO_FONT_ENTRIES otherwise, strict:true refuses). Combines with pdfA:'pdfa2b' | 'pdfa2u' (dual claim) but not pdfa1b / pdfa3b; exclusive with encrypt; metadata.trapped must be 'True' or 'False'; TrimBox or ArtBox, not both. Links and form fields are reported (PDFX_ANNOTATIONS). Check with validate_pdf standard:'pdf-x-4'. See the print_ready prompt."

changedInput schema / properties / print / description

Previous value: -"Print production (ISO 32000-1 §14.11): page boxes, `bleed` shorthand (TrimBox = MediaBox inset), crop/registration marks outside the TrimBox, /UserUnit for large formats (PDF 1.7; not under pdfa1b). See docs/guides/PRINT.md."New value: +"Print production (ISO 32000-1 §14.11): page boxes, `bleed` shorthand (TrimBox = MediaBox inset), crop/registration marks outside the TrimBox, /UserUnit for large formats (PDF 1.7; not under pdfa1b), `spotColours` ink declarations. See docs/guides/PRINT.md."

addedInput schema / properties / print / properties / spotColours

Added value: +{
+  "description": "Spot inks (/Separation plates) the document may paint with { spot:'name', tint } or { inks:{ name: tint } } anywhere a colour is accepted. Undeclared ink → VALIDATION_ERROR; blank or duplicate name → PRINT_ERROR (an empty string is VALIDATION_ERROR).",
+  "items": {
+    "additionalProperties": false,
+    "properties": {
+      "alternate": {
+        "anyOf": [
+          {
+            "items": {
+              "maximum": 100,
+              "minimum": 0,
+              "type": "number"
+            },
+            "maxItems": 4,
+            "minItems": 4,
+            "type": "array"
+          },
+          {
+            "items": {
+              "maximum": 255,
+              "minimum": 0,
+              "type": "number"
+            },
+            "maxItems": 3,
+            "minItems": 3,
+            "type": "array"
+          }
+        ],
+        "description": "Process alternate for proofing: [c, m, y, k] 0–100 or [r, g, b] 0–255."
+      },
+      "name": {
+        "description": "'PANTONE 300 C', 'Varnish', …",
+        "maxLength": 100,
+        "minLength": 1,
+        "type": "string"
+      }
+    },
+    "required": [
+      "name",
+      "alternate"
+    ],
+    "type": "object"
+  },
+  "maxItems": 32,
+  "minItems": 1,
+  "type": "array"
+}

changedInput schema / properties / strict / description

Previous value: -"Fail instead of producing a file the engine warns about: a PDFA_* diagnostic → PDF_A_COMPLIANCE_VIOLATION (e.g. PDFA_NO_FONT_ENTRIES without embedFonts), a PDFX_* one → PDF_X_COMPLIANCE_VIOLATION, any other → DIAGNOSTIC_ESCALATED. Pair with embedFonts=true."New value: +"Fail instead of producing a file the engine warns about: a PDFA_* diagnostic → PDF_A_COMPLIANCE_VIOLATION (e.g. PDFA_NO_FONT_ENTRIES without embedFonts), a PDFX_* one → PDF_X_COMPLIANCE_VIOLATION, any other (TYPOGRAPHY_FEATURE_INEFFECTIVE, TEXT_GLYPH_NOT_COVERED — a character no font covers, drawn as a box or '?') → DIAGNOSTIC_ESCALATED. Pair with embedFonts=true."

changedInput schema / properties / typography / description

Previous value: -"Fine typography, all opt-in (omitted = unchanged bytes). kerning, fontFeatures and the 'fr' narrow space need embedFonts:true. No hyphenation dictionary is installed: use soft hyphens (U+00AD). See the typography prompt."New value: +"Fine typography, all opt-in (omitted = unchanged bytes). kerning and fontFeatures need embedFonts:true ('fr' works on base-14 too). No hyphenation dictionary is installed: use soft hyphens (U+00AD). See the typography prompt."

changedInput schema / properties / typography / properties / punctuationSpacing / anyOf

Previous value: -[
-  {
-    "enum": [
-      "fr",
-      "fr-CA"
-    ],
-    "type": "string"
-  },
-  {
-    "items": {
-      "additionalProperties": false,
-      "properties": {
-        "char": {
-          "maxLength": 2,
-          "minLength": 1,
-          "type": "string"
-        },
-        "side": {
-          "enum": [
-            "before",
-            "after"
-          ],
-          "type": "string"
-        },
-        "space": {
-          "description": "U+00A0 / U+202F (narrow needs embedFonts).",
-          "enum": [
-            "nbsp",
-            "narrow"
-          ],
-          "type": "string"
-        }
-      },
-      "required": [
-        "char",
-        "side",
-        "space"
-      ],
-      "type": "object"
-    },
-    "maxItems": 32,
-    "type": "array"
-  }
-]New value: +[
+  {
+    "enum": [
+      "fr",
+      "fr-CA"
+    ],
+    "type": "string"
+  },
+  {
+    "items": {
+      "additionalProperties": false,
+      "properties": {
+        "char": {
+          "maxLength": 2,
+          "minLength": 1,
+          "type": "string"
+        },
+        "side": {
+          "enum": [
+            "before",
+            "after"
+          ],
+          "type": "string"
+        },
+        "space": {
+          "description": "U+00A0 / U+202F (narrow: a TJ adjustment on base-14, the glyph on an embedded font).",
+          "enum": [
+            "nbsp",
+            "narrow"
+          ],
+          "type": "string"
+        }
+      },
+      "required": [
+        "char",
+        "side",
+        "space"
+      ],
+      "type": "object"
+    },
+    "maxItems": 32,
+    "type": "array"
+  }
+]

changedInput schema / properties / watermark / description

Previous value: -"Optional semi-transparent watermark rendered centred on every page: `text` (e.g. 'DRAFT'), `image` (JPEG/PNG), or both combined. At least one of text / image is required. opacity < 1.0 (text or image, including the defaults) is rejected under pdfA='pdfa1b' (ISO 19005-1 forbids transparency)."New value: +"Optional semi-transparent watermark rendered centred on every page: `text` (e.g. 'DRAFT'), `image` (JPEG/PNG/JPEG 2000), or both combined. At least one of text / image is required. opacity < 1.0 (text or image, including the defaults) is rejected under pdfA='pdfa1b' (ISO 19005-1 forbids transparency)."

changedInput schema / properties / watermark / properties / color / anyOf

Previous value: -[
-  {
-    "items": {
-      "maximum": 1,
-      "minimum": 0,
-      "type": "number"
-    },
-    "maxItems": 3,
-    "minItems": 3,
-    "type": "array"
-  },
-  {
-    "description": "DeviceCMYK operands 'C M Y K', each 0.0–1.0.",
-    "pattern": "^(?:0(?:\\.\\d+)?|1(?:\\.0+)?)(?: (?:0(?:\\.\\d+)?|1(?:\\.0+)?)){3}$",
-    "type": "string"
-  },
-  {
-    "description": "DeviceCMYK ink percentages [c, m, y, k], each 0–100.",
-    "items": {
-      "maximum": 100,
-      "minimum": 0,
-      "type": "number"
-    },
-    "maxItems": 4,
-    "minItems": 4,
-    "type": "array"
-  }
-]New value: +[
+  {
+    "items": {
+      "maximum": 1,
+      "minimum": 0,
+      "type": "number"
+    },
+    "maxItems": 3,
+    "minItems": 3,
+    "type": "array"
+  },
+  {
+    "description": "DeviceCMYK operands 'C M Y K', each 0.0–1.0.",
+    "pattern": "^(?:0(?:\\.\\d+)?|1(?:\\.0+)?)(?: (?:0(?:\\.\\d+)?|1(?:\\.0+)?)){3}$",
+    "type": "string"
+  },
+  {
+    "description": "DeviceCMYK ink percentages [c, m, y, k], each 0–100.",
+    "items": {
+      "maximum": 100,
+      "minimum": 0,
+      "type": "number"
+    },
+    "maxItems": 4,
+    "minItems": 4,
+    "type": "array"
+  },
+  {
+    "additionalProperties": false,
+    "description": "Spot ink of print.spotColours, tint 0–1.",
+    "properties": {
+      "spot": {
+        "maxLength": 100,
+        "minLength": 1,
+        "type": "string"
+      },
+      "tint": {
+        "maximum": 1,
+        "minimum": 0,
+        "type": "number"
+      }
+    },
+    "required": [
+      "spot"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "description": "Mix of spot inks (name → tint).",
+    "properties": {
+      "inks": {
+        "additionalProperties": {
+          "maximum": 1,
+          "minimum": 0,
+          "type": "number"
+        },
+        "maxProperties": 8,
+        "minProperties": 1,
+        "type": "object"
+      }
+    },
+    "required": [
+      "inks"
+    ],
+    "type": "object"
+  }
+]

changedInput schema / properties / watermark / properties / image / description

Previous value: -"Image watermark (JPEG or PNG) centred on every page, optionally combined with `text`. Bytes are validated against the JPEG/PNG magic numbers; mimeType must match."New value: +"Image watermark (JPEG, PNG or JPEG 2000) centred on every page, optionally combined with `text`. Bytes are validated against the format magic numbers; mimeType must match."

changedInput schema / properties / watermark / properties / image / properties / imageBase64 / description

Previous value: -"Base64-encoded JPEG or 8-bit opaque PNG bytes (max 8 MiB decoded; alpha-channel, palette and interlaced PNGs are rejected with a remedy). Plain base64, no data: URI prefix."New value: +"Base64-encoded JPEG, 8-bit opaque PNG or JPEG 2000 (JP2 / raw codestream) bytes (max 8 MiB decoded; alpha-channel, palette and interlaced PNGs are rejected with a remedy; a JPEG 2000 opacity channel raises PDFA_JPX_IMAGE under PDF/A). Plain base64, no data: URI prefix."

changedInput schema / properties / watermark / properties / image / properties / mimeType / description

Previous value: -"'image/jpeg' or 'image/png' — must match the actual bytes."New value: +"'image/jpeg', 'image/png' or 'image/jp2' — must match the actual bytes."

changedInput schema / properties / watermark / properties / image / properties / mimeType / enum

Previous value: -[
-  "image/jpeg",
-  "image/png"
-]New value: +[
+  "image/jpeg",
+  "image/png",
+  "image/jp2"
+]

changedOutput schema / description

Previous value: -"Result of a PDF-producing tool. base64 mode: the PDF arrives as an embedded `resource` content block (not duplicated here); file mode: `filePath`."New value: +"Result of a PDF-producing tool. base64 mode: the PDF arrives as an embedded `resource` content block (not duplicated here); file mode: `filePath` (and `url` when the operator maps the sandbox to a public base URL)."

addedOutput schema / properties / url

Added value: +{
+  "description": "Public URL of the file (file mode, only when PDFNATIVE_MCP_OUTPUT_BASE_URL is set): base URL + sandbox-relative path, percent-encoded.",
+  "type": "string"
+}

Changed32 schema fields changedv1.6.2Sep 27, 2026

addedInput schema / properties / cellBorders / properties / color / anyOf

Added value: +[
+  {
+    "type": "string"
+  },
+  {
+    "description": "DeviceCMYK ink percentages [c, m, y, k], each 0–100.",
+    "items": {
+      "maximum": 100,
+      "minimum": 0,
+      "type": "number"
+    },
+    "maxItems": 4,
+    "minItems": 4,
+    "type": "array"
+  }
+]

removedInput schema / properties / cellBorders / properties / color / type
```
Removed value: -"string"
```

changedInput schema / properties / creationDate / description

Previous value: -"ISO-8601 instant for /CreationDate (+ XMP). Pin it for byte-identical output across calls (same host TZ); omitted = wall clock, so every call differs."New value: +"ISO-8601 instant for /CreationDate (+ XMP, the trailer /ID and the {date} placeholder), written in UTC. Pin it for byte-identical output across calls and hosts; omitted = wall clock, so every call differs."

changedInput schema / properties / embedFonts / description

Previous value: -"Embed Noto Sans Latin instead of the viewer base-14 Helvetica. REQUIRED for a valid PDF/A claim (ISO 19005 §6.2.11.4.1) and for strict=true; adds ~0.3 MiB."New value: +"Embed Noto Sans Latin instead of the viewer base-14 Helvetica. REQUIRED for a valid PDF/A or PDF/X claim (every font embedded) and for strict=true; adds ~0.3 MiB."

changedInput schema / properties / footerTemplate / properties / center / description

Previous value: -"Placeholders: {page} {pages} {title} {date} (build-day wall clock, not creationDate)."New value: +"Placeholders: {page} {pages} {title} {date} (UTC date of creationDate when pinned, else of the build)."

addedInput schema / properties / footerTemplate / properties / color / anyOf

Added value: +[
+  {
+    "pattern": "^#[0-9a-fA-F]{6}$",
+    "type": "string"
+  },
+  {
+    "description": "DeviceCMYK operands 'C M Y K', each 0.0–1.0.",
+    "pattern": "^(?:0(?:\\.\\d+)?|1(?:\\.0+)?)(?: (?:0(?:\\.\\d+)?|1(?:\\.0+)?)){3}$",
+    "type": "string"
+  },
+  {
+    "description": "DeviceCMYK ink percentages [c, m, y, k], each 0–100.",
+    "items": {
+      "maximum": 100,
+      "minimum": 0,
+      "type": "number"
+    },
+    "maxItems": 4,
+    "minItems": 4,
+    "type": "array"
+  }
+]

changedInput schema / properties / footerTemplate / properties / color / description
```
Previous value: -"Hex colour."New value: +"Hex colour (#RRGGBB)."
```
removedInput schema / properties / footerTemplate / properties / color / pattern
```
Removed value: -"^#[0-9a-fA-F]{6}$"
```
removedInput schema / properties / footerTemplate / properties / color / type
```
Removed value: -"string"
```

changedInput schema / properties / footerTemplate / properties / left / description

Previous value: -"Placeholders: {page} {pages} {title} {date} (build-day wall clock, not creationDate)."New value: +"Placeholders: {page} {pages} {title} {date} (UTC date of creationDate when pinned, else of the build)."

changedInput schema / properties / footerTemplate / properties / right / description

Previous value: -"Placeholders: {page} {pages} {title} {date} (build-day wall clock, not creationDate)."New value: +"Placeholders: {page} {pages} {title} {date} (UTC date of creationDate when pinned, else of the build)."

changedInput schema / properties / headerTemplate / properties / center / description

Previous value: -"Placeholders: {page} {pages} {title} {date} (build-day wall clock, not creationDate)."New value: +"Placeholders: {page} {pages} {title} {date} (UTC date of creationDate when pinned, else of the build)."

addedInput schema / properties / headerTemplate / properties / color / anyOf

Added value: +[
+  {
+    "pattern": "^#[0-9a-fA-F]{6}$",
+    "type": "string"
+  },
+  {
+    "description": "DeviceCMYK operands 'C M Y K', each 0.0–1.0.",
+    "pattern": "^(?:0(?:\\.\\d+)?|1(?:\\.0+)?)(?: (?:0(?:\\.\\d+)?|1(?:\\.0+)?)){3}$",
+    "type": "string"
+  },
+  {
+    "description": "DeviceCMYK ink percentages [c, m, y, k], each 0–100.",
+    "items": {
+      "maximum": 100,
+      "minimum": 0,
+      "type": "number"
+    },
+    "maxItems": 4,
+    "minItems": 4,
+    "type": "array"
+  }
+]

changedInput schema / properties / headerTemplate / properties / color / description
```
Previous value: -"Hex colour."New value: +"Hex colour (#RRGGBB)."
```
removedInput schema / properties / headerTemplate / properties / color / pattern
```
Removed value: -"^#[0-9a-fA-F]{6}$"
```
removedInput schema / properties / headerTemplate / properties / color / type
```
Removed value: -"string"
```

changedInput schema / properties / headerTemplate / properties / left / description

Previous value: -"Placeholders: {page} {pages} {title} {date} (build-day wall clock, not creationDate)."New value: +"Placeholders: {page} {pages} {title} {date} (UTC date of creationDate when pinned, else of the build)."

changedInput schema / properties / headerTemplate / properties / right / description

Previous value: -"Placeholders: {page} {pages} {title} {date} (build-day wall clock, not creationDate)."New value: +"Placeholders: {page} {pages} {title} {date} (UTC date of creationDate when pinned, else of the build)."

changedInput schema / properties / includeDiagnostics / description

Previous value: -"Return the PDF/A diagnostics raised while building as `diagnostics[]` (possibly empty)."New value: +"Return the diagnostics raised while building (PDFA_*, PDFX_*, TYPOGRAPHY_*) as `diagnostics[]` (possibly empty)."

changedInput schema / properties / outputIntent / description

Previous value: -"Custom PDF/A OutputIntent: an RGB ICC profile + condition strings replacing the built-in sRGB intent (CMYK rejected)."New value: +"Custom OutputIntent (under pdfA or pdfx): an RGB, CMYK or Gray ICC profile + condition strings, replacing the built-in sRGB intent. The profile must be a real ICC file ('acsp' signature, consistent size — PRINT_ERROR otherwise); pdfx needs device class 'prtr'. Under a CMYK / Gray intent RGB content is mapped through a calibrated default space."

changedInput schema / properties / outputIntent / properties / iccProfileBase64 / description

Previous value: -"ICC profile bytes, base64 (RGB, ≤ 8 MiB)."New value: +"ICC profile bytes, base64 (RGB, CMYK or Gray; ≤ 8 MiB)."

addedInput schema / properties / pdfx

Added value: +{
+  "description": "PDF/X-4 print exchange (ISO 15930-7). REQUIRES outputIntent with the printer's ICC profile (device class 'prtr'; CMYK or Gray — none is bundled); needs embedFonts:true for a conformant file (PDFX_NO_FONT_ENTRIES otherwise, strict:true refuses). Exclusive with pdfA and encrypt; metadata.trapped must be 'True' or 'False'; TrimBox or ArtBox, not both. Links and form fields are reported (PDFX_ANNOTATIONS). Check with validate_pdf standard:'pdf-x-4'. See the print_ready prompt.",
+  "enum": [
+    "pdfx4"
+  ],
+  "type": "string"
+}

changedInput schema / properties / print / properties / marks / oneOf

Previous value: -[
-  {
-    "type": "boolean"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "crop": {
-        "description": "Corner crop (trim) marks. Default true.",
-        "type": "boolean"
-      },
-      "length": {
-        "description": "Mark length in points. Default 14.",
-        "maximum": 100,
-        "minimum": 1,
-        "type": "number"
-      },
-      "offset": {
-        "description": "Gap between TrimBox and marks in points. Default 5.",
-        "maximum": 100,
-        "minimum": 0,
-        "type": "number"
-      },
-      "registration": {
-        "description": "Edge-midpoint registration targets. Default true.",
-        "type": "boolean"
-      },
-      "weight": {
-        "description": "Stroke width in points. Default 0.25.",
-        "maximum": 5,
-        "minimum": 0.05,
-        "type": "number"
-      }
-    },
-    "type": "object"
-  }
-]New value: +[
+  {
+    "type": "boolean"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "colourBars": {
+        "anyOf": [
+          {
+            "type": "boolean"
+          },
+          {
+            "additionalProperties": false,
+            "properties": {
+              "size": {
+                "description": "Patch size in points. Default 12.",
+                "maximum": 72,
+                "minimum": 4,
+                "type": "number"
+              },
+              "tints": {
+                "description": "Add the four 50 % tint patches. Default true.",
+                "type": "boolean"
+              }
+            },
+            "type": "object"
+          }
+        ],
+        "description": "Colour control strip in the bleed (C M Y K solids + their 50 % tints): true for defaults. Off by default; needs a bleed of about 5 mm (14.17 pt) and is skipped when the strip would not fit."
+      },
+      "crop": {
+        "description": "Corner crop (trim) marks. Default true.",
+        "type": "boolean"
+      },
+      "length": {
+        "description": "Mark length in points. Default 14.",
+        "maximum": 100,
+        "minimum": 1,
+        "type": "number"
+      },
+      "offset": {
+        "description": "Gap between TrimBox and marks in points. Default 5.",
+        "maximum": 100,
+        "minimum": 0,
+        "type": "number"
+      },
+      "registration": {
+        "description": "Edge-midpoint registration targets. Default true.",
+        "type": "boolean"
+      },
+      "weight": {
+        "description": "Stroke width in points. Default 0.25.",
+        "maximum": 5,
+        "minimum": 0.05,
+        "type": "number"
+      }
+    },
+    "type": "object"
+  }
+]

changedInput schema / properties / strict / description

Previous value: -"Fail with PDF_A_COMPLIANCE_VIOLATION instead of producing a non-conformant PDF/A file (e.g. PDFA_NO_FONT_ENTRIES without embedFonts). Pair with embedFonts=true."New value: +"Fail instead of producing a file the engine warns about: a PDFA_* diagnostic → PDF_A_COMPLIANCE_VIOLATION (e.g. PDFA_NO_FONT_ENTRIES without embedFonts), a PDFX_* one → PDF_X_COMPLIANCE_VIOLATION, any other → DIAGNOSTIC_ESCALATED. Pair with embedFonts=true."

addedInput schema / properties / typography

Added value: +{
+  "additionalProperties": false,
+  "description": "Fine typography, all opt-in (omitted = unchanged bytes). kerning, fontFeatures and the 'fr' narrow space need embedFonts:true. No hyphenation dictionary is installed: use soft hyphens (U+00AD). See the typography prompt.",
+  "properties": {
+    "bindShortWords": {
+      "anyOf": [
+        {
+          "type": "boolean"
+        },
+        {
+          "additionalProperties": false,
+          "properties": {
+            "maxLength": {
+              "maximum": 3,
+              "minimum": 1,
+              "type": "integer"
+            },
+            "words": {
+              "items": {
+                "maxLength": 16,
+                "minLength": 1,
+                "type": "string"
+              },
+              "maxItems": 100,
+              "type": "array"
+            }
+          },
+          "type": "object"
+        }
+      ],
+      "description": "Never end a line on a short word: up to maxLength letters (default 1), or exactly the listed words."
+    },
+    "fontFeatures": {
+      "description": "OpenType features, later wins. tnum / lnum are no-ops on Noto Sans (TYPOGRAPHY_FEATURE_INEFFECTIVE).",
+      "items": {
+        "enum": [
+          "tnum",
+          "pnum",
+          "lnum",
+          "onum",
+          "zero",
+          "ordn",
+          "sups",
+          "subs",
+          "smcp",
+          "c2sc",
+          "case"
+        ],
+        "type": "string"
+      },
+      "maxItems": 11,
+      "type": "array",
+      "uniqueItems": true
+    },
+    "hyphenationLanguage": {
+      "description": "BCP 47 tag; no effect here (no hyphenation provider installed).",
+      "maxLength": 35,
+      "pattern": "^[A-Za-z]{2,3}(?:-[A-Za-z0-9]{2,8})*$",
+      "type": "string"
+    },
+    "keepHeadingsWithNext": {
+      "anyOf": [
+        {
+          "type": "boolean"
+        },
+        {
+          "additionalProperties": false,
+          "properties": {
+            "minLines": {
+              "maximum": 10,
+              "minimum": 1,
+              "type": "integer"
+            }
+          },
+          "type": "object"
+        }
+      ],
+      "description": "Never strand a heading at a page foot. true = { minLines: 2 }."
+    },
+    "kerning": {
+      "description": "Pair kerning (GPOS).",
+      "type": "boolean"
+    },
+    "metrics": {
+      "description": "Base-14 text: 'exact' uses the AFM widths (different wraps). Default 'approximate'.",
+      "enum": [
+        "approximate",
+        "exact"
+      ],
+      "type": "string"
+    },
+    "opticalMargins": {
+      "description": "Hang punctuation into the margin of align:'justify' text.",
+      "type": "boolean"
+    },
+    "orphans": {
+      "description": "Min lines left at a page foot (default 2; needs splitParagraphs).",
+      "maximum": 10,
+      "minimum": 1,
+      "type": "integer"
+    },
+    "punctuationSpacing": {
+      "anyOf": [
+        {
+          "enum": [
+            "fr",
+            "fr-CA"
+          ],
+          "type": "string"
+        },
+        {
+          "items": {
+            "additionalProperties": false,
+            "properties": {
+              "char": {
+                "maxLength": 2,
+                "minLength": 1,
+                "type": "string"
+              },
+              "side": {
+                "enum": [
+                  "before",
+                  "after"
+                ],
+                "type": "string"
+              },
+              "space": {
+                "description": "U+00A0 / U+202F (narrow needs embedFonts).",
+                "enum": [
+                  "nbsp",
+                  "narrow"
+                ],
+                "type": "string"
+              }
+            },
+            "required": [
+              "char",
+              "side",
+              "space"
+            ],
+            "type": "object"
+          },
+          "maxItems": 32,
+          "type": "array"
+        }
+      ],
+      "description": "No-break spaces next to punctuation (existing spaces only). 'fr': narrow before ; ! ?, no-break before ':' and inside « ». 'fr-CA': ':' and « » only. Or explicit rules."
+    },
+    "splitParagraphs": {
+      "description": "Paragraphs may break across pages at a line boundary (default: atomic).",
+      "type": "boolean"
+    },
+    "unitBinding": {
+      "anyOf": [
+        {
+          "type": "boolean"
+        },
+        {
+          "additionalProperties": false,
+          "properties": {
+            "units": {
+              "items": {
+                "maxLength": 16,
+                "minLength": 1,
+                "type": "string"
+              },
+              "maxItems": 100,
+              "type": "array"
+            }
+          },
+          "type": "object"
+        }
+      ],
+      "description": "No-break space between a number and its unit ('150 €', '12 kg'); units replaces the built-in list."
+    },
+    "widows": {
+      "description": "Min lines carried over (default 2; needs splitParagraphs).",
+      "maximum": 10,
+      "minimum": 1,
+      "type": "integer"
+    }
+  },
+  "type": "object"
+}

addedInput schema / properties / watermark / properties / color / anyOf

Added value: +[
+  {
+    "items": {
+      "maximum": 1,
+      "minimum": 0,
+      "type": "number"
+    },
+    "maxItems": 3,
+    "minItems": 3,
+    "type": "array"
+  },
+  {
+    "description": "DeviceCMYK operands 'C M Y K', each 0.0–1.0.",
+    "pattern": "^(?:0(?:\\.\\d+)?|1(?:\\.0+)?)(?: (?:0(?:\\.\\d+)?|1(?:\\.0+)?)){3}$",
+    "type": "string"
+  },
+  {
+    "description": "DeviceCMYK ink percentages [c, m, y, k], each 0–100.",
+    "items": {
+      "maximum": 100,
+      "minimum": 0,
+      "type": "number"
+    },
+    "maxItems": 4,
+    "minItems": 4,
+    "type": "array"
+  }
+]

changedInput schema / properties / watermark / properties / color / description

Previous value: -"Text RGB colour as a [r, g, b] triple in the 0.0–1.0 range. Default light gray [0.75, 0.75, 0.75]."New value: +"Text colour. RGB as a [r, g, b] triple in the 0.0–1.0 range; default light gray [0.75, 0.75, 0.75]."

removedInput schema / properties / watermark / properties / color / items

Removed value: -{
-  "maximum": 1,
-  "minimum": 0,
-  "type": "number"
-}

removedInput schema / properties / watermark / properties / color / maxItems
```
Removed value: -3
```
removedInput schema / properties / watermark / properties / color / minItems
```
Removed value: -3
```
removedInput schema / properties / watermark / properties / color / type
```
Removed value: -"array"
```

changedOutput schema / properties / diagnostics / description

Previous value: -"PDF/A diagnostics (when includeDiagnostics=true)."New value: +"Engine diagnostics (when includeDiagnostics=true)."

Changed42 schema fields changedAug 24, 2026

changedInput schema / properties / autoFitColumns / description

Previous value: -"When true, column widths auto-fit content (pdfnative v1.1). Switches the backend to buildDocumentPDFBytes; byte output differs from the default path."New value: +"Auto-fit column widths to content. Output bytes then depend on text metrics (not byte-deterministic across content changes)."

changedInput schema / properties / caption / description

Previous value: -"Caption rendered above the table (and emitted as /Caption structure element in tagged/PDF/A mode). pdfnative v1.2."New value: +"Caption rendered above the table (tagged as /Caption under PDF/A)."

changedInput schema / properties / cellBorders / description

Previous value: -"Per-cell vector borders (pdfnative v1.4). Switches the backend to buildDocumentPDFBytes. Choose individual sides or `all`."New value: +"Per-cell vector borders (pure strokes, PDF/A-safe). Choose individual sides or `all`."

changedInput schema / properties / cellPadding / description

Previous value: -"Horizontal cell padding in points applied to both insets (default 3). pdfnative v1.2."New value: +"Horizontal cell padding in points (default 3)."

changedInput schema / properties / cellVAlign / description

Previous value: -"Vertical alignment of cell content (pdfnative v1.4). Switches the backend to buildDocumentPDFBytes."New value: +"Vertical alignment of cell content."

changedInput schema / properties / clipCells / description

Previous value: -"When true, cell contents are clipped to column bounds via PDF clip-path operators (pdfnative v1.1). Recommended for PDF/A and visual safety. Switches the backend to buildDocumentPDFBytes."New value: +"Clip cell contents to the column bounds (PDF clip operators). Recommended for PDF/A and visual safety."

addedInput schema / properties / compress

Added value: +{
+  "description": "FlateDecode the streams (smaller file, different bytes; PDF/A unaffected, XMP stays plain). Default false.",
+  "type": "boolean"
+}

addedInput schema / properties / creationDate

Added value: +{
+  "description": "ISO-8601 instant for /CreationDate (+ XMP). Pin it for byte-identical output across calls (same host TZ); omitted = wall clock, so every call differs.",
+  "format": "date-time",
+  "type": "string"
+}

addedInput schema / properties / debug

Added value: +{
+  "description": "Draw margin / block / cell guide rectangles (unmarked content — not for PDF/UA output). Geometry unchanged. Default false.",
+  "type": "boolean"
+}

addedInput schema / properties / embedFonts

Added value: +{
+  "default": false,
+  "description": "Embed Noto Sans Latin instead of the viewer base-14 Helvetica. REQUIRED for a valid PDF/A claim (ISO 19005 §6.2.11.4.1) and for strict=true; adds ~0.3 MiB.",
+  "type": "boolean"
+}

addedInput schema / properties / encrypt

Added value: +{
+  "additionalProperties": false,
+  "description": "Encrypt at build time (AES-128 default / AES-256) and KEEP the AcroForm — unlike encrypt_pdf, which rebuilds the page tree. Exclusive with pdfA. Randomised output, never cached.",
+  "properties": {
+    "algorithm": {
+      "default": "aes128",
+      "description": "aes128 (V4/R4, widest compatibility) or aes256 (V5/R6).",
+      "enum": [
+        "aes128",
+        "aes256"
+      ],
+      "type": "string"
+    },
+    "ownerPassword": {
+      "description": "Owner password (full access).",
+      "maxLength": 4096,
+      "minLength": 1,
+      "type": "string"
+    },
+    "permissions": {
+      "additionalProperties": false,
+      "description": "Permission flags; each defaults to allowed.",
+      "properties": {
+        "copy": {
+          "type": "boolean"
+        },
+        "extractText": {
+          "type": "boolean"
+        },
+        "modify": {
+          "type": "boolean"
+        },
+        "print": {
+          "type": "boolean"
+        }
+      },
+      "type": "object"
+    },
+    "userPassword": {
+      "description": "Open password; omitted/empty = opens without a prompt.",
+      "maxLength": 4096,
+      "type": "string"
+    }
+  },
+  "required": [
+    "ownerPassword"
+  ],
+  "type": "object"
+}

addedInput schema / properties / footerTemplate

Added value: +{
+  "additionalProperties": false,
+  "description": "Running footer on every page. Replaces the default footer: footerText is then ignored and page numbers appear only via {page}/{pages}.",
+  "properties": {
+    "center": {
+      "description": "Placeholders: {page} {pages} {title} {date} (build-day wall clock, not creationDate).",
+      "maxLength": 200,
+      "type": "string"
+    },
+    "color": {
+      "description": "Hex colour.",
+      "pattern": "^#[0-9a-fA-F]{6}$",
+      "type": "string"
+    },
+    "fontSize": {
+      "description": "Default 7.",
+      "maximum": 14,
+      "minimum": 6,
+      "type": "number"
+    },
+    "left": {
+      "description": "Placeholders: {page} {pages} {title} {date} (build-day wall clock, not creationDate).",
+      "maxLength": 200,
+      "type": "string"
+    },
+    "right": {
+      "description": "Placeholders: {page} {pages} {title} {date} (build-day wall clock, not creationDate).",
+      "maxLength": 200,
+      "type": "string"
+    }
+  },
+  "type": "object"
+}

addedInput schema / properties / headerTemplate

Added value: +{
+  "additionalProperties": false,
+  "description": "Running header on every page (left / center / right zones); reserves 15 pt.",
+  "properties": {
+    "center": {
+      "description": "Placeholders: {page} {pages} {title} {date} (build-day wall clock, not creationDate).",
+      "maxLength": 200,
+      "type": "string"
+    },
+    "color": {
+      "description": "Hex colour.",
+      "pattern": "^#[0-9a-fA-F]{6}$",
+      "type": "string"
+    },
+    "fontSize": {
+      "description": "Default 7.",
+      "maximum": 14,
+      "minimum": 6,
+      "type": "number"
+    },
+    "left": {
+      "description": "Placeholders: {page} {pages} {title} {date} (build-day wall clock, not creationDate).",
+      "maxLength": 200,
+      "type": "string"
+    },
+    "right": {
+      "description": "Placeholders: {page} {pages} {title} {date} (build-day wall clock, not creationDate).",
+      "maxLength": 200,
+      "type": "string"
+    }
+  },
+  "type": "object"
+}

addedInput schema / properties / includeDiagnostics

Added value: +{
+  "default": false,
+  "description": "Return the PDF/A diagnostics raised while building as `diagnostics[]` (possibly empty).",
+  "type": "boolean"
+}

addedInput schema / properties / margins

Added value: +{
+  "additionalProperties": false,
+  "description": "Margins in points, all four required (0–200). Default 45 / 36 / 35 / 36.",
+  "properties": {
+    "bottom": {
+      "maximum": 200,
+      "minimum": 0,
+      "type": "number"
+    },
+    "left": {
+      "maximum": 200,
+      "minimum": 0,
+      "type": "number"
+    },
+    "right": {
+      "maximum": 200,
+      "minimum": 0,
+      "type": "number"
+    },
+    "top": {
+      "maximum": 200,
+      "minimum": 0,
+      "type": "number"
+    }
+  },
+  "required": [
+    "top",
+    "right",
+    "bottom",
+    "left"
+  ],
+  "type": "object"
+}

addedInput schema / properties / metadata

Added value: +{
+  "additionalProperties": false,
+  "description": "/Info (+ XMP under PDF/A): author, subject, keywords, /Trapped.",
+  "properties": {
+    "author": {
+      "maxLength": 500,
+      "type": "string"
+    },
+    "keywords": {
+      "maxLength": 1000,
+      "type": "string"
+    },
+    "subject": {
+      "maxLength": 1000,
+      "type": "string"
+    },
+    "trapped": {
+      "description": "/Trapped print flag.",
+      "enum": [
+        "True",
+        "False",
+        "Unknown"
+      ],
+      "type": "string"
+    }
+  },
+  "type": "object"
+}

changedInput schema / properties / minRowHeight / description

Previous value: -"Minimum row height in points (default 12). pdfnative v1.2."New value: +"Minimum row height in points (default 12)."

addedInput schema / properties / outputIntent

Added value: +{
+  "additionalProperties": false,
+  "description": "Custom PDF/A OutputIntent: an RGB ICC profile + condition strings replacing the built-in sRGB intent (CMYK rejected).",
+  "properties": {
+    "iccProfileBase64": {
+      "description": "ICC profile bytes, base64 (RGB, ≤ 8 MiB).",
+      "maxLength": 11000000,
+      "minLength": 1,
+      "type": "string"
+    },
+    "info": {
+      "maxLength": 500,
+      "type": "string"
+    },
+    "outputCondition": {
+      "maxLength": 200,
+      "type": "string"
+    },
+    "outputConditionIdentifier": {
+      "description": "e.g. \"sRGB IEC61966-2.1\".",
+      "maxLength": 200,
+      "minLength": 1,
+      "type": "string"
+    },
+    "registryName": {
+      "description": "Default \"http://www.color.org\".",
+      "maxLength": 200,
+      "type": "string"
+    }
+  },
+  "required": [
+    "iccProfileBase64",
+    "outputConditionIdentifier"
+  ],
+  "type": "object"
+}

addedInput schema / properties / pageSize

Added value: +{
+  "description": "Portrait page preset (points): A4 595.28×841.89 (default), Letter 612×792, Legal 612×1008, A3 841.89×1190.55, Tabloid 792×1224. print.* boxes must fit it.",
+  "enum": [
+    "A4",
+    "Letter",
+    "Legal",
+    "A3",
+    "Tabloid"
+  ],
+  "type": "string"
+}

changedInput schema / properties / pdfA / description

Previous value: -"Optional PDF/A conformance level (powered by pdfnative v1.2). Use 'pdfa1b' for archival of simple text+images, 'pdfa2b'/'pdfa2u' for richer content (2u guarantees Unicode mapping), 'pdfa3b' when embedding source attachments (Factur-X / ZUGFeRD). Mutually exclusive with PDF encryption. See docs/guides/PDFA.md."New value: +"PDF/A level: pdfa1b (simple text+images), pdfa2b/pdfa2u (richer; 2u = Unicode mapping), pdfa3b (attachments / Factur-X). Pair with embedFonts=true for a valid claim. Exclusive with encryption. See docs/guides/PDFA.md."

addedInput schema / properties / print

Added value: +{
+  "additionalProperties": false,
+  "description": "Print production (ISO 32000-1 §14.11): page boxes, `bleed` shorthand (TrimBox = MediaBox inset), crop/registration marks outside the TrimBox, /UserUnit for large formats (PDF 1.7; not under pdfa1b). See docs/guides/PRINT.md.",
+  "properties": {
+    "artBox": {
+      "description": "[x0, y0, x1, y1] in points, origin bottom-left, inside the MediaBox.",
+      "items": {
+        "type": "number"
+      },
+      "maxItems": 4,
+      "minItems": 4,
+      "type": "array"
+    },
+    "bleed": {
+      "description": "Bleed in points (8.5 = 3 mm); sets TrimBox = MediaBox inset. Exclusive with trimBox.",
+      "exclusiveMinimum": 0,
+      "maximum": 200,
+      "type": "number"
+    },
+    "bleedBox": {
+      "description": "[x0, y0, x1, y1] in points, origin bottom-left, inside the MediaBox.",
+      "items": {
+        "type": "number"
+      },
+      "maxItems": 4,
+      "minItems": 4,
+      "type": "array"
+    },
+    "cropBox": {
+      "description": "[x0, y0, x1, y1] in points, origin bottom-left, inside the MediaBox.",
+      "items": {
+        "type": "number"
+      },
+      "maxItems": 4,
+      "minItems": 4,
+      "type": "array"
+    },
+    "marks": {
+      "description": "Printer's marks (needs bleed or trimBox): true for defaults, or an object.",
+      "oneOf": [
+        {
+          "type": "boolean"
+        },
+        {
+          "additionalProperties": false,
+          "properties": {
+            "crop": {
+              "description": "Corner crop (trim) marks. Default true.",
+              "type": "boolean"
+            },
+            "length": {
+              "description": "Mark length in points. Default 14.",
+              "maximum": 100,
+              "minimum": 1,
+              "type": "number"
+            },
+            "offset": {
+              "description": "Gap between TrimBox and marks in points. Default 5.",
+              "maximum": 100,
+              "minimum": 0,
+              "type": "number"
+            },
+            "registration": {
+              "description": "Edge-midpoint registration targets. Default true.",
+              "type": "boolean"
+            },
+            "weight": {
+              "description": "Stroke width in points. Default 0.25.",
+              "maximum": 5,
+              "minimum": 0.05,
+              "type": "number"
+            }
+          },
+          "type": "object"
+        }
+      ]
+    },
+    "trimBox": {
+      "description": "[x0, y0, x1, y1] in points, origin bottom-left, inside the MediaBox.",
+      "items": {
+        "type": "number"
+      },
+      "maxItems": 4,
+      "minItems": 4,
+      "type": "array"
+    },
+    "userUnit": {
+      "description": "/UserUnit (multiples of 1/72 in) for pages over 14400 pt. Rejected under pdfa1b.",
+      "maximum": 75000,
+      "minimum": 1,
+      "type": "number"
+    }
+  },
+  "type": "object"
+}

changedInput schema / properties / repeatHeader / description

Previous value: -"Repeat the header row on every continuation page (pdfnative v1.2). Default true."New value: +"Repeat the header row on every continuation page (default true)."

addedInput schema / properties / strict

Added value: +{
+  "default": false,
+  "description": "Fail with PDF_A_COMPLIANCE_VIOLATION instead of producing a non-conformant PDF/A file (e.g. PDFA_NO_FONT_ENTRIES without embedFonts). Pair with embedFonts=true.",
+  "type": "boolean"
+}

addedInput schema / properties / viewerPreferences / properties / duplex

Added value: +{
+  "description": "Print-dialog paper handling default (/Duplex): single-sided or double-sided flipping on the short/long edge.",
+  "enum": [
+    "simplex",
+    "duplexFlipShortEdge",
+    "duplexFlipLongEdge"
+  ],
+  "type": "string"
+}

addedInput schema / properties / viewerPreferences / properties / numCopies

Added value: +{
+  "description": "Default number of copies for the Print dialog (/NumCopies; viewers honour 2-5 per ISO 32000 Table 150).",
+  "maximum": 1000,
+  "minimum": 1,
+  "type": "integer"
+}

addedInput schema / properties / viewerPreferences / properties / pickTrayByPDFSize

Added value: +{
+  "description": "Ask the printer to pick the input tray from the PDF page size (/PickTrayByPDFSize).",
+  "type": "boolean"
+}

addedInput schema / properties / viewerPreferences / properties / printPageRange

Added value: +{
+  "description": "Default page ranges for the Print dialog (/PrintPageRange) as inclusive 1-based [first, last] pairs, e.g. [[1, 4], [7, 7]].",
+  "items": {
+    "items": {
+      "minimum": 1,
+      "type": "integer"
+    },
+    "maxItems": 2,
+    "minItems": 2,
+    "type": "array"
+  },
+  "maxItems": 100,
+  "type": "array"
+}

changedInput schema / properties / watermark / description

Previous value: -"Optional semi-transparent text watermark rendered on every page (e.g. 'DRAFT', 'CONFIDENTIAL'). Text only in this version. opacity < 1.0 is rejected under pdfA='pdfa1b' (ISO 19005-1 forbids transparency)."New value: +"Optional semi-transparent watermark rendered centred on every page: `text` (e.g. 'DRAFT'), `image` (JPEG/PNG), or both combined. At least one of text / image is required. opacity < 1.0 (text or image, including the defaults) is rejected under pdfA='pdfa1b' (ISO 19005-1 forbids transparency)."

changedInput schema / properties / watermark / properties / angle / description

Previous value: -"Rotation in degrees (counterclockwise). Default -45."New value: +"Text rotation in degrees (counterclockwise). Default -45."

changedInput schema / properties / watermark / properties / color / description

Previous value: -"RGB colour as a [r, g, b] triple in the 0.0–1.0 range. Default light gray [0.75, 0.75, 0.75]."New value: +"Text RGB colour as a [r, g, b] triple in the 0.0–1.0 range. Default light gray [0.75, 0.75, 0.75]."

changedInput schema / properties / watermark / properties / fontSize / description

Previous value: -"Font size in points. Default 60, auto-fit to the page."New value: +"Text font size in points. Default 60, auto-fit to the page."

addedInput schema / properties / watermark / properties / image

Added value: +{
+  "additionalProperties": false,
+  "description": "Image watermark (JPEG or PNG) centred on every page, optionally combined with `text`. Bytes are validated against the JPEG/PNG magic numbers; mimeType must match.",
+  "properties": {
+    "height": {
+      "description": "Display height in points (default: from the image pixel size).",
+      "exclusiveMinimum": 0,
+      "maximum": 14400,
+      "type": "number"
+    },
+    "imageBase64": {
+      "description": "Base64-encoded JPEG or 8-bit opaque PNG bytes (max 8 MiB decoded; alpha-channel, palette and interlaced PNGs are rejected with a remedy). Plain base64, no data: URI prefix.",
+      "maxLength": 12000000,
+      "minLength": 4,
+      "type": "string"
+    },
+    "mimeType": {
+      "description": "'image/jpeg' or 'image/png' — must match the actual bytes.",
+      "enum": [
+        "image/jpeg",
+        "image/png"
+      ],
+      "type": "string"
+    },
+    "opacity": {
+      "description": "Image opacity 0.0–1.0. Default 0.10.",
+      "maximum": 1,
+      "minimum": 0,
+      "type": "number"
+    },
+    "width": {
+      "description": "Display width in points (default: from the image pixel size).",
+      "exclusiveMinimum": 0,
+      "maximum": 14400,
+      "type": "number"
+    }
+  },
+  "required": [
+    "imageBase64",
+    "mimeType"
+  ],
+  "type": "object"
+}

changedInput schema / properties / watermark / properties / opacity / description

Previous value: -"Opacity 0.0–1.0. Default 0.15."New value: +"Text opacity 0.0–1.0. Default 0.15. (Image opacity is image.opacity.)"

changedInput schema / properties / watermark / properties / position / description

Previous value: -"'background' (behind page content, default) or 'foreground' (above it)."New value: +"'background' (behind page content, default) or 'foreground' (above it). Applies to text and image alike."

changedInput schema / properties / watermark / properties / text / description

Previous value: -"Watermark text."New value: +"Watermark text. Optional when `image` is given."

removedInput schema / properties / watermark / required
```
Removed value: -[
-  "text"
-]
```

changedInput schema / properties / wrap / description

Previous value: -"Cell wrap policy (pdfnative v1.2). 'auto' (default) wraps only when a cell overflows; 'always' wraps every cell; 'never' uses v1.1 character truncation."New value: +"Cell wrap policy: 'auto' (default) wraps only overflowing cells; 'always' wraps every cell; 'never' truncates."

changedInput schema / properties / zebra / description

Previous value: -"Enable zebra striping (alternate-row light tint, PDF/A-1b safe). pdfnative v1.2."New value: +"Alternate-row light tint (static fill, PDF/A-1b safe)."

changedOutput schema / description

Previous value: -"Structured result of a PDF-producing tool. In base64 mode the PDF bytes are delivered out-of-band as an embedded `resource` content block (data: URI), NOT duplicated here, to keep responses token-frugal. In file mode `filePath` is the sandboxed absolute path."New value: +"Result of a PDF-producing tool. base64 mode: the PDF arrives as an embedded `resource` content block (not duplicated here); file mode: `filePath`."

addedOutput schema / properties / diagnostics

Added value: +{
+  "description": "PDF/A diagnostics (when includeDiagnostics=true).",
+  "items": {
+    "additionalProperties": false,
+    "properties": {
+      "code": {
+        "type": "string"
+      },
+      "message": {
+        "type": "string"
+      },
+      "severity": {
+        "enum": [
+          "warning"
+        ],
+        "type": "string"
+      }
+    },
+    "required": [
+      "code",
+      "message",
+      "severity"
+    ],
+    "type": "object"
+  },
+  "type": "array"
+}

changedOutput schema / properties / filePath / description

Previous value: -"Absolute sandboxed file path (when mode='file')."New value: +"Sandboxed absolute path (file mode)."

addedOutput schema / properties / summary

Added value: +{
+  "additionalProperties": true,
+  "description": "Tool-specific summary, when produced.",
+  "type": "object"
+}

Changed3 schema fields changedv1.2.2Jul 4, 2026

addedInput schema / properties / cellBorders

Added value: +{
+  "additionalProperties": false,
+  "description": "Per-cell vector borders (pdfnative v1.4). Switches the backend to buildDocumentPDFBytes. Choose individual sides or `all`.",
+  "properties": {
+    "all": {
+      "description": "Draw all four edges (overrides the individual side flags).",
+      "type": "boolean"
+    },
+    "bottom": {
+      "type": "boolean"
+    },
+    "color": {
+      "description": "Stroke colour as a PDF operator string ('0.8 0.8 0.8') or hex. Default light grey.",
+      "type": "string"
+    },
+    "left": {
+      "type": "boolean"
+    },
+    "right": {
+      "type": "boolean"
+    },
+    "style": {
+      "description": "Stroke style (default 'solid').",
+      "enum": [
+        "solid",
+        "dashed",
+        "dotted"
+      ],
+      "type": "string"
+    },
+    "top": {
+      "type": "boolean"
+    },
+    "width": {
+      "description": "Stroke width in points (default 0.5).",
+      "maximum": 10,
+      "minimum": 0,
+      "type": "number"
+    }
+  },
+  "type": "object"
+}

addedInput schema / properties / cellVAlign

Added value: +{
+  "description": "Vertical alignment of cell content (pdfnative v1.4). Switches the backend to buildDocumentPDFBytes.",
+  "enum": [
+    "top",
+    "middle",
+    "bottom"
+  ],
+  "type": "string"
+}

addedInput schema / properties / viewerPreferences

Added value: +{
+  "additionalProperties": false,
+  "description": "Reader presentation hints (catalog /PageLayout, /PageMode, /ViewerPreferences). PDF/A-safe; all optional.",
+  "properties": {
+    "centerWindow": {
+      "type": "boolean"
+    },
+    "direction": {
+      "enum": [
+        "l2r",
+        "r2l"
+      ],
+      "type": "string"
+    },
+    "displayDocTitle": {
+      "type": "boolean"
+    },
+    "fitWindow": {
+      "type": "boolean"
+    },
+    "hideMenubar": {
+      "type": "boolean"
+    },
+    "hideToolbar": {
+      "type": "boolean"
+    },
+    "hideWindowUI": {
+      "type": "boolean"
+    },
+    "nonFullScreenPageMode": {
+      "enum": [
+        "useNone",
+        "useOutlines",
+        "useThumbs",
+        "useOC"
+      ],
+      "type": "string"
+    },
+    "pageLayout": {
+      "enum": [
+        "singlePage",
+        "oneColumn",
+        "twoColumnLeft",
+        "twoColumnRight",
+        "twoPageLeft",
+        "twoPageRight"
+      ],
+      "type": "string"
+    },
+    "pageMode": {
+      "enum": [
+        "useNone",
+        "useOutlines",
+        "useThumbs",
+        "fullScreen",
+        "useOC",
+        "useAttachments"
+      ],
+      "type": "string"
+    },
+    "printScaling": {
+      "enum": [
+        "none",
+        "appDefault"
+      ],
+      "type": "string"
+    }
+  },
+  "type": "object"
+}

Changed3 schema fields changedv1.2.0Jun 24, 2026

addedInput schema / properties / watermark

Added value: +{
+  "additionalProperties": false,
+  "description": "Optional semi-transparent text watermark rendered on every page (e.g. 'DRAFT', 'CONFIDENTIAL'). Text only in this version. opacity < 1.0 is rejected under pdfA='pdfa1b' (ISO 19005-1 forbids transparency).",
+  "properties": {
+    "angle": {
+      "description": "Rotation in degrees (counterclockwise). Default -45.",
+      "maximum": 360,
+      "minimum": -360,
+      "type": "number"
+    },
+    "color": {
+      "description": "RGB colour as a [r, g, b] triple in the 0.0–1.0 range. Default light gray [0.75, 0.75, 0.75].",
+      "items": {
+        "maximum": 1,
+        "minimum": 0,
+        "type": "number"
+      },
+      "maxItems": 3,
+      "minItems": 3,
+      "type": "array"
+    },
+    "fontSize": {
+      "description": "Font size in points. Default 60, auto-fit to the page.",
+      "maximum": 300,
+      "minimum": 6,
+      "type": "number"
+    },
+    "opacity": {
+      "description": "Opacity 0.0–1.0. Default 0.15.",
+      "maximum": 1,
+      "minimum": 0,
+      "type": "number"
+    },
+    "position": {
+      "default": "background",
+      "description": "'background' (behind page content, default) or 'foreground' (above it).",
+      "enum": [
+        "background",
+        "foreground"
+      ],
+      "type": "string"
+    },
+    "text": {
+      "description": "Watermark text.",
+      "maxLength": 100,
+      "minLength": 1,
+      "type": "string"
+    }
+  },
+  "required": [
+    "text"
+  ],
+  "type": "object"
+}

addedOutput schema / description

Added value: +"Structured result of a PDF-producing tool. In base64 mode the PDF bytes are delivered out-of-band as an embedded `resource` content block (data: URI), NOT duplicated here, to keep responses token-frugal. In file mode `filePath` is the sandboxed absolute path."

removedOutput schema / properties / base64

Removed value: -{
-  "description": "Base64-encoded PDF bytes (when mode='base64').",
-  "type": "string"
-}

First observedv1.1.0Jun 20, 2026

TDQS

A4.5/5.0

Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already declare readOnly=false, destructive=false, idempotent=true and openWorld=false, so the safety profile is covered; the description adds the non-obvious constraint that a PDF/A claim requires pdfA plus embedFonts:true. It does not restate contradictions or hidden side effects, and it delegates print/metadata/watermark/creationDate semantics to the shared document-tool conventions rather than spelling them out.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Three sentences, front-loaded with purpose, then the option map, then the sibling routing rule — no filler. The middle enumeration is long but functions as a navigational index into a very large schema, so it earns its space; it could be trimmed slightly.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

With 38 parameters, a rich schema and an output schema present, the description correctly focuses on purpose, the table-specific subset, and the sibling alternative while delegating the shared document options ('as on every document tool') and return values to structured fields. Nothing essential for a correct first call is missing, though outputMode/file-writing behavior is only implicitly covered by the delegation.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 100%, so the baseline is 3, but the description earns more by grouping the table-specific knobs (wrap, repeatHeader, zebra, caption, minRowHeight, cellPadding, cellBorders, cellVAlign, autoFitColumns, clipCells) so the agent knows which of the 38 parameters actually govern table layout. It also flags the cross-parameter pairing 'pdfA + embedFonts:true', which is semantic rather than schema restatement.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

States a specific output (a tabular PDF report) built from named inputs (`headers` + `rows`, equal-length rows), which is a concrete verb+resource+shape. It also distinguishes itself from the sibling `generate_basic_pdf` by pointing to that tool's 'table' block for tables inside longer documents.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines5/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Gives an explicit when-not plus the alternative: 'Inside a longer document use a table block of generate_basic_pdf instead.' That is exactly the routing decision an agent needs between the two document-producing tools.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.