order_send

Sends a letter physically by post: checks the sender's mandatory details, the recipient address, the AVV and the limits, creates the final PDF, calculates the price and releases the send. Look at the letter as an image first: letter_create_draft and letter_preview return the rendered pages, and typesetting defects such as an over-long subject show up only there. A letter arrives either via letterId (an existing draft) or inline: then the body is either content (plain text) OR blocks (structured: tables, headings, totals lines), exactly one of the two. Compact blocks example: {"blocks":[{"type":"heading","text":"Rechnung"},{"type":"table","columns":[{"key":"text","label":"Artikel","width":"grow"},{"key":"sum","label":"Summe","align":"right","format":"eur"}],"rows":[{"text":"Beratung","sum":32000}]},{"type":"totals","lines":[{"label":"Gesamt","amountCents":32000,"emphasis":true}]}]} Full reference incl. styleDefs and limits: MCP resource frankki://blocks-guide. By default the send first lands in the approval queue and a human decides via approval_decide. After that, poll progress with order_status. Two recovery paths: order_cancel cancels a letter before it goes to print, order_fix_resubmit corrects a letter the provider rejected and resubmits it. With dryRun the send is only rehearsed: free of charge, and the letter stays put. dryRun is the full rehearsal of this specific letter through all six gates and therefore the highest-fidelity price. A dryRun stays a pure rehearsal: the returned letterId is a rehearsal handle and answers NOT_FOUND in letter_get or letter_preview. For a real draft, use letter_create_draft. shipping_quote instead answers what a letter would cost while the content is still only planned; letter_preview shows a blocks draft as an image before it is sent here.

Input contract

Contract-shaped example

order_send({
  "letterId": "REVIEWED_LETTER_ID",
  "recipientName": "Max Mustermann",
  "recipientStreet": "Musterstrasse",
  "recipientHouseNumber": "1",
  "recipientZip": "10115",
  "recipientCity": "Berlin",
  "recipientCountry": "DE",
  "deliveryType": "einschreiben_einwurf",
  "priceVersion": "VERSION_FROM_QUOTE",
  "quotedUnitPriceCents": UNIT_PRICE_CENTS_FROM_QUOTE,
  "maxCostEuros": 10,
  "approvalMode": "review",
  "clientOrderId": "contract-482-send-v1",
  "dryRun": true
})

Replace quotedUnitPriceCents with the exact value returned by shipping_quote. Reuse the same clientOrderId and payload for retries; remove dryRun only for an intentional live submission.

For conditional fields and nested object limits, the generated complete tool reference remains authoritative. See errors and safe agent onboarding before implementing retries or a live send.