Skip to main content
Glama

Preview Document as PNG

preview_document

Render a PNG preview from supplied document details. HTTP calls can return a temporary image link.

Example tool call

This call uses example arguments supplied in the tool’s input schema.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {
      "to": {
        "name": "Client LLC"
      },
      "from": {
        "name": "Acme Corp"
      },
      "doc_type": "invoice"
    },
    "name": "preview_document"
  }
}

Input Schema

NameRequiredDescriptionDefault
toYesRecipient or tenant details.
fromYesIssuer or landlord details.
itemsNoLine items or rent schedule.
countyNoCounty name for jurats and headers.
currencyNoISO 4217 currency code.USD
doc_typeYesArchetype slug (invoice, receipt, residential_lease, nda, etc.).
due_dateNoPayment due date (YYYY-MM-DD).
sectionsNoStructured legal clause sections.
tax_rateNoPercentage tax rate.
to_styleNoBilled To or tenant card style override (standard, badged, minimal, boxed_grid, editorial_split, stacked_banner).
doc_numberNoDocument number. Left blank when omitted.
from_styleNoIssuer or landlord card style override (standard, badged, minimal, boxed_grid, editorial_split, stacked_banner).
issue_dateNoIssue date (YYYY-MM-DD).
recordableNoEnable County Recorder 3-inch top margin.
signaturesNoSignature fields with signer names, dates, and optional signature images.
state_codeNo2-letter US state or DC code.
date_formatNoDate format (iso, us_slash, euro, formal_prose).
notes_styleNoNotes and instructions block style (standard, callout_card, left_accent, numbered_legal).
table_styleNoLine items and rent schedule table style (standard, minimal_lines, bordered_ledger, modern_cards, compact_mono).
fields_styleNoMetadata and property fields style (standard, compact_strip, ledger_table, minimal_list).
layout_styleNoHeader layout style (standard, minimal, modern_banner, classic_letterhead, editorial_centered, split_sidebar, swiss_grid, compact_ledger, framed).
municipalityNoMunicipal profile (Chicago, Cook County, NYC, SF, Seattle, Portland).
payment_linkNoHTTPS link supplied by the user to include in the document.
totals_styleNoFinancial summary and totals box style (standard, card_highlight, banner_bar, compact, split_ledger).
custom_fieldsNoCustom key-value metadata fields.
parties_styleNoParty cards style (standard, badged, minimal, boxed_grid, editorial_split, stacked_banner).
payment_styleNoStyle for payment details in the document (standard, banner, minimal_inline).
execution_modeNoSignature layout (esign, wet_ink, notarized_wet, ron).
sections_styleNoCustom sections and clauses style (standard, callout_card, left_accent, numbered_legal).
compliance_modeNoCompliance topic note (none, eu_vat, peppol_bis, hipaa_baa).
notary_requiredNoAdd blank section for notary completion.
number_decimalsNoDecimal places for amounts (default 2).
payment_qr_codeNoEmbed vector SVG QR code.
signature_styleNoSignature block style (standard, framed_box, formal_deed, minimal_compact).
currency_placementNoCurrency prefix or suffix placement.
currency_separatorsNoNumber separators (comma_dot, dot_comma).
currency_symbol_modeNoDisplay currency symbol or ISO code.

Output Schema

NameRequiredDescriptionDefault
previewNoTemporary file link for HTTP tool calls.
preview_errorNoWhy a temporary preview link could not be created. The PNG remains in the tool result.
image_data_uriYesBase64 PNG data URI.
compile_time_msYesCompile time in ms.

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed2 schema fields changed
    • changedInput schema / properties / payment_link / description
      Previous value: -"HTTPS checkout URL for QR code."New value: +"HTTPS link supplied by the user to include in the document."
    • changedInput schema / properties / payment_style / description
      Previous value: -"Payment QR and checkout block style (standard, banner, minimal_inline)."New value: +"Style for payment details in the document (standard, banner, minimal_inline)."
  2. Changed2 schema fields changed
    • removedInput schema / properties / concept_slug
      Removed value: -{
      -  "description": "Optional 100-Concept Hallman Document Engine slug or ID (1..100, e.g. 'aia-g702-g703-progress-billing-draw-schedule', 'yc-post-money-safe-financing-instrument-valuation-cap', 'hotel-group-sales-room-block-attrition-agreement').",
      -  "type": "string"
      -}
    • removedInput schema / properties / page_layout
      Removed value: -{
      -  "description": "Optional structural page archetype for 100-concept documents (asymmetric_sidebar, pleading_caption, three_tier_packages, inspection_checklist, blueprint_schematic, split_settlement, clinical_box_grid, certificate_broadsheet, dark_tactile_brief, executive_draw_ledger).",
      -  "type": "string"
      -}
  3. Changed2 schema fields changed
    • addedInput schema / properties / concept_slug
      Added value: +{
      +  "description": "Optional 100-Concept Hallman Document Engine slug or ID (1..100, e.g. 'aia-g702-g703-progress-billing-draw-schedule', 'yc-post-money-safe-financing-instrument-valuation-cap', 'hotel-group-sales-room-block-attrition-agreement').",
      +  "type": "string"
      +}
    • addedInput schema / properties / page_layout
      Added value: +{
      +  "description": "Optional structural page archetype for 100-concept documents (asymmetric_sidebar, pleading_caption, three_tier_packages, inspection_checklist, blueprint_schematic, split_settlement, clinical_box_grid, certificate_broadsheet, dark_tactile_brief, executive_draw_ledger).",
      +  "type": "string"
      +}
  4. Changed11 schema fields changed
    • addedInput schema / properties / fields_style
      Added value: +{
      +  "description": "Metadata and property fields style (standard, compact_strip, ledger_table, minimal_list).",
      +  "type": "string"
      +}
    • addedInput schema / properties / from_style
      Added value: +{
      +  "description": "Issuer or landlord card style override (standard, badged, minimal, boxed_grid, editorial_split, stacked_banner).",
      +  "type": "string"
      +}
    • addedInput schema / properties / layout_style
      Added value: +{
      +  "description": "Header layout style (standard, minimal, modern_banner, classic_letterhead, editorial_centered, split_sidebar, swiss_grid, compact_ledger, framed).",
      +  "type": "string"
      +}
    • addedInput schema / properties / notes_style
      Added value: +{
      +  "description": "Notes and instructions block style (standard, callout_card, left_accent, numbered_legal).",
      +  "type": "string"
      +}
    • addedInput schema / properties / parties_style
      Added value: +{
      +  "description": "Party cards style (standard, badged, minimal, boxed_grid, editorial_split, stacked_banner).",
      +  "type": "string"
      +}
    • addedInput schema / properties / payment_style
      Added value: +{
      +  "description": "Payment QR and checkout block style (standard, banner, minimal_inline).",
      +  "type": "string"
      +}
    • addedInput schema / properties / sections_style
      Added value: +{
      +  "description": "Custom sections and clauses style (standard, callout_card, left_accent, numbered_legal).",
      +  "type": "string"
      +}
    • addedInput schema / properties / signature_style
      Added value: +{
      +  "description": "Signature block style (standard, framed_box, formal_deed, minimal_compact).",
      +  "type": "string"
      +}
    • addedInput schema / properties / table_style
      Added value: +{
      +  "description": "Line items and rent schedule table style (standard, minimal_lines, bordered_ledger, modern_cards, compact_mono).",
      +  "type": "string"
      +}
    • addedInput schema / properties / to_style
      Added value: +{
      +  "description": "Billed To or tenant card style override (standard, badged, minimal, boxed_grid, editorial_split, stacked_banner).",
      +  "type": "string"
      +}
    • addedInput schema / properties / totals_style
      Added value: +{
      +  "description": "Financial summary and totals box style (standard, card_highlight, banner_bar, compact, split_ledger).",
      +  "type": "string"
      +}
  5. Changed28 schema fields changed
    • addedInput schema / properties / compliance_mode
      Added value: +{
      +  "description": "Compliance topic note (none, eu_vat, peppol_bis, hipaa_baa).",
      +  "type": "string"
      +}
    • addedInput schema / properties / county
      Added value: +{
      +  "description": "County name for jurats and headers.",
      +  "type": "string"
      +}
    • addedInput schema / properties / currency_placement
      Added value: +{
      +  "description": "Currency prefix or suffix placement.",
      +  "type": "string"
      +}
    • addedInput schema / properties / currency_separators
      Added value: +{
      +  "description": "Number separators (comma_dot, dot_comma).",
      +  "type": "string"
      +}
    • addedInput schema / properties / currency_symbol_mode
      Added value: +{
      +  "description": "Display currency symbol or ISO code.",
      +  "type": "string"
      +}
    • addedInput schema / properties / custom_fields
      Added value: +{
      +  "description": "Custom key-value metadata fields.",
      +  "type": "array"
      +}
    • addedInput schema / properties / date_format
      Added value: +{
      +  "description": "Date format (iso, us_slash, euro, formal_prose).",
      +  "type": "string"
      +}
    • addedInput schema / properties / doc_number
      Added value: +{
      +  "description": "Document number. Left blank when omitted.",
      +  "type": "string"
      +}
    • changedInput schema / properties / doc_type / description
      Previous value: -"Archetype slug (invoice, receipt, residential_lease, nda)."New value: +"Archetype slug (invoice, receipt, residential_lease, nda, etc.)."
    • addedInput schema / properties / due_date
      Added value: +{
      +  "description": "Payment due date (YYYY-MM-DD).",
      +  "type": "string"
      +}
    • addedInput schema / properties / execution_mode
      Added value: +{
      +  "description": "Signature layout (esign, wet_ink, notarized_wet, ron).",
      +  "type": "string"
      +}
    • addedInput schema / properties / from / properties / address
      Added value: +{
      +  "description": "Issuer address.",
      +  "type": "string"
      +}
    • addedInput schema / properties / from / properties / email
      Added value: +{
      +  "description": "Issuer email.",
      +  "type": "string"
      +}
    • addedInput schema / properties / issue_date
      Added value: +{
      +  "description": "Issue date (YYYY-MM-DD).",
      +  "type": "string"
      +}
    • changedInput schema / properties / items / description
      Previous value: -"Line items array ({description, quantity, unit_price})."New value: +"Line items or rent schedule."
    • addedInput schema / properties / items / items
      Added value: +{
      +  "properties": {
      +    "description": {
      +      "description": "Item description.",
      +      "type": "string"
      +    },
      +    "quantity": {
      +      "description": "Item quantity.",
      +      "type": "number"
      +    },
      +    "unit_price": {
      +      "description": "Unit price.",
      +      "type": "number"
      +    }
      +  },
      +  "required": [
      +    "description",
      +    "quantity",
      +    "unit_price"
      +  ],
      +  "type": "object"
      +}
    • addedInput schema / properties / municipality
      Added value: +{
      +  "description": "Municipal profile (Chicago, Cook County, NYC, SF, Seattle, Portland).",
      +  "type": "string"
      +}
    • addedInput schema / properties / notary_required
      Added value: +{
      +  "description": "Add blank section for notary completion.",
      +  "type": "boolean"
      +}
    • addedInput schema / properties / number_decimals
      Added value: +{
      +  "description": "Decimal places for amounts (default 2).",
      +  "type": "integer"
      +}
    • addedInput schema / properties / payment_qr_code
      Added value: +{
      +  "description": "Embed vector SVG QR code.",
      +  "type": "boolean"
      +}
    • addedInput schema / properties / recordable
      Added value: +{
      +  "description": "Enable County Recorder 3-inch top margin.",
      +  "type": "boolean"
      +}
    • addedInput schema / properties / sections
      Added value: +{
      +  "description": "Structured legal clause sections.",
      +  "type": "array"
      +}
    • addedInput schema / properties / signatures
      Added value: +{
      +  "description": "Signature fields with signer names, dates, and optional signature images.",
      +  "items": {
      +    "properties": {
      +      "date": {
      +        "description": "Signing date.",
      +        "type": "string"
      +      },
      +      "signature_data": {
      +        "description": "Base64 signature image data URI.",
      +        "type": "string"
      +      },
      +      "signer_name": {
      +        "type": "string"
      +      },
      +      "signer_title": {
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "signer_name"
      +    ],
      +    "type": "object"
      +  },
      +  "type": "array"
      +}
    • addedInput schema / properties / tax_rate
      Added value: +{
      +  "description": "Percentage tax rate.",
      +  "type": "number"
      +}
    • addedInput schema / properties / to / properties / address
      Added value: +{
      +  "description": "Recipient address.",
      +  "type": "string"
      +}
    • addedInput schema / properties / to / properties / email
      Added value: +{
      +  "description": "Recipient email.",
      +  "type": "string"
      +}
    • addedOutput schema / properties / preview
      Added value: +{
      +  "description": "Temporary file link for HTTP tool calls.",
      +  "properties": {
      +    "expires_at": {
      +      "format": "date-time",
      +      "type": "string"
      +    },
      +    "expires_in_seconds": {
      +      "type": "integer"
      +    },
      +    "filename": {
      +      "type": "string"
      +    },
      +    "url": {
      +      "format": "uri",
      +      "type": "string"
      +    }
      +  },
      +  "required": [
      +    "url",
      +    "filename",
      +    "expires_at",
      +    "expires_in_seconds"
      +  ],
      +  "type": "object"
      +}
    • addedOutput schema / properties / preview_error
      Added value: +{
      +  "description": "Why a temporary preview link could not be created. The PNG remains in the tool result.",
      +  "type": "string"
      +}
  6. Changed54 schema fields changed
    • addedInput schema / examples
      Added value: +[
      +  {
      +    "doc_type": "invoice",
      +    "from": {
      +      "name": "Acme Corp"
      +    },
      +    "to": {
      +      "name": "Client LLC"
      +    }
      +  }
      +]
    • removedInput schema / properties / compliance_mode
      Removed value: -{
      -  "description": "Regulatory compliance notice banner.",
      -  "enum": [
      -    "none",
      -    "eu_vat",
      -    "factur-x",
      -    "peppol_bis",
      -    "hipaa_baa",
      -    "zatca",
      -    "irs_w9",
      -    "pci_dss",
      -    "soc2_badge",
      -    "statutory_sworn"
      -  ],
      -  "type": "string"
      -}
    • removedInput schema / properties / county
      Removed value: -{
      -  "description": "County name for notarial jurat and recording cover header (e.g., 'Hamilton').",
      -  "type": "string"
      -}
    • changedInput schema / properties / currency / description
      Previous value: -"ISO 4217 currency code or symbol (default 'USD'; supports EUR, GBP, CAD, AUD, JPY, CHF)."New value: +"ISO 4217 currency code."
    • removedInput schema / properties / currency_placement
      Removed value: -{
      -  "description": "Place currency symbol/code before or after amounts.",
      -  "enum": [
      -    "prefix",
      -    "suffix"
      -  ],
      -  "type": "string"
      -}
    • removedInput schema / properties / currency_separators
      Removed value: -{
      -  "description": "Thousands and decimal separator style.",
      -  "enum": [
      -    "comma_dot",
      -    "dot_comma",
      -    "space_comma",
      -    "apostrophe_dot",
      -    "plain"
      -  ],
      -  "type": "string"
      -}
    • removedInput schema / properties / currency_symbol_mode
      Removed value: -{
      -  "description": "Display currency symbol ('$') or ISO code ('USD').",
      -  "enum": [
      -    "symbol",
      -    "code"
      -  ],
      -  "type": "string"
      -}
    • removedInput schema / properties / custom_fields
      Removed value: -{
      -  "description": "Custom key-value metadata fields.",
      -  "items": {
      -    "properties": {
      -      "label": {
      -        "description": "Metadata field label.",
      -        "type": "string"
      -      },
      -      "value": {
      -        "description": "Metadata field value.",
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "label",
      -      "value"
      -    ],
      -    "type": "object"
      -  },
      -  "type": "array"
      -}
    • removedInput schema / properties / date_format
      Removed value: -{
      -  "description": "Date rendering format.",
      -  "enum": [
      -    "iso",
      -    "us_slash",
      -    "euro",
      -    "formal_prose",
      -    "short_abbrev",
      -    "short_dot"
      -  ],
      -  "type": "string"
      -}
    • removedInput schema / properties / discount_amount
      Removed value: -{
      -  "description": "Flat document-level discount subtracted before grand total.",
      -  "type": "number"
      -}
    • removedInput schema / properties / doc_number
      Removed value: -{
      -  "description": "Unique document identifier (e.g., 'INV-2026-0042'); auto-generated when omitted.",
      -  "type": "string"
      -}
    • changedInput schema / properties / doc_type / description
      Previous value: -"Document archetype across 57 commercial, legal, and real estate templates (e.g., invoice, residential_lease)."New value: +"Archetype slug (invoice, receipt, residential_lease, nda)."
    • removedInput schema / properties / doc_type / enum
      Removed value: -[
      -  "invoice",
      -  "invoice_standard",
      -  "invoice_freelance",
      -  "invoice_construction",
      -  "invoice_medical",
      -  "invoice_saas",
      -  "invoice_minimal",
      -  "proforma_invoice",
      -  "estimate",
      -  "receipt",
      -  "purchase_order",
      -  "packing_slip",
      -  "credit_note",
      -  "work_order",
      -  "expense_report",
      -  "delivery_receipt",
      -  "commercial_lease",
      -  "quotation_tender",
      -  "agreement",
      -  "agreement_sow",
      -  "contractor_agreement",
      -  "retainer_agreement",
      -  "nda",
      -  "bill_of_sale",
      -  "certificate",
      -  "certificate_insurance",
      -  "certificate_completion",
      -  "inspection_report",
      -  "residential_lease",
      -  "commercial_nnn_lease",
      -  "property_management_statement",
      -  "rent_roll",
      -  "closing_settlement_statement",
      -  "notice_to_vacate",
      -  "security_deposit_disposition",
      -  "real_estate_commission",
      -  "property_inspection_checklist",
      -  "letter_of_intent_cre",
      -  "tenant_estoppel",
      -  "room_rental_lease",
      -  "lease_renewal_agreement",
      -  "lease_amendment",
      -  "rental_application",
      -  "adverse_action_notice",
      -  "notice_of_entry",
      -  "rent_increase_notice",
      -  "mutual_lease_termination",
      -  "tenant_rent_ledger",
      -  "schedule_of_real_estate_owned",
      -  "schedule_e_tax_worksheet",
      -  "real_estate_deal_analysis",
      -  "sublease_agreement",
      -  "rent_to_own_agreement",
      -  "property_management_agreement",
      -  "real_estate_purchase_agreement",
      -  "property_deed",
      -  "mechanics_lien_waiver"
      -]
    • removedInput schema / properties / due_date
      Removed value: -{
      -  "description": "Payment due or expiration date (YYYY-MM-DD).",
      -  "type": "string"
      -}
    • removedInput schema / properties / execution_mode
      Removed value: -{
      -  "description": "Execution and signature mode.",
      -  "enum": [
      -    "esign",
      -    "wet_ink",
      -    "wet-ink",
      -    "notarized_wet",
      -    "ron",
      -    "notarized_ron"
      -  ],
      -  "type": "string"
      -}
    • changedInput schema / properties / from / description
      Previous value: -"Issuer, seller, landlord, or service provider details."New value: +"Issuer or landlord details."
    • removedInput schema / properties / from / properties / address
      Removed value: -{
      -  "description": "Issuer mailing address.",
      -  "type": "string"
      -}
    • removedInput schema / properties / from / properties / company
      Removed value: -{
      -  "description": "Issuer company name.",
      -  "type": "string"
      -}
    • removedInput schema / properties / from / properties / email
      Removed value: -{
      -  "description": "Issuer email address.",
      -  "type": "string"
      -}
    • changedInput schema / properties / from / properties / name / description
      Previous value: -"Issuer full or entity name (required)."New value: +"Issuer name."
    • removedInput schema / properties / from / properties / phone
      Removed value: -{
      -  "description": "Issuer phone number.",
      -  "type": "string"
      -}
    • removedInput schema / properties / from / properties / tax_id
      Removed value: -{
      -  "description": "Issuer EIN, VAT, or tax ID.",
      -  "type": "string"
      -}
    • removedInput schema / properties / include_clerk_stamp
      Removed value: -{
      -  "description": "Reserves a County Clerk recording stamp zone on wet-ink jurats.",
      -  "type": "boolean"
      -}
    • removedInput schema / properties / is_paid
      Removed value: -{
      -  "description": "Marks the document PAID IN FULL.",
      -  "type": "boolean"
      -}
    • removedInput schema / properties / issue_date
      Removed value: -{
      -  "description": "Document issue date (YYYY-MM-DD).",
      -  "type": "string"
      -}
    • changedInput schema / properties / items / description
      Previous value: -"Billable line items, milestones, rent schedules, or fee breakdowns."New value: +"Line items array ({description, quantity, unit_price})."
    • removedInput schema / properties / items / items
      Removed value: -{
      -  "properties": {
      -    "description": {
      -      "description": "Deliverable, service, or charge description.",
      -      "type": "string"
      -    },
      -    "discount": {
      -      "description": "Optional line-level discount amount.",
      -      "type": "number"
      -    },
      -    "quantity": {
      -      "description": "Quantity of units, hours, or months.",
      -      "type": "number"
      -    },
      -    "unit_price": {
      -      "description": "Unit rate or price per item.",
      -      "type": "number"
      -    }
      -  },
      -  "required": [
      -    "description",
      -    "quantity",
      -    "unit_price"
      -  ],
      -  "type": "object"
      -}
    • removedInput schema / properties / lease_package_mode
      Removed value: -{
      -  "description": "Appends mandatory state statutory attachment sheets and move-in checklist.",
      -  "type": "boolean"
      -}
    • removedInput schema / properties / municipality
      Removed value: -{
      -  "description": "Municipal sub-profile ('Chicago', 'Cook County', 'New York City', 'San Francisco', 'Seattle', 'Portland').",
      -  "type": "string"
      -}
    • removedInput schema / properties / notary_required
      Removed value: -{
      -  "description": "Renders a state-specific Notarial Acknowledgment and Jurat block.",
      -  "type": "boolean"
      -}
    • removedInput schema / properties / notes
      Removed value: -{
      -  "description": "Customer-facing notes or remittance instructions.",
      -  "type": "string"
      -}
    • removedInput schema / properties / number_decimals
      Removed value: -{
      -  "description": "Decimal places for formatted amounts (default 2).",
      -  "type": "integer"
      -}
    • changedInput schema / properties / payment_link / description
      Previous value: -"HTTPS checkout URL embedded as a link and vector QR code."New value: +"HTTPS checkout URL for QR code."
    • removedInput schema / properties / payment_qr_code
      Removed value: -{
      -  "description": "Embeds a vector SVG QR code when payment_link is provided.",
      -  "type": "boolean"
      -}
    • removedInput schema / properties / primary_color
      Removed value: -{
      -  "description": "Custom primary brand hex color (e.g., '#4f46e5').",
      -  "type": "string"
      -}
    • removedInput schema / properties / recordable
      Removed value: -{
      -  "description": "Applies County Recorder 3-inch top margin header and official stamp reserve.",
      -  "type": "boolean"
      -}
    • removedInput schema / properties / sections
      Removed value: -{
      -  "description": "Structured legal clauses or terms sections.",
      -  "items": {
      -    "properties": {
      -      "content": {
      -        "description": "Section body text.",
      -        "type": "string"
      -      },
      -      "title": {
      -        "description": "Section heading.",
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "title",
      -      "content"
      -    ],
      -    "type": "object"
      -  },
      -  "type": "array"
      -}
    • removedInput schema / properties / signatures
      Removed value: -{
      -  "description": "Multi-party signature blocks.",
      -  "items": {
      -    "properties": {
      -      "date": {
      -        "description": "Signature date.",
      -        "type": "string"
      -      },
      -      "signer_name": {
      -        "description": "Signer full name.",
      -        "type": "string"
      -      },
      -      "signer_title": {
      -        "description": "Signer title or role.",
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "signer_name"
      -    ],
      -    "type": "object"
      -  },
      -  "type": "array"
      -}
    • changedInput schema / properties / state_code / description
      Previous value: -"2-letter US state or DC code (e.g., 'TN', 'CA', 'NY') for 50-state statutory clauses."New value: +"2-letter US state or DC code."
    • removedInput schema / properties / tax_rate
      Removed value: -{
      -  "description": "Percentage tax rate applied to subtotal (e.g., 8.25).",
      -  "type": "number"
      -}
    • removedInput schema / properties / terms
      Removed value: -{
      -  "description": "Payment terms, late fee policy, or legal clauses.",
      -  "type": "string"
      -}
    • removedInput schema / properties / theme
      Removed value: -{
      -  "description": "Visual typography and color theme preset.",
      -  "enum": [
      -    "modern_slate",
      -    "executive_navy",
      -    "emerald",
      -    "crimson_legal",
      -    "warm_sand",
      -    "obsidian"
      -  ],
      -  "type": "string"
      -}
    • removedInput schema / properties / title
      Removed value: -{
      -  "description": "Custom document heading override (e.g., 'TAX INVOICE').",
      -  "type": "string"
      -}
    • changedInput schema / properties / to / description
      Previous value: -"Recipient, buyer, client, or tenant details."New value: +"Recipient or tenant details."
    • removedInput schema / properties / to / properties / address
      Removed value: -{
      -  "description": "Recipient billing or property address.",
      -  "type": "string"
      -}
    • removedInput schema / properties / to / properties / company
      Removed value: -{
      -  "description": "Recipient company name.",
      -  "type": "string"
      -}
    • removedInput schema / properties / to / properties / email
      Removed value: -{
      -  "description": "Recipient email address.",
      -  "type": "string"
      -}
    • changedInput schema / properties / to / properties / name / description
      Previous value: -"Recipient full or entity name (required)."New value: +"Recipient name."
    • removedInput schema / properties / to / properties / phone
      Removed value: -{
      -  "description": "Recipient phone number.",
      -  "type": "string"
      -}
    • removedInput schema / properties / to / properties / tax_id
      Removed value: -{
      -  "description": "Recipient tax ID.",
      -  "type": "string"
      -}
    • removedInput schema / properties / unit_measure
      Removed value: -{
      -  "description": "Unit suffix for quantities (e.g., 'hrs', 'mo', 'RSF').",
      -  "type": "string"
      -}
    • removedInput schema / properties / year_built
      Removed value: -{
      -  "description": "Property construction year (< 1978 triggers Federal Lead-Based Paint disclosure).",
      -  "type": "integer"
      -}
    • changedOutput schema / properties / compile_time_ms / description
      Previous value: -"Raster preview latency in milliseconds."New value: +"Compile time in ms."
    • changedOutput schema / properties / image_data_uri / description
      Previous value: -"Base64 PNG data URI (data:image/png;base64,...)."New value: +"Base64 PNG data URI."
  7. First observed

TDQS

B3.2/5.0
Behavior3/5

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

Annotations already declare readOnlyHint=false, destructiveHint=false, idempotentHint=false and openWorldHint=false, so the safety profile is covered. The description adds one genuinely useful behavior beyond them: the result may be a temporary image link returned over HTTP, signaling the URL is not durable. It says nothing about expiry duration, whether a document is persisted, or cost/latency.

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?

Two short sentences with the output artifact front-loaded and no filler. "Supplied document details" is slightly vague phrasing that could have named doc_type or the required parties, but nothing is wasteful.

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

Completeness3/5

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

The tool has 37 parameters, nested objects, and an output schema, yet the description is a single generic rendering sentence. The output schema and 100% schema coverage carry most of the load, but for a tool this complex the description should at least note the required inputs and the preview's temporary nature more concretely.

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

Parameters3/5

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

Schema description coverage is 100% across all 37 properties, so the schema fully documents parameters including the required doc_type/from/to. The description adds no parameter meaning beyond the schema, which is acceptable at this coverage level but earns only the baseline.

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

Purpose4/5

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

"Render a PNG preview from supplied document details" gives a specific verb (render) and resource (PNG preview of a document), so the agent knows exactly what the tool produces. It does not explicitly distinguish itself from the sibling generate_document, leaving the preview-vs-generate boundary implicit.

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

Usage Guidelines2/5

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

No statement of when to use this versus generate_document or convert_document, and no prerequisites or exclusions. The word "preview" hints at a non-final rendering, but the agent must infer that on its own.

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

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.