Skip to main content
Glama

Generate PDF Document

generate_document
Destructive

Generate a vector PDF from document details. HTTP calls can return a temporary download link. Configured customer sync can save contact details and start follow-up. See https://pressmark.dev/privacy.

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"
      },
      "items": [
        {
          "quantity": 1,
          "unit_price": 1500,
          "description": "Design retainer"
        }
      ],
      "doc_type": "invoice"
    },
    "name": "generate_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
downloadNoTemporary file link for HTTP tool calls.
doc_numberYesUser-supplied document number, or an empty string when omitted.
pdf_base64YesBase64 vector PDF.
grand_totalYesComputed grand total.
download_errorNoWhy a temporary download link could not be created. The embedded PDF is still available.
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. Changed11 schema fields changed
    • changedInput schema / properties / compliance_mode / description
      Previous value: -"Compliance banner (none, eu_vat, peppol_bis, hipaa_baa)."New value: +"Compliance topic note (none, eu_vat, peppol_bis, hipaa_baa)."
    • addedInput schema / properties / doc_number
      Added value: +{
      +  "description": "Document number. Left blank when omitted.",
      +  "type": "string"
      +}
    • addedInput schema / properties / due_date
      Added value: +{
      +  "description": "Payment due date (YYYY-MM-DD).",
      +  "type": "string"
      +}
    • changedInput schema / properties / execution_mode / description
      Previous value: -"Signature mode (esign, wet_ink, notarized_wet, ron)."New value: +"Signature layout (esign, wet_ink, notarized_wet, ron)."
    • addedInput schema / properties / issue_date
      Added value: +{
      +  "description": "Issue date (YYYY-MM-DD).",
      +  "type": "string"
      +}
    • changedInput schema / properties / notary_required / description
      Previous value: -"Render state notarial jurat block."New value: +"Add blank section for notary completion."
    • changedInput schema / properties / signatures / description
      Previous value: -"Multi-party signature blocks."New value: +"Signature fields with signer names, dates, and optional signature images."
    • addedInput schema / properties / signatures / items
      Added value: +{
      +  "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"
      +}
    • changedOutput schema / properties / doc_number / description
      Previous value: -"Document number."New value: +"User-supplied document number, or an empty string when omitted."
    • addedOutput schema / properties / download
      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 / download_error
      Added value: +{
      +  "description": "Why a temporary download link could not be created. The embedded PDF is still available.",
      +  "type": "string"
      +}
  6. Changed65 schema fields changed
    • addedInput schema / examples
      Added value: +[
      +  {
      +    "doc_type": "invoice",
      +    "from": {
      +      "name": "Acme Corp"
      +    },
      +    "items": [
      +      {
      +        "description": "Design retainer",
      +        "quantity": 1,
      +        "unit_price": 1500
      +      }
      +    ],
      +    "to": {
      +      "name": "Client LLC"
      +    }
      +  }
      +]
    • changedInput schema / properties / compliance_mode / description
      Previous value: -"Regulatory compliance notice banner."New value: +"Compliance banner (none, eu_vat, peppol_bis, hipaa_baa)."
    • removedInput schema / properties / compliance_mode / enum
      Removed value: -[
      -  "none",
      -  "eu_vat",
      -  "factur-x",
      -  "peppol_bis",
      -  "hipaa_baa",
      -  "zatca",
      -  "irs_w9",
      -  "pci_dss",
      -  "soc2_badge",
      -  "statutory_sworn"
      -]
    • changedInput schema / properties / county / description
      Previous value: -"County name for notarial jurat and recording cover header (e.g., 'Hamilton')."New value: +"County name for jurats and headers."
    • 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."
    • changedInput schema / properties / currency_placement / description
      Previous value: -"Place currency symbol/code before or after amounts."New value: +"Currency prefix or suffix placement."
    • removedInput schema / properties / currency_placement / enum
      Removed value: -[
      -  "prefix",
      -  "suffix"
      -]
    • changedInput schema / properties / currency_separators / description
      Previous value: -"Thousands and decimal separator style."New value: +"Number separators (comma_dot, dot_comma)."
    • removedInput schema / properties / currency_separators / enum
      Removed value: -[
      -  "comma_dot",
      -  "dot_comma",
      -  "space_comma",
      -  "apostrophe_dot",
      -  "plain"
      -]
    • changedInput schema / properties / currency_symbol_mode / description
      Previous value: -"Display currency symbol ('$') or ISO code ('USD')."New value: +"Display currency symbol or ISO code."
    • removedInput schema / properties / currency_symbol_mode / enum
      Removed value: -[
      -  "symbol",
      -  "code"
      -]
    • removedInput schema / properties / custom_fields / items
      Removed value: -{
      -  "properties": {
      -    "label": {
      -      "description": "Metadata field label.",
      -      "type": "string"
      -    },
      -    "value": {
      -      "description": "Metadata field value.",
      -      "type": "string"
      -    }
      -  },
      -  "required": [
      -    "label",
      -    "value"
      -  ],
      -  "type": "object"
      -}
    • changedInput schema / properties / date_format / description
      Previous value: -"Date rendering format."New value: +"Date format (iso, us_slash, euro, formal_prose)."
    • removedInput schema / properties / date_format / enum
      Removed value: -[
      -  "iso",
      -  "us_slash",
      -  "euro",
      -  "formal_prose",
      -  "short_abbrev",
      -  "short_dot"
      -]
    • 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, etc.)."
    • 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"
      -}
    • changedInput schema / properties / execution_mode / description
      Previous value: -"Execution and signature mode."New value: +"Signature mode (esign, wet_ink, notarized_wet, ron)."
    • removedInput schema / properties / execution_mode / enum
      Removed value: -[
      -  "esign",
      -  "wet_ink",
      -  "wet-ink",
      -  "notarized_wet",
      -  "ron",
      -  "notarized_ron"
      -]
    • changedInput schema / properties / from / description
      Previous value: -"Issuer, seller, landlord, or service provider details."New value: +"Issuer or landlord details."
    • changedInput schema / properties / from / properties / address / description
      Previous value: -"Issuer mailing address."New value: +"Issuer address."
    • removedInput schema / properties / from / properties / company
      Removed value: -{
      -  "description": "Issuer company name.",
      -  "type": "string"
      -}
    • changedInput schema / properties / from / properties / email / description
      Previous value: -"Issuer email address."New value: +"Issuer email."
    • 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 or rent schedule."
    • changedInput schema / properties / items / items / properties / description / description
      Previous value: -"Deliverable, service, or charge description."New value: +"Item description."
    • removedInput schema / properties / items / items / properties / discount
      Removed value: -{
      -  "description": "Optional line-level discount amount.",
      -  "type": "number"
      -}
    • changedInput schema / properties / items / items / properties / quantity / description
      Previous value: -"Quantity of units, hours, or months."New value: +"Item quantity."
    • changedInput schema / properties / items / items / properties / unit_price / description
      Previous value: -"Unit rate or price per item."New value: +"Unit price."
    • removedInput schema / properties / lease_package_mode
      Removed value: -{
      -  "description": "Appends mandatory state statutory attachment sheets and move-in checklist.",
      -  "type": "boolean"
      -}
    • changedInput schema / properties / municipality / description
      Previous value: -"Municipal sub-profile ('Chicago', 'Cook County', 'New York City', 'San Francisco', 'Seattle', 'Portland')."New value: +"Municipal profile (Chicago, Cook County, NYC, SF, Seattle, Portland)."
    • changedInput schema / properties / notary_required / description
      Previous value: -"Renders a state-specific Notarial Acknowledgment and Jurat block."New value: +"Render state notarial jurat block."
    • removedInput schema / properties / notes
      Removed value: -{
      -  "description": "Customer-facing notes or remittance instructions.",
      -  "type": "string"
      -}
    • changedInput schema / properties / number_decimals / description
      Previous value: -"Decimal places for formatted amounts (default 2)."New value: +"Decimal places for amounts (default 2)."
    • 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."
    • changedInput schema / properties / payment_qr_code / description
      Previous value: -"Embeds a vector SVG QR code when payment_link is provided."New value: +"Embed vector SVG QR code."
    • removedInput schema / properties / primary_color
      Removed value: -{
      -  "description": "Custom primary brand hex color (e.g., '#4f46e5').",
      -  "type": "string"
      -}
    • changedInput schema / properties / recordable / description
      Previous value: -"Applies County Recorder 3-inch top margin header and official stamp reserve."New value: +"Enable County Recorder 3-inch top margin."
    • changedInput schema / properties / sections / description
      Previous value: -"Structured legal clauses or terms sections."New value: +"Structured legal clause sections."
    • removedInput schema / properties / sections / items
      Removed value: -{
      -  "properties": {
      -    "content": {
      -      "description": "Section body text.",
      -      "type": "string"
      -    },
      -    "title": {
      -      "description": "Section heading.",
      -      "type": "string"
      -    }
      -  },
      -  "required": [
      -    "title",
      -    "content"
      -  ],
      -  "type": "object"
      -}
    • removedInput schema / properties / signatures / items
      Removed value: -{
      -  "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"
      -}
    • 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."
    • changedInput schema / properties / tax_rate / description
      Previous value: -"Percentage tax rate applied to subtotal (e.g., 8.25)."New value: +"Percentage tax rate."
    • 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."
    • changedInput schema / properties / to / properties / address / description
      Previous value: -"Recipient billing or property address."New value: +"Recipient address."
    • removedInput schema / properties / to / properties / company
      Removed value: -{
      -  "description": "Recipient company name.",
      -  "type": "string"
      -}
    • changedInput schema / properties / to / properties / email / description
      Previous value: -"Recipient email address."New value: +"Recipient email."
    • 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: -"Vector compilation latency in milliseconds."New value: +"Compile time in ms."
    • changedOutput schema / properties / doc_number / description
      Previous value: -"Assigned or effective document number."New value: +"Document number."
    • changedOutput schema / properties / pdf_base64 / description
      Previous value: -"Base64-encoded vector PDF bytes."New value: +"Base64 vector PDF."
  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 flag readOnlyHint=false, destructiveHint=true, openWorldHint=true and idempotentHint=false; the description adds real value by disclosing two side effects the agent would otherwise miss: an HTTP call may return a temporary download link, and configured customer sync can persist contact details and start a follow-up. However, it never explains why the operation is destructive, whether repeated calls create duplicate documents, or what external service is contacted, which is precisely what is most consequential here.

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?

Four short sentences with the core purpose front-loaded and no filler. The trailing privacy URL is relevant given that contact data syncs, though it is the weakest sentence in the block.

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?

With 37 parameters the schema does the heavy lifting and an output schema exists, so return-shape explanation is unnecessary. Still, for a destructive, non-idempotent generator with a hidden CRM write, the description should say whether repeat calls duplicate documents and what the sync means for the caller's data before invoking.

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 parameters, including doc_type, styles, and signature fields, so the schema carries the semantics. The description adds nothing about individual parameters beyond the generic phrase "document details," which earns the baseline 3 rather than more.

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?

The description states a specific verb and resource: "Generate a vector PDF from document details." An agent knows exactly what comes out. It stops short of distinguishing this from the sibling preview_document or convert_document, so the boundary is left 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?

There is no statement of when to call this rather than preview_document (dry run) or convert_document (format change). The remaining sentences describe side effects, not selection criteria, so an agent must infer the workflow from sibling names alone.

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.