FrankKi
Server Details
The agentic layer of letters. Agents send real printed mail worldwide, German compliance built in.
- Status
- Healthy
- Uptime
- 100.0% over the last 24 hours
- OAuth
- Works in Glama
- Last Tested
- Transport
- Streamable HTTP · MCP 2025-11-25
- URL
- Repository
- datPascal/frankki-mcp
- GitHub Stars
- 1
- Server Listing
- FrankKi MCP
- ChatGPT
- –
- Claude
- –
TDQS
Scored across 76 tools
The set contains several overlapping families: approval_decide vs approval_decide_app, brand_import_from_website vs brand_setup_from_website vs brand_kit_save, letter_design_list vs letterhead_list, and letter_preview vs template_preview vs letter_design_preview. Detailed descriptions help, but with 76 tools an agent must still distinguish many similarly scoped lifecycle and preview operations.
Almost all tools use snake_case with a resource prefix and action suffix or verb (address_list, letter_get, template_save, wallet_balance). Minor deviations exist, such as German-derived order_einlieferungsbeleg, _app suffixed internal tools, and mixed verb/resource ordering, but the convention remains predictable.
76 tools is an extreme surface for one MCP server, far beyond the typical 3-15 well-scoped range. While the platform is broad, many tools are narrow internal-card utilities or overlapping preview/status helpers, making the set unwieldy.
Coverage is strong across addresses, sender profiles, brands, letterheads, signatures, templates, letters, approvals, orders, scheduling, documents, exports, wallet and setup. Some gaps remain, such as no mandant create/update tool and limited lifecycle operations for documents and orders beyond the existing get/list/cancel flows.
Available Tools
76 toolsaddress_listAdressen auflistenCRead-onlyInspect
Listet die Adressen im Partner-Adressbuch. Optional nach Name, Stadt oder Mandant gefiltert. EN: Lists the addresses in the partner address book. Optionally filtered by name, city or client.
Inputs: limit, offset, reasoning, searchQuery.
address_search_companyFirmenadresse suchenBRead-onlyInspect
Sucht Firmen und Behörden im Verzeichnis und liefert die passende Versandadresse inklusive Behörden-Postfach. EN: Searches companies and public authorities in the directory and returns the matching mailing address including an authority PO box.
Inputs: query (required), country, reasoning.
address_upsertAdresse speichernBDestructiveInspect
Legt eine Adresse im Partner-Adressbuch an oder aktualisiert sie. Validiert die Adresse anhand landesspezifischer Regeln. EN: Creates or updates an address in the partner address book. Validates the address using country-specific rules.
Inputs: city (required), name (required), street (required), zip, +8 more.
address_validateAdresse prüfenARead-onlyInspect
Prüft eine Adresse anhand landesspezifischer Regeln und liefert valid (dasselbe Urteil wie die Adressprüfung von order_send) sowie je Feld, was fehlt, falsch geformt ist oder vom Ort abweicht. Nur eine Prüfung, das Adressbuch bleibt unverändert; Anlegen und Ändern übernimmt address_upsert. EN: Validates an address using country-specific rules and returns valid (the same verdict as the order_send address check) plus, per field, what is missing, malformed or differs from the city. A check only, the address book is left untouched; address_upsert creates and changes addresses.
Inputs: city (required), name (required), street (required), zip, +8 more.
analytics_summaryAuswertungen abrufenARead-onlyInspect
Liefert die aggregierten Kennzahlen des Partnerkontos: Briefe pro Monat, Kosten pro Mandant zur Weiterberechnung, Laufzeiten bis zur Zustellung, Fehlerquoten und Ausgaben gegen die gesetzten Limits. Beträge sind Netto-Kosten in Cent. EN: Returns the partner account's aggregated metrics: letters per month, cost per mandant for rebilling, transit times to delivery, failure rates, and spend against configured limits. Amounts are net cost in cents.
Inputs: topN, since, until, metric, +2 more.
approval_decideFreigabe entscheidenADestructiveInspect
Gibt eine wartende Freigabe frei oder lehnt sie ab. 'approve' setzt voraus, dass diese OAuth-Verbindung die zusätzlich erteilte Berechtigung approval:self_approve trägt. Fehlt diese Berechtigung, öffnet der Mensch den zurückgegebenen approvalUrl und entscheidet im angemeldeten Portal. approval:decide bleibt ebenfalls erforderlich. Bei Freigabe durch den Agenten geht der Brief nach 10 Minuten raus und kann bis dahin mit order_cancel gestoppt werden. EN: Approves or rejects a pending approval. 'approve' requires that this OAuth connection carries the separately granted approval:self_approve scope. When that scope is absent, the human opens the returned approvalUrl and decides in the signed-in portal. approval:decide is also required. An agent approval dispatches after 10 minutes and can be stopped with order_cancel until then.
Inputs: decision (required), approvalId (required), comment, reasoning, +1 more.
approval_decide_appFreigabe mit AgentenberechtigungBDestructiveInspect
App-internes Entscheidungs-Tool. Ein Aufruf gibt frei, wenn die verifizierte OAuth-Verbindung approval:self_approve trägt. Kartenansicht und cardNonce dienen nur als Vorschau-Beleg. Bei fehlender Berechtigung führt die Freigabe-Karte zum angemeldeten Browser. EN: Internal app decision tool. A call approves when the verified OAuth connection carries approval:self_approve. The card view and cardNonce serve only as preview evidence. When permission is absent, the approval card leads to the signed-in browser.
Inputs: decision (required), approvalId (required), cardNonce, reasoning.
approval_listFreigaben auflistenARead-onlyInspect
Listet die Freigaben des Kontos, neueste zuerst, mit einer zeitlich begrenzten PDF-Vorschau, den Kosten, dem Grund und den Fristen. Standardmäßig die offenen Freigaben und die freigegebenen Briefe, die noch in ihrem Stornofenster warten (Autopilot, Chat); graceState nennt dispatchAt. status all zeigt alles. approval_decide entscheidet über eine der zurückgegebenen approvalIds. EN: Lists the account's approvals, newest first, with a time-limited PDF preview, the cost, the reason and the deadlines. By default the pending approvals plus approved letters still waiting in their cancel window (autopilot, chat); graceState names dispatchAt. status all lists everything. approval_decide decides on one of the returned approvalIds.
Inputs: limit, since, offset, status, +2 more.
approval_page_urls_appBildlinks der Freigabe-Karte erneuernARead-onlyInspect
Nur für die interaktive Freigabe-Karte: erneuert die zeitlich begrenzten Bildlinks der Briefseiten, wenn die alten abgelaufen sind. EN: For the interactive approval card only: renews the time-limited image links of the letter pages once the old ones have expired.
Inputs: approvalId (required).
approval_status_appFreigabestand für die Karte lesenBRead-onlyInspect
Nur für die interaktive Freigabe-Karte: liest den aktuellen Zustand einer Freigabe, damit eine alte Karte den richtigen Endzustand und den Countdown zeigt. EN: For the interactive approval card only: reads the current state of an approval so an old card renders the correct end state and countdown.
Inputs: approvalId (required).
approval_submitZur Freigabe einreichenBInspect
Reicht einen Brief zur menschlichen Freigabe ein: prüft Pflichtangaben, Empfänger, AVV und Limits, erstellt die finale PDF, berechnet den Preis, reserviert die Kosten und legt eine Freigabe in der Warteschlange an. Sie wartet auf die Entscheidung eines Menschen, auch mit Autopilot. Die eingebettete Karte ist Vorschau und Freigabe. PDF-Link und Brieftext stehen zusätzlich im Ergebnis, für reine Textansichten. Mit approval:self_approve zeigt die Karte Freigeben und Ablehnen. In allen anderen Fällen führt sie ins angemeldete Portal. Mit dryRun bleiben Guthaben und Warteschlange unberührt, und die Antwort enthält die Liste checks (jede Prüfung mit passed, failed oder skipped). EN: Submits a letter for human approval: checks mandatory details, recipient, data processing agreement and limits, creates the final PDF, calculates the price, reserves the cost and adds an approval to the queue. It waits for a person's decision, also with autopilot. The embedded card is the preview and approval. The PDF link and letter text are also in the result, for text-only views. With approval:self_approve, the card shows Approve and Reject. In every other case it opens the signed-in portal. With dryRun, the balance and queue remain untouched, and the answer contains the checks list (each gate with passed, failed or skipped).
Inputs: color, dryRun, reason, content, +26 more.
archive_exportArchiv exportierenAInspect
Plant einen Archiv-Export (GoBD-CSV, DATEV, PDF-Bundle oder Mandanten-Allokation) für einen Zeitraum ein und liefert eine Job-ID zur Statusabfrage. EN: Schedules an archive export (GoBD CSV, DATEV, PDF bundle or client allocation) for a date range and returns a job ID to query its status.
Inputs: since (required), until (required), format (required), target, +4 more.
archive_export_statusArchiv-Export-Status abrufenBRead-onlyInspect
Liefert den Status eines Archiv-Export-Jobs und bei Fertigstellung eine 90 Tage gültige Download-URL. EN: Returns the status of an archive export job and, once complete, a download URL valid for 90 days.
Inputs: jobId (required), reasoning.
attachment_upload_imageBild-Anhang hochladenAInspect
Lädt ein Bild (PNG/JPEG) als Anhang zu einem Partner-Brief hoch. Das Bild wird serverseitig auf eine A4-PDF-Seite skaliert (optional gedreht) und wie ein PDF gespeichert. Prüft vor dem Speichern die zusammengeführte Seitenzahl (max. 30 Seiten). Die EXIF-Orientierung wird automatisch in die Pixel eingerechnet, ein Handyfoto steht also von selbst aufrecht. rotation dreht das Bild zusätzlich um die angegebenen Grad weiter; 0 lässt es so, wie es hochgeladen wurde. EN: Uploads an image (PNG/JPEG) as an attachment to a partner letter. The image is scaled to an A4 PDF page server-side (optionally rotated) and stored like a PDF. Before saving, it checks the merged page count (max. 30 pages). EXIF orientation is applied to the pixels automatically, so a phone photo is upright by itself. rotation turns the image further by the given degrees; 0 keeps it as uploaded.
Inputs: letterId (required), title, imageUrl, position, +3 more.
attachment_upload_pdfPDF-Anhang hochladenAInspect
Lädt ein PDF als Anhang zu einem Partner-Brief hoch. Prüft vor dem Speichern die Dateigröße (max. 50 MB) und die zusammengeführte Seitenzahl (max. 30 Seiten inkl. Brief und übriger Anhänge). Gedruckt wird nur A4 hochkant: eine andere Seite (US Letter, A5, quer) setzt FrankKi verkleinert auf A4, und die Antwort nennt sie in pageFormatNote. EN: Uploads a PDF as an attachment to a partner letter. Before saving, it checks the file size (max. 50 MB) and the merged page count (max. 30 pages including the letter and other attachments). Printing is A4 portrait only: FrankKi shrinks any other page (US Letter, A5, landscape) onto A4, and the answer names it in pageFormatNote.
Inputs: letterId (required), title, pdfUrl, position, +2 more.
brand_import_from_websiteMarke von der Website übernehmenAInspect
Liest eine öffentliche Firmenwebsite aus und schlägt daraus ein Briefkopf-Design vor: Markenfarben, Hausschriftzuordnung, Logo-Kandidaten und Firmendaten aus dem Impressum. Die gefundenen Logos landen als Design-Assets im Konto und sind sofort verwendbar. Das Ergebnis ist ein Vorschlag zur Abstimmung mit der Kundin oder dem Kunden; übernommen wird die Marke erst durch einen anschließenden Aufruf von brand_kit_save mit brandingOwnershipConfirmed. Technischer Tool-Name: brand_import_from_website. EN: Reads a public company website and proposes a letterhead design from it: brand colours, a mapped house typeface, logo candidates and company details from the imprint. Found logos are stored as design assets in the account and are usable right away. The result is a proposal to review with the customer; the brand is adopted by a following brand_kit_save call carrying brandingOwnershipConfirmed. Technical tool name: brand_import_from_website.
Inputs: websiteUrl (required), reasoning, maxLogoCandidates.
brand_kit_getBriefkopf & Marke abrufenBRead-onlyInspect
Liest die gespeicherten Markenwerte für das nutzerseitige Ergebnis Briefkopf & Marke. Liefert Logo-Referenzen, Farben und Schrift für die weitere Gestaltung mit letter_design_preview und letter_design_save. Technischer Tool-Name: brand_kit_get. EN: Reads the saved brand values for the user-facing result letterhead and brand. Returns logo references, colours and font for further work with letter_design_preview and letter_design_save. Technical tool name: brand_kit_get.
Inputs: reasoning.
brand_kit_saveBriefkopf & Marke speichernBDestructiveInspect
Speichert Logo-Referenzen, Farben und Schrift für das nutzerseitige Ergebnis Briefkopf & Marke. brandingOwnershipConfirmed muss true sein und bestätigt die Nutzungsrechte an den angegebenen Marken-Assets. Die Antwort enthält den gespeicherten Stand und den Prüflink. Technischer Tool-Name: brand_kit_save. EN: Saves logo references, colours and font for the user-facing result letterhead and brand. brandingOwnershipConfirmed must be true and confirms the usage rights for the supplied brand assets. The response includes the saved state and review link. Technical tool name: brand_kit_save.
Inputs: brandKit (required), brandingOwnershipConfirmed (required), reasoning.
brand_setup_from_websiteAbsender und Briefpapier von der Website einrichtenADestructiveInspect
Firmenwebsite zu Absender, Marke und Briefpapier in zwei Aufrufen. apply false liest die Website und liefert einen Vorschlag: Logo, Farben, Schrift, Absenderprofil mit Pflichtangaben aus dem Impressum, Absenderadresse und ein passendes Briefpapier, dazu die fehlenden Pflichtangaben, die eine Frage an die Person und Seite 1 dieses Briefpapiers als Bild (letterheadPreview). apply true speichert alles auf einmal mit der proposalId daraus und brandingOwnershipConfirmed true: Marke, Absenderprofil, Absenderadresse, Briefpapier mit Logo als Standard, und zeigt eine Vorschau als Bild. Bestehende Angaben der Person bleiben erhalten, senderOverrides gehen vor. Nächster Schritt: template_clone_from_library. Technischer Tool-Name: brand_setup_from_website. EN: Company website to sender, brand and letterhead in two calls. apply false reads the website and returns a proposal: logo, colours, typeface, sender profile with mandatory details from the imprint, sender address and a matching letterhead, plus the missing details, the one question for the person and page 1 of that letterhead as an image (letterheadPreview). apply true saves everything at once with its proposalId and brandingOwnershipConfirmed true: brand, sender profile, sender address, letterhead with logo as default, and shows a preview image. Details the person already has on file stay, senderOverrides take precedence. Next step: template_clone_from_library. Technical tool name: brand_setup_from_website.
Inputs: websiteUrl (required), apply, proposal, reasoning, +4 more.
document_createBeleg erstellenADestructiveInspect
Erzeugt aus strukturierten Belegdaten ein fertiges Dokument und legt es als Briefentwurf an: FrankKi rechnet Positionen, Netto, USt-Sätze und Brutto nach, prüft die Pflichtangaben nach § 14 UStG, vergibt auf Wunsch die Belegnummer aus dem Nummernkreis des Kontos und setzt alles im DIN-5008-Layout mit dem Briefdesign des Absenders. Der Entwurf bleibt kostenfrei liegen, bis er versendet wird. Alle Beträge in ganzen Cent. Kompaktes Beispiel: {"document":{"documentType":"rechnung","documentNumber":"RE-2026-014","documentDate":"2026-07-30","leistungszeitraum":{"von":"2026-06-01","bis":"2026-06-30"},"zahlungszielTage":14,"lineItems":[{"description":"Beratung Juni","quantity":4,"unit":"Std","unitPriceCents":12000,"ustRate":19,"lineNetCents":48000}],"totals":{"nettoCents":48000,"ustLines":[{"rate":19,"netCents":48000,"ustCents":9120}],"bruttoCents":57120}},"recipientAddressId":"…"} Nächster Schritt mit der zurückgegebenen letterId: order_send versendet den Brief, approval_submit legt ihn stattdessen einem Menschen zur Freigabe vor, letter_schedule versendet ihn später. EN: Turns a structured billing payload into a finished document and stores it as a letter draft: FrankKi re-computes line items, net, VAT rates and gross, checks the mandatory details under § 14 UStG, optionally draws the document number from the account's sequence, and typesets everything in the DIN 5008 layout with the sender's letter design. The draft stays free of charge until it is sent. All amounts in integer cents. Compact example: {"document":{"documentType":"rechnung","documentNumber":"RE-2026-014","documentDate":"2026-07-30","leistungszeitraum":{"von":"2026-06-01","bis":"2026-06-30"},"zahlungszielTage":14,"lineItems":[{"description":"Beratung Juni","quantity":4,"unit":"Std","unitPriceCents":12000,"ustRate":19,"lineNetCents":48000}],"totals":{"nettoCents":48000,"ustLines":[{"rate":19,"netCents":48000,"ustCents":9120}],"bruttoCents":57120}},"recipientAddressId":"…"} Next step with the returned letterId: order_send sends the letter, approval_submit puts it in front of a human for approval instead, letter_schedule sends it later.
Inputs: document (required), subject, designId, language, +11 more.
document_getBeleg abrufenARead-onlyInspect
Liefert ein Dokument mit allen Belegdaten (Positionen, Summen, USt-Sätze, Bezug) sowie letterId und orderId des Briefs, in dem es steckt. Das Feld referencePrefill enthält den fertigen references-Block für einen Folgebeleg: document_create übernimmt ihn unverändert als document.references für Mahnung, Zahlungserinnerung oder Gutschrift. Unter exports liefert FrankKi für versendete Rechnungen und Gutschriften signierte Download-Links: zugferdPdfUrl ist ein PDF/A-3 mit eingebetteter EN-16931-XML (ZUGFeRD), xrechnungXmlUrl die reine XRechnung-XML. Beide sind zum Herunterladen und Archivieren gedacht; die Übermittlung an ein Portal liegt beim Partner. Fehlt ein Export, nennt das Feld den Grund: DOCUMENT_EXPORT_NOT_READY heißt vorläufig, ein späterer Aufruf liefert den Export (Versand oder Freischaltung stehen noch aus), DOCUMENT_EXPORT_NOT_SUPPORTED heißt dauerhaft (der Export gilt für Rechnungen und Gutschriften; für Mahnung und Zahlungserinnerung trägt die Rechnung, auf die sie sich beziehen, den Export). Nächster Schritt: order_status verfolgt den Versand, document_create legt mit references eine Mahnung oder Gutschrift dazu an. EN: Returns one document with its full payload (line items, totals, VAT rates, reference) plus the letterId and orderId of the letter it lives in. The field referencePrefill carries the ready-made references block for a follow-up document: document_create takes it unchanged as document.references for a dunning letter, payment reminder or credit note. Under exports FrankKi returns signed download links for sent invoices and credit notes: zugferdPdfUrl is a PDF/A-3 with embedded EN 16931 XML (ZUGFeRD), xrechnungXmlUrl the pure XRechnung XML. Both are download-only; transmitting an e-invoice to a portal stays with the partner. When an export is missing the slot names the reason: DOCUMENT_EXPORT_NOT_READY means for now, a later call returns the export (the send or the activation is still pending), DOCUMENT_EXPORT_NOT_SUPPORTED means permanently (the export covers invoices and credit notes; for a dunning letter or payment reminder the invoice they refer to carries the export). Next step: order_status tracks the send, document_create creates a dunning letter or credit note via references.
Inputs: documentId (required), reasoning.
document_listBelege auflistenARead-onlyInspect
Listet die erzeugten Dokumente des Kontos (Rechnung, Zahlungserinnerung, Mahnung, Gutschrift), neueste zuerst, gefiltert nach Art, Mandant, Empfänger oder Bezugsbeleg. Nächster Schritt: document_get liefert die vollständigen Belegdaten, document_create legt mit references einen Folgebeleg dazu an. EN: Lists the account's created documents (invoice, payment reminder, dunning letter, credit note), newest first, filtered by type, client, recipient or referenced document. Next step: document_get returns the full payload, document_create creates a follow-up document via references.
Inputs: limit, since, offset, reasoning, +5 more.
letter_create_draftBriefentwurf anlegenAInspect
Legt einen Briefentwurf an: erstellt eine Vorschau-PDF im hinterlegten Briefdesign (nur der Brieftext), speichert den Entwurf und liefert Seitenzahl, Vorschau-Link (24 Stunden gültig) und eine unverbindliche Kostenvorschau. Der Entwurf bleibt kostenfrei liegen, bis er versendet wird. Der Brieftext ist entweder content (Fließtext) ODER blocks (strukturiert: Tabellen, Überschriften, Summenzeilen), genau eines von beiden. Kompaktes blocks-Beispiel: {"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}]}]} Schema-Referenz inkl. styleDefs und Limits: MCP-Ressource frankki://blocks-guide. Die ersten Seiten kommen als Bild zurück und zeigen Betreff, Anschrift im Adressfenster, Absender, Datum und Umbrüche so, wie sie gedruckt werden. Die eingebettete Karte ist die Vorschau für den Menschen; PDF-Link und Brieftext stehen zusätzlich im Ergebnis, für reine Textansichten. Gemeldete Auffälligkeiten stehen in warnings. Ein neuer Aufruf legt einen korrigierten Entwurf an; ein gedruckter Brief ist endgültig. Für eine Mahnung, Kündigung, Mieterhöhung oder einen anderen Brief mit Frist gibt es das Einschreiben mit Nachweis; seinen Preis liefert shipping_quote. Nächster Schritt mit der zurückgegebenen letterId: letter_preview zeigt den Entwurf als Bild zum Nachbessern, order_send versendet ihn, letter_schedule versendet ihn zu einem späteren Zeitpunkt. EN: Creates a letter draft: produces a preview PDF in the stored letter design (letter body only), stores the draft and returns page count, preview link (valid for 24 hours) and a non-binding cost estimate. The draft stays free of charge until it is sent. 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}]}]} Schema reference incl. styleDefs and limits: MCP resource frankki://blocks-guide. The first pages come back as images and show subject, address in the address window, sender, date and line breaks as they will print. The embedded card is the human preview; the PDF link and letter text are also in the result, for text-only views. Reported findings are in warnings. A new call creates a corrected draft; a printed letter is final. For a Mahnung, Kündigung, Mieterhöhung or other deadline letter, Einschreiben adds a proof of posting; shipping_quote returns its price. Next step with the returned letterId: letter_preview shows the draft as an image to refine it, order_send sends the draft, letter_schedule sends it at a later time.
Inputs: subject (required), blocks, content, designId, +19 more.
letter_design_deleteBriefdesign löschenADestructiveInspect
Archiviert (löscht) ein gespeichertes Briefpapier (Briefdesign). Neue Sendungen laufen danach über die verbleibenden Briefpapiere, egal ob Kündigung, Rechnung, Mahnung, Angebot, Vertrag oder Behördenpost; bereits versendete Briefe behalten ihr Original zur Nachvollziehbarkeit. EN: Archives (deletes) a saved letterhead (letter design). New sends then run on the remaining letterheads, whether cancellation, invoice, payment reminder, quote, contract or letter to a public authority; already-sent letters keep their original for auditability.
Inputs: designId (required), reasoning.
letter_design_listBriefdesigns auflistenARead-onlyInspect
Listet die gespeicherten Briefpapiere (Briefdesigns) des Partners mit Name, ID und Hashes; mit designId liefert es ein Design samt vollständigem Design-JSON. Ein Design wird per Name oder ID beim Versand referenziert und trägt jede Post: Kündigung, Rechnung, Mahnung, Angebot, Vertrag und Behördenpost. EN: Lists the partner's saved letterheads (letter designs) with name, id and hashes; with designId it returns one design with its full design JSON. A design is referenced by name or id when sending and carries every kind of mail: cancellation, invoice, payment reminder, quote, contract and letters to public authorities.
Inputs: designId, reasoning, includeArchived.
letter_design_list_presetsBriefdesign-Vorlagen auflistenBRead-onlyInspect
Liefert die vom Inhaber freigegebenen native-v2 Briefpapiere als sichere Ausgangspunkte für Kündigung, Rechnung, Mahnung, Angebot, Vertrag und Behördenpost. Sie wächst mit jeder abgenommenen Vorlage. Die normale Liste nennt je Vorlage ID, Name, Beschreibung und Schlagwörter; mit presetId kommen das vollständige Design und genau eine echte Composer-Vorschau samt Inline-PNG. EN: Returns the owner-approved native-v2 letterheads as safe starting points for cancellations, invoices, payment reminders, quotes, contracts and letters to public authorities. It grows with every curated design that passes review. The plain list gives id, name, description and tags per preset; presetId returns the full design and exactly one real-composer preview with an inline PNG.
Inputs: pages, presetId, reasoning, resolution.
letter_design_previewBriefdesign ansehenARead-onlyInspect
Rendert ein gespeichertes oder inline übergebenes Briefdesign (schemaVersion 1 oder 2) mit demselben Composer wie ein echter Versand, mit echten Absenderdaten, erfundenem Empfänger und Beispieltext. Liefert eine Inline-PNG-Seite, Seite 2 nur für continuationHeader, mit pages 0 nur Links. sampleVariant empty zeigt das Briefpapier allein, wie im Dashboard. Das zeigt vorab Kündigung, Rechnung, Mahnung, Angebot, Vertrag und Behördenpost auf diesem Briefpapier. Kostenfrei, der Brief bleibt ein Entwurf. EN: Renders a saved or inline letter design (schemaVersion 1 or 2) with the same composer as a real send, using real sender data, a fictional recipient and sample text. Returns one inline PNG page, page 2 only for continuationHeader, links only with pages 0. sampleVariant empty shows the stationery alone, as in the dashboard. It previews a cancellation, invoice, payment reminder, quote, contract or letter to a public authority on this stationery. Free of charge; the letter stays a draft.
Inputs: pages, design, designId, reasoning, +5 more.
letter_design_saveBriefdesign speichernCInspect
Speichert ein wiederverwendbares Briefpapier (Briefdesign) mit schemaVersion 1 oder 2 im Partnerprofil und gibt designId sowie den Hash der gespeicherten Quelldaten zurück. Dasselbe Briefpapier trägt danach jede Post: Kündigung, Rechnung, Mahnung, Angebot, Vertrag und Behördenpost. Der technische Tool-Name ist letter_design_save. Das Design wird vor dem Speichern vollständig validiert und gegen die Zustellzonen geprüft. EN: Saves a reusable schemaVersion 1 or 2 letterhead (letter design) in the partner profile and returns its designId and stored-source hash. The same stationery then carries every kind of mail: cancellation, invoice, payment reminder, quote, contract and letters to public authorities. The technical tool name is letter_design_save. The design is fully validated and checked against postal clear zones before it is stored.
Inputs: name (required), design (required), designId, reasoning, +1 more.
letter_getBrief abrufenBRead-onlyInspect
Liefert einen Brief des Partners samt zugehörigem Auftrag und einer 24 Stunden gültigen Download-URL für die PDF. status ist der Briefstatus; vor dem Auftrag trägt ein Brief in der Freigabe denselben Status wie in order_status: pending_approval, approved_in_grace oder queued_autopilot, dazu approval mit approvalId. letterStatus ist der gespeicherte Briefstatus. EN: Returns one of the partner's letters together with its order and a download URL for the PDF valid for 24 hours. status is the letter status; before the order exists, a letter in the approval queue carries the same status as in order_status: pending_approval, approved_in_grace or queued_autopilot, plus approval with its approvalId. letterStatus is the stored letter status.
Inputs: orderId, letterId, reasoning.
letterhead_listBriefköpfe auflistenARead-onlyInspect
Listet die im Partnerprofil gespeicherten Briefköpfe mit einer kurzlebigen Vorschau-URL (24 Stunden gültig). EN: Lists the letterheads stored in the partner profile with a short-lived preview URL (valid for 24 hours).
Inputs: reasoning.
letterhead_uploadBriefkopf hochladenAInspect
Lädt einen Briefkopf als PNG oder PDF hoch und speichert ihn im Partnerprofil. Quelle ist entweder fileUrl oder fileBase64, genau eine von beiden; fileUrl hält die Datei aus dem Aufruf heraus. PNG wird auf die Seite gedruckt; ein PDF-Briefkopf wird vorerst nur abgelegt, gedruckt wird bisher nur PNG (rendered=false). Beim Nachbau eines vorhandenen Briefs: Logo und Titelblock aus dem Kopf der Seite gehören hierher (dann letter_design_save); der Brieftext bleibt den blocks vorbehalten. EN: Uploads a letterhead as PNG or PDF and stores it in the partner profile. The source is either fileUrl or fileBase64, exactly one of the two; fileUrl keeps the file out of the call payload. PNG is printed on the page; a PDF letterhead is only filed for now, printing stays PNG-only (rendered=false). When rebuilding an existing letter: the logo and title block at the top of the page belong here (then letter_design_save); the letter body stays reserved for blocks.
Inputs: fileUrl, widthMm, heightMm, placement, +3 more.
letter_listBriefe auflistenARead-onlyInspect
Listet die Briefe des Partners mit optionalen Filtern nach Empfängername, Betreff, Status und Zeitpunkt. status ist der Briefstatus; vor dem Auftrag trägt ein Brief in der Freigabe denselben Status wie in order_status: pending_approval, approved_in_grace oder queued_autopilot, dazu approval mit approvalId. letterStatus ist der gespeicherte Briefstatus. EN: Lists the partner's letters with optional filters by recipient name, subject, status and time. status is the letter status; before the order exists, a letter in the approval queue carries the same status as in order_status: pending_approval, approved_in_grace or queued_autopilot, plus approval with its approvalId. letterStatus is the stored letter status.
Inputs: limit, since, offset, reasoning, +3 more.
letter_page_urls_appBildlinks der Brief-Ansicht erneuernARead-onlyInspect
Nur für die interaktive Brief-Ansicht: erneuert die zeitlich begrenzten Bildlinks der Briefseiten, wenn die alten abgelaufen sind. EN: For the interactive letter view only: renews the time-limited image links of the letter pages once the old ones have expired.
Inputs: letterId (required).
letter_previewBrief und Vorlage prüfenARead-onlyInspect
Rendert einen Brief, Entwurf oder ein Formular als Bild, so wie ein echter Versand ihn komponiert, und liefert Inline-PNGs, PDF-Link, Seitenzahl, Preis und designRender mit dem tatsächlichen documentMode, den gezeichneten Brief-Elementen und bodyStartMm. Die Vorschau ist kostenfrei, und der Brief bleibt liegen. Der Brief kommt über letterId, über eine freigegebene Vorlage (templateId, templateVersionId, templateMergeValues) oder inline mit content ODER blocks; der Empfänger über recipientAddressId oder die recipient-Felder. Bei letterId ist die eingebettete Karte die Vorschau für den Menschen; PDF-Link und Brieftext stehen zusätzlich im Ergebnis, für reine Textansichten. Ein ungespeichertes design gilt nur für diese eine Vorschau. Eigenständige Formulare (Selbstauskunft, Fragebogen, Zertifikat) rendern mit design: { "schemaVersion": 1, "documentMode": "form" } als Formular: dann entfallen Empfängerblock, Datum und Betreff, und der Inhalt beginnt bei 27 mm. Kompaktes blocks-Beispiel: {"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}]}]} Schema-Referenz: frankki://blocks-guide. Beim Nachbau eines Originals zeigen die PNGs Seite für Seite, ob Seitenzahl und wesentliche Geometrie passen; geänderte blocks oder ein geändertes design rendern im nächsten letter_preview-Aufruf neu. Das passende Layout speichert template_save als Entwurf, template_release gibt es frei. EN: Renders a letter, draft or form as images, composed like a real send, and returns inline PNGs, PDF link, page count, cost and designRender with the actual documentMode, rendered letter chrome and bodyStartMm. The preview is free and the letter stays put. The letter comes via letterId, a released template (templateId, templateVersionId, templateMergeValues) or inline content OR blocks; the recipient via recipientAddressId or the recipient fields. With letterId, the embedded card is the human preview; the PDF link and letter text are also in the result, for text-only views. An unsaved design applies to this one preview only. Standalone forms (self-declaration, questionnaire, certificate) render as a form with design: { "schemaVersion": 1, "documentMode": "form" }: that drops recipient block, date and subject and starts content at 27 mm. Schema reference: frankki://blocks-guide. For a rebuild of an original, the PNGs show page by page whether page count and major geometry match; changed blocks or a changed design render again on the next letter_preview call. template_save stores the matching layout as a draft, template_release releases it.
Inputs: pages, blocks, design, content, +20 more.
letter_scheduleVersand planenADestructiveInspect
Plant den Versand eines bestehenden Entwurfs für einen späteren Zeitpunkt (fester Termin, relative Verzögerung oder wiederkehrend per cron). Alle Prüfungen und der Preis werden sofort ermittelt und die Kosten reserviert. Eine echte OAuth-Verbindung legt zuerst eine Freigabe an. Die eingebettete Karte ist Vorschau und Freigabe. PDF-Link und Brieftext stehen zusätzlich im Ergebnis, für reine Textansichten. Eine OAuth-Verbindung mit approval:self_approve darf über die Karte entscheiden. Nach der Freigabe entsteht die Planung, der eigentliche Versand läuft zum geplanten Zeitpunkt durch dieselbe Versandpipeline und denselben Freigabeweg wie order_send. EN: Schedules an existing draft for a later time (fixed date, relative delay or recurring via cron). All checks and the price are determined immediately and the cost is reserved. A real OAuth connection creates an approval first. The embedded card is the preview and approval. The PDF link and letter text are also in the result, for text-only views. An OAuth connection with approval:self_approve may decide through the card. Approval creates the schedule, and the actual send runs at the planned time through the same send pipeline and approval path as order_send.
Inputs: mode (required), letterId (required), color, delay, +22 more.
letter_searchBriefe durchsuchenCRead-onlyInspect
Durchsucht die Briefe des Partners per Freitext über Betreff, Empfängername und Briefinhalt. status ist der Briefstatus; vor dem Auftrag trägt ein Brief in der Freigabe denselben Status wie in order_status: pending_approval, approved_in_grace oder queued_autopilot, dazu approval mit approvalId. letterStatus ist der gespeicherte Briefstatus. EN: Full-text searches the partner's letters across subject, recipient name and letter content. status is the letter status; before the order exists, a letter in the approval queue carries the same status as in order_status: pending_approval, approved_in_grace or queued_autopilot, plus approval with its approvalId. letterStatus is the stored letter status.
Inputs: query (required), limit, since, offset, +1 more.
letter_upload_pdfEigene Brief-PDF hochladenAInspect
Lädt einen fertigen Brief als PDF hoch, der genau so verschickt wird, wie er ist. Die Prüfung schaut, ob die Empfängeradresse im Adressfeld der Versandart steht. Beim Standardbrief liegt es 60 bis 85,5 mm von oben, beim Einschreiben 68 bis 85,5 mm, jeweils 22 bis 107,5 mm von links. Der übrige Fensterbereich bleibt leer, an jeder Kante bleiben 5 mm frei, und jede Seite ist A4 hochkant. Zurück kommen pdfStorageKey, die Funde mit den Millimetern zum Verschieben und Seite 1 mit eingezeichneten Zonen. sendable sagt, ob order_send diesen pdfStorageKey annimmt. Weichen nur PLZ oder Ort ab, lassen sich entweder die Empfängerfelder oder die PDF korrigieren; jeder andere Fund braucht eine korrigierte PDF und einen neuen Upload. Kostenlos. EN: Uploads a finished letter PDF that is sent exactly as it is. The check looks at whether the recipient address sits in the address zone of the delivery method. For a standard letter that is 60 to 85.5 mm from the top, for Einschreiben 68 to 85.5 mm, both 22 to 107.5 mm from the left. The rest of the window area stays empty, every edge keeps 5 mm clear, and every page is A4 portrait. The result holds pdfStorageKey, the findings with the millimetres to move, and page 1 with the zones drawn in. sendable says whether order_send accepts this pdfStorageKey. When only the postcode or city differs, either the recipient fields or the PDF can be corrected; every other finding needs a corrected PDF and a new upload. Free.
Inputs: pdfUrl, pdfBase64, reasoning, deliveryType, +2 more.
mandant_getMandant abrufenCRead-onlyInspect
Liefert einen Mandanten mit Adressen, Kategorie, Sachbearbeiter, Monatslimit, verbrauchtem Monatsbudget, Aufbewahrungsdauer und der Briefanzahl der letzten 12 Monate. EN: Returns a client (Mandant) with addresses, category, case handler, monthly cap, monthly budget used, retention period and the letter count of the last 12 months.
Inputs: mandantId, reasoning, mandantennummer.
mandant_listMandanten auflistenBRead-onlyInspect
Listet die Mandanten des Partners, optional gefiltert nach Suchbegriff, Kategorie oder Tag. EN: Lists the partner's clients (Mandanten), optionally filtered by search term, category or tag.
Inputs: limit, since, offset, reasoning, +3 more.
mandant_searchMandanten suchenARead-onlyInspect
Sucht Mandanten über Mandantennummer, Name, Tags oder Sachbearbeiter und nennt für jeden Treffer die passende Spalte. Nächster Schritt mit der gefundenen mandantennummer: document_create erzeugt daraus eine Rechnung, Mahnung, Zahlungserinnerung oder Gutschrift, mandant_get liefert die vollständigen Stammdaten, letter_create_draft schreibt einen normalen Brief. EN: Searches clients (Mandanten) by client number, name, tags or case handler and names the matching column for each hit. Next step with the matched mandantennummer: document_create turns it into an invoice, dunning letter, payment reminder or credit note, mandant_get returns the full record, letter_create_draft writes a normal letter.
Inputs: query (required), limit, since, offset, +1 more.
mcp_healthVerbindung prüfenARead-onlyInspect
Verbindungs- und Einrichtungsprobe: prüft das Partner-Token und die Verarbeitungskette von Anfang bis Ende und meldet unter setup, welche Voraussetzungen für einen echten Versand erfüllt sind (Absender-Profil, AVV, Guthaben, Sandbox, Freigabe, Marke, Briefpapier, Vorlagen) und welcher Schritt als nächster ansteht. Bei einem neuen Konto listet setup.goldenPath die Einrichtungsschritte in Reihenfolge. Jeder Schritt trägt humanSummary (de, en), einen Satz in Alltagssprache für den Menschen; Tool-Namen, nextTool, fixUrl und messageDe/messageEn sind maschinenlesbar. checkRender: true prüft zusätzlich, ob das Rendern gerade funktioniert (Vorschau, Thumbnail), etwa vor dem Bau einer Vorlage, die danach als Bild geprüft wird. Die Antwort kommt in etwa 3 Sekunden: eine Prüfung über ihrem Zeitbudget steht unter degraded und meldet ihren vorsichtigen Standardwert. EN: Connection and setup probe: verifies the partner token and the processing chain end to end and reports under setup which prerequisites for a real send are met (sender profile, data processing agreement, balance, sandbox, approval, brand, letterhead, templates) and which step comes next. On a new account, setup.goldenPath lists the setup steps in order. Every step carries humanSummary (de, en), one sentence in everyday language for the person; tool names, nextTool, fixUrl and messageDe/messageEn are machine-facing. checkRender: true also checks whether rendering works right now (preview, thumbnail), for example before building a template that is then checked as an image. The answer arrives in about 3 seconds: a check over its time budget is listed under degraded and reports its cautious default.
Inputs: reasoning, checkRender.
order_cancelAuftrag stornierenADestructiveInspect
Storniert einen Brief und schreibt den Betrag dem Wallet des Kontos gut (geschlossener Kreislauf, Gutschrift ins Wallet statt auf die Karte). Mit orderId wird eine bereits erstellte Bestellung im Stornofenster storniert; ist der Brief bereits im Druck, wird sauber abgelehnt. Mit approvalId wird eine per Chat freigegebene Sendung im 10-Minuten-Stornofenster gestoppt, bevor sie überhaupt versendet wird (der Mensch sagt 'stopp'). EN: Cancels a letter and credits the amount to the account's wallet (closed loop, credited to the wallet rather than the card). With orderId it cancels an existing order within the cancellation window; if the letter is already printing the call is cleanly rejected. With approvalId it stops a chat-approved send within its 10-minute grace window before it is even sent (the human says 'stop').
Inputs: reason, orderId, reasoning, approvalId.
order_einlieferungsbelegEinlieferungsbeleg abrufenARead-onlyInspect
Liefert den Einlieferungsbeleg (Einlieferungsnachweis) zu einem versendeten Auftrag, sobald der Brief eingeliefert ist und der Versanddienstleister einen Beleg ausstellt: eine 7 Tage gültige Download-URL für den Beleg (eine PDF, wenn der Versanddienstleister eine ausstellt, sonst ein JSON-Nachweis aus seinen Statusdaten; belegFormat nennt das Format, ein neuer Aufruf liefert einen frischen Link), den Poststempel, den Versanddienstleister sowie den geprüften Nachweis aus dem GoBD-Archiv. Der Beleg zeigt die Einlieferung bei der Post. Sendungsnummer und Zustellstatus eines Einschreibens liefert order_status. EN: Returns the proof of posting (Einlieferungsbeleg) for a sent order, once the letter is handed in and the mail provider issues one: a download URL for the receipt valid for 7 days (a PDF where the mail provider issues one, otherwise a JSON record built from its status data; belegFormat names the format, and a new call returns a fresh link), the postmark, the mail provider and the verified record from the GoBD archive. The receipt shows the hand-in at the post. The tracking number and delivery status of registered mail come from order_status.
Inputs: orderId (required), reasoning.
order_fix_resubmitAdresse korrigieren und erneut sendenADestructiveInspect
Korrigiert die Empfängeradresse eines Briefs im Status awaiting_partner_fix und reicht ihn erneut ein. Das setzt voraus, dass die OAuth-Verbindung approval:self_approve trägt. Andernfalls liefert der Aufruf einen Link, über den der Mensch im angemeldeten Portal entscheidet. Der Preis bleibt unverändert. EN: Corrects the recipient address of a letter in awaiting_partner_fix and resubmits it. This requires that the OAuth connection carries approval:self_approve. Otherwise the call returns a link where the human decides in the signed-in portal. The price stays unchanged.
Inputs: orderId (required), recipient (required), reasoning, clientOrderId.
order_sendBrief versendenADestructiveInspect
Versendet einen Brief per Post: prüft die Pflichtangaben des Absenders, die Empfängeradresse, den AVV und die Limits, erstellt die PDF und berechnet den Preis. Der Brief kommt über letterId (ein Entwurf) oder inline: dann ist der Text content (Fließtext) oder blocks (strukturiert: Tabellen, Überschriften, Summenzeilen), genau eines von beiden. Kompaktes blocks-Beispiel: {"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}]}]} Schema-Referenz: frankki://blocks-guide. dryRun: true ist eine kostenfreie Probe: sie liefert Preis, Seite 1 als Bild und die Liste checks (jede Prüfung mit passed, failed oder skipped), und der Brief bleibt unversandt; ein zweiter Aufruf mit denselben Werten und dryRun: false versendet genau diesen Brief. Ein echter Versand wartet auf Freigabe. Autopilot ist eine Dashboard-Einstellung, die die Person selbst steuert: mit ihm geht ein Standardbrief aus eigener freigegebener Vorlage (templateId plus templateVersionId) an einen Empfänger aus dem Adressbuch nach 10 Minuten raus. saveRecipient: true trägt den Empfänger dabei ein, humanSummary nennt die Uhrzeit, order_status und order_cancel nehmen die approvalId. mcp_health meldet unter setup, welcher Freigabeweg gilt. Für eine Mahnung, Kündigung, Mieterhöhung oder einen anderen Brief mit Frist gibt es das Einschreiben mit Nachweis; seinen Preis liefert shipping_quote. Eine fertige eigene PDF geht unverändert raus: letter_upload_pdf prüft und speichert sie, order_send versendet sie dann mit pdfStorageKey und Empfänger. EN: Sends a letter by post: checks the sender's mandatory details, the recipient address, the AVV and the limits, creates the PDF and calculates the price. The letter arrives via letterId (a draft) or inline: then the body is 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}]}]} Schema reference: frankki://blocks-guide. dryRun: true is a free rehearsal: it returns the price, page 1 as an image and the checks list (each gate with passed, failed or skipped), and the letter stays unsent; a second call with the same values and dryRun: false sends exactly that letter. A real send waits for approval. Autopilot is a dashboard setting the person controls: with it, a standard letter from an own released template (templateId plus templateVersionId) to an address-book recipient leaves after 10 minutes. saveRecipient: true adds the recipient on the way, humanSummary names the time, order_status and order_cancel take the approvalId. mcp_health reports under setup which approval path applies. For a Mahnung, Kündigung, Mieterhöhung or other deadline letter, Einschreiben adds a proof of posting; shipping_quote returns its price. A finished own PDF goes out unchanged: letter_upload_pdf checks and stores it, then order_send sends it with pdfStorageKey and the recipient.
Inputs: color, blocks, design, dryRun, +40 more.
order_send_batchBriefe im Stapel versendenADestructiveInspect
Reicht mehrere Briefe als einen Stapel ein. Jeder Eintrag wird einzeln geprüft und bepreist. Der Stapel landet als eine Freigabe für alle Empfänger in der Warteschlange. Mit Autopilot geht ein Stapel, dessen Briefe alle die Autopilot-Regeln erfüllen, nach 10 Minuten raus; order_cancel stoppt ihn bis dahin. Unter dem zurückgegebenen approvalUrl prüft der Mensch Empfängerliste, Anzahl und Gesamtkosten im angemeldeten Portal und entscheidet dort. Selbst freigeben kann eine OAuth-Verbindung mit der zusätzlich erteilten Berechtigung approval:self_approve. Bei Ablehnung wird die gesamte Reservierung zurückgebucht. Mit dryRun bleibt es bei einer kostenfreien Probe. EN: Submits several letters as one batch. Each item is checked and priced separately. The batch enters the approval queue as one approval covering every recipient. With autopilot, a batch whose letters all meet the autopilot rules goes out after 10 minutes; order_cancel stops it until then. At the returned approvalUrl the human reviews the recipient list, count and total cost in the signed-in portal and decides there. An OAuth connection with the separately granted approval:self_approve scope can approve on its own. Rejection refunds the entire reservation. With dryRun, it remains a free rehearsal.
Inputs: items (required), dryRun, presetName, stopOnError.
order_statusAuftragsstatus abrufenARead-onlyInspect
Liefert den Stand eines Briefs: Status, deutsche Sendungsverfolgung, Sendungsnummer (bei Einschreiben), voraussichtliche Zustellung und ob er sich noch stornieren lässt. Der Aufruf nimmt genau eine Kennung: orderId, approvalId (aus order_send, solange orderId null ist) oder letterId. Vor dem Versand kommt status queued_autopilot mit dispatchAt, humanSummary (de, en) und cancelWith. Bei awaiting_partner_fix wartet der Brief auf order_fix_resubmit, bei failed nennt failure den Grund und nextStep den Weg zurück. Solange cancellable true ist, stoppt order_cancel den Versand. EN: Returns where a letter stands: status, German tracking history, tracking number (registered mail), estimated delivery and whether it can still be cancelled. The call takes exactly one id: orderId, approvalId (from order_send while orderId is null) or letterId. Before dispatch the status is queued_autopilot with dispatchAt, humanSummary (de, en) and cancelWith. On awaiting_partner_fix the letter waits for order_fix_resubmit; on failed, failure gives the reason and nextStep the way back. While cancellable is true, order_cancel stops the send.
Inputs: orderId, letterId, reasoning, approvalId.
preset_saveVoreinstellung speichernADestructiveInspect
Speichert eine benannte Voreinstellung (Konfigurations-Bundle) im Partnerprofil. Der Name ist pro Partner eindeutig. Limits in der Voreinstellung werden unverändert gespeichert und dienen als Notiz. Durchgesetzt werden ausschließlich die im Web gesetzten Konto- und Sub-Wallet-Limits. EN: Saves a named preset (configuration bundle) in the partner profile. The name is unique per partner. Limits inside the preset are stored as-is and serve as a note. Enforcement runs exclusively on the account and sub-wallet limits set in the web app.
Inputs: name (required), preset (required), reasoning.
pricing_tiersStaffelpreise abrufenARead-onlyInspect
Liefert die Staffelpreise (Mengenrabatte) von FrankKi: ab welcher Monatsmenge welcher Beispielpreis pro Brief gilt. Das beantwortet Fragen nach Mengenrabatt, Volumenpreis, Staffelpreis oder Großkundenpreis. Die Beispielpreise gelten für einen einseitigen Standardbrief in Schwarzweiß innerhalb Deutschlands, der echte Preis pro Brief hängt zusätzlich von Seitenzahl, Farbe, Versandart und Zielland ab (den liefert shipping_quote). EN: Returns FrankKi's volume tiers (bulk discounts): from which monthly quantity which example price per letter applies. It answers questions about bulk discounts, volume pricing or enterprise pricing. The example prices are for a one-page black and white standard letter within Germany; the real per-letter price also depends on page count, color, delivery type and destination country (shipping_quote returns that).
Inputs: reasoning.
profile_getPartnerprofil abrufenBRead-onlyInspect
Liefert das Partnerprofil im Überblick: Standard-Absenderadresse, hinterlegte Signatur und Briefkopf, gespeicherte Presets, eine kurze Wallet-Zusammenfassung und das aktuelle Preismodell des Partners (Standardpreis oder Mengenstaffel, inklusive nächster Staffelstufe). EN: Returns an overview of the partner profile: default sender address, stored signature and letterhead, saved presets, a short wallet summary and the partner's current pricing (standard price or volume tier, including the next tier threshold).
Inputs: reasoning.
schedule_cancelGeplante Sendung abbrechenADestructiveInspect
Bricht eine geplante Sendung ab und gibt die dafür reservierte Summe im Wallet wieder frei. Die scheduleId liefern letter_schedule und schedule_list. EN: Cancels a scheduled send and releases the amount reserved for it in the wallet. letter_schedule and schedule_list return the scheduleId.
Inputs: scheduleId (required), dryRun, reasoning.
schedule_listGeplante Sendungen auflistenARead-onlyInspect
Listet die geplanten Sendungen des Partners mit Termin, Status und reservierter Summe. EN: Lists the partner's scheduled sends with date, status and reserved amount.
Inputs: statusFilter.
sender_profile_getAbsenderprofil abrufenARead-onlyInspect
Liefert ein einzelnes Absenderprofil mit allen Pflichtangaben, Bankverbindung und Disclaimer. profileId ist optional und steht sonst für das Standardprofil. EN: Returns a single sender profile with all mandatory details, bank account and disclaimer. profileId is optional and defaults to the default profile.
Inputs: profileId, reasoning.
sender_profile_listAbsenderprofile auflistenBRead-onlyInspect
Listet alle Absenderprofile des Partners mit ihrer Rechtsform und ob die Pflichtangaben vollständig sind. EN: Lists all of the partner's sender profiles with their legal form and whether the mandatory details are complete.
Inputs: reasoning.
sender_profile_upsertAbsenderprofil anlegen oder bearbeitenADestructiveInspect
Legt ein Absenderprofil an oder bearbeitet es: Rechtsform, Pflichtangaben, optional Bankverbindung, Haftungsausschluss und Standard-Briefpapier. Ein unvollständiges Profil wird gespeichert und meldet die fehlenden Felder zurück, sodass es sich schrittweise ergänzen lässt. Versenden ist mit vollständigen Pflichtangaben möglich. EN: Creates or edits a sender profile: legal form, mandatory details, optionally bank details, disclaimer and default letterhead. An incomplete profile is saved and reports its missing fields back, so it can be completed step by step. Sending works once they are complete.
Inputs: id, isDefault, reasoning, disclaimer, +5 more.
sender_profile_validateAbsenderprofil prüfenARead-onlyInspect
Prüft, ob ein Absenderprofil (per profileId) oder ein vorgeschlagener Feldsatz alle Pflichtangaben für seine Rechtsform enthält. Der Aufruf nimmt genau eine Form: profileId ODER rechtsform + proposedFields. proposedFields ist ein Objekt; ein JSON-kodierter Objekt-String wird ebenfalls akzeptiert. Liefert valid, missingFields und weiche Hinweise. Meldet eine Lücke als Ergebnis und läuft dabei durch. EN: Checks whether a sender profile (by profileId) or a proposed field set contains all mandatory details for its legal form. The call takes exactly one form: profileId OR rechtsform + proposedFields. proposedFields is an object; a JSON-encoded object string is also accepted. Returns valid, missingFields and soft hints. Reports a gap as a result and keeps running.
setup_fix_linkAuf der Website erledigenBInspect
Gibt einen Punkt an den Menschen im Browser weiter: Guthaben aufladen, den Auftragsverarbeitungsvertrag (AVV) unterschreiben oder das Absender-Profil vervollständigen. Liefert die passende Seite und eine Karte, die den Briefentwurf sichtbar stehen lässt und selbst merkt, wenn der Mensch zurück ist. Bezahlt wird im Browser. EN: Hands one item over to the human in a browser: top up the balance, sign the data processing agreement or complete the sender profile. Returns the matching page plus a card that visibly keeps the letter draft and notices by itself when the human is back. Payment happens in the browser.
Inputs: gap (required), reasoning.
setup_status_appEinrichtungsstand für die Karte lesenARead-onlyInspect
App-only, für die FrankKi-Übergabe-Karte im Chat: die Karte pollt hier den aktuellen Einrichtungsstand und merkt so selbst, wenn der Mensch aus dem Browser zurück ist. Für Agenten liefert mcp_health denselben Stand unter setup. EN: App-only, for the FrankKi handover card in the chat: the card polls the current setup state here and so notices by itself when the human is back from the browser. Agents get the same state from mcp_health under setup.
Inputs: no named parameters.
shipping_quoteVersandpreis ermittelnARead-onlyInspect
Ermittelt Preis, Briefformat, Versandart und voraussichtliche Laufzeit für einen geplanten Brief, bevor er versendet wird. Die Schätzung braucht nur Seitenzahl, Land und Versandart. Steht der Brief schon fest, versendet ihn order_send, und order_send mit dryRun:true liefert den genaueren Preis für genau diesen Brief. Der Preis gilt pro Brief und enthält bereits die Mengenstaffel des Partners, falls eine greift (Feld tierId); die Staffelpreise selbst liefert pricing_tiers. Ob es Einschreiben gibt, richtet sich nach dem aktuellen Katalog des Ziellands. einschreiben_einwurf und einschreiben_uebergabe sind deutsche Produkte; die Schweiz hat ch_einschreiben. Für andere Ziele listet ein Standard-shipping_quote für das Land die verfügbaren Versandarten in availableDeliveryTypes, und ein Quote für den gewählten Code liefert dessen Preis. Eine abgelehnte Kombination aus Land und Versandart gilt für genau dieses Paar, ein Katalogstand für genau diesen Stand. Sendungsverfolgung und Einschreiben sind verschiedene Produkte. EN: Determines price, letter format, shipping method and estimated delivery time for a planned letter, before it is sent. The estimate needs only page count, country and delivery type. Once the letter exists, order_send sends it, and order_send with dryRun:true gives the more precise price for that specific letter. The price is per letter and already includes the partner's volume tier where one applies (field tierId); pricing_tiers returns the volume tiers themselves. Registered-mail availability follows the destination's current catalog. The codes einschreiben_einwurf and einschreiben_uebergabe are German products; Switzerland uses ch_einschreiben. For other destinations, a standard shipping_quote for that country lists the available methods in availableDeliveryTypes, and a quote for the chosen code returns its price. A rejected country/method pair gives a verdict for that pair alone. A catalog snapshot gives a verdict for that snapshot alone. Tracked mail and registered mail are distinct products.
Inputs: pageCount (required), deliveryType (required), color, country, +3 more.
signature_listUnterschriften auflistenARead-onlyInspect
Listet die im Partnerprofil gespeicherten Unterschriften mit einer kurzlebigen Vorschau-URL (24 Stunden gültig). EN: Lists the signatures stored in the partner profile with a short-lived preview URL (valid for 24 hours).
Inputs: reasoning.
signature_uploadUnterschrift hochladenBInspect
Lädt eine Unterschrift als PNG hoch und speichert sie im Partnerprofil. Die Unterschrift wird beim Versand unterhalb des Brieftexts eingefügt. Nur PNG wird unterstützt. EN: Uploads a signature as PNG and stores it in the partner profile. On sending, the signature is inserted below the letter body. Only PNG is supported.
Inputs: pngBase64 (required), widthMm, reasoning, displayName.
template_apply_with_merge_fieldsVorlage mit Werten füllenARead-onlyInspect
Füllt die Platzhalter einer gespeicherten Vorlage mit Werten und gibt Betreff und Inhalt oder ein vollständiges Anschreiben-Formular-Paket zurück. Bei einer Blockvorlage kommen statt content die fertigen blocks zurück. Briefkopf und Marke werden getrennt bei Vorschau oder Versand gewählt. Eine eigenständige Formularvorlage mit sendable:false und releaseBlocker:null braucht coverTemplateId aus einer direkt adressierbaren Briefvorlage; eine gespeicherte Verknüpfung bleibt nur der optionale Standard. order_send versendet das Ergebnis mit templateId, templateVersionId, coverTemplateId, coverTemplateVersionId und den ursprünglichen templateMergeValues und rendert damit genau diese Version neu. order_send erwartet die Paketabschnitte in der Form, in der sie hier zurückkommen. Fehlt eine Pflichtangabe, antwortet das Tool mit MERGE_FIELDS_MISSING und nennt die fehlenden oder ungültigen Felder. EN: Fills a saved template and returns subject and content or a complete cover-form package. For a block template the finished blocks are returned instead of content. Letterhead and brand are selected separately at preview or send time. A standalone form template with sendable:false and releaseBlocker:null needs coverTemplateId from a directly addressable letter template; a saved link is only the optional default. order_send sends the result with templateId, templateVersionId, coverTemplateId, coverTemplateVersionId and the original templateMergeValues and re-renders exactly that version from them. order_send expects the package sections in the form in which they come back here. If a required value is missing, the tool returns MERGE_FIELDS_MISSING and lists the missing or invalid fields.
Inputs: templateId (required), language, reasoning, mergeValues, +4 more.
template_archiveVorlage archivierenBDestructiveInspect
Archiviert eine Vorlage. Sie verschwindet aus den Listen und aus dem Versand, bleibt aber erhalten. Der Inhalt bleibt vollständig erhalten, und ein erneuter Aufruf ist unschädlich. EN: Archives a template. It disappears from the lists and from sending but is kept. The content stays fully preserved and calling it again is harmless.
Inputs: templateId (required), reasoning.
template_clone_from_libraryStandardvorlagen übernehmenADestructiveInspect
template_clone_from_library kopiert ein bis fünf FrankKi-Standardvorlagen in einem Aufruf in die eigenen Vorlagen des Kontos, etwa Rechnung, Mahnung, Angebot, Kündigung oder Behördenpost, und zeigt die erste als Bild. Mit release true gibt es sie frei, wenn das Konto genau einen aktiven Nutzer hat. Danach sendet order_send mit templateId und templateVersionId. EN: template_clone_from_library copies one to five FrankKi standard templates into the account's own templates in one call, such as invoice, dunning letter, quote, cancellation or letters to authorities, and shows the first as an image. With release true it releases them on a single-user account. Then order_send sends with templateId and templateVersionId.
Inputs: items (required), release, reasoning, previewFirst.
template_decide_appVorlagenfreigabe auf der Karte entscheidenADestructiveInspect
Nur für die interaktive Vorlagen-Karte: gibt die angezeigte Entwurfsversion frei oder verwirft sie, nachdem der Mensch auf der Karte gedrückt hat. Freigeben macht die Vorlage für Versand und Agenten sichtbar. EN: For the interactive template card only: releases or discards the displayed draft version after the human pressed the button on the card. Releasing makes the template visible to sending and to agents.
Inputs: decision (required), versionId (required), templateId (required).
template_diff_checkAbweichung zur Vorlage prüfenARead-onlyInspect
Vergleicht einen fertigen Brief mit seiner Vorlage und zeigt, wo er abweicht. Eine Blockvorlage vergleicht finalBlocks an Stelle von finalContent, Text für Text in Lesereihenfolge. Kostenlos und rein lesend. EN: Compares a finished letter with its template and shows where it deviates. A block template compares finalBlocks in place of finalContent, text by text in reading order. Free and read-only.
Inputs: templateId (required), finalSubject (required), reasoning, versionId, +3 more.
template_draft_discardVorlagenentwurf verwerfenADestructiveInspect
Verwirft eine Entwurfsversion, solange sie noch auf ihre Freigabe wartet. Freigegebene und ersetzte Versionen bleiben unantastbar und vollständig erhalten. Ein erneuter Aufruf ist unschädlich. EN: Discards a draft version while it is still waiting for its release. Released and superseded versions stay untouchable and fully preserved. Calling it again is harmless.
Inputs: versionId (required), reasoning, templateId.
template_getVorlage abrufenARead-onlyInspect
Liefert eine einzelne Vorlage mit Betreff- und Inhaltsvorlage, den Merge-Feldern und der empfohlenen Freigabe-Voreinstellung. Eine Blockvorlage liefert zusätzlich blocksTemplate und styleDefs; kopiert und angepasst speichert template_save sie als eigenen Entwurf. Die Gestaltungskette beginnt hier: template_get auf einer kuratierten Standardvorlage (template_list markiert sie mit curated: true), Änderungen an blocksTemplate, letter_preview rendert den Stand, template_save speichert ihn, template_preview zeigt die gespeicherte Version, template_release gibt sie frei. Mit versionId und dem Scope template:write lässt sich auch eine bestimmte Entwurfsversion lesen. Nächster Schritt: template_apply_with_merge_fields füllt die Platzhalter mit Werten. EN: Returns a single template with subject and content template, the merge fields and the recommended approval default. A block template also returns blocksTemplate and styleDefs; once copied and modified, template_save stores it as an own draft. The crafting chain starts here: template_get on a curated standard template (template_list marks them with curated: true), edits to blocksTemplate, letter_preview renders the state, template_save stores it, template_preview shows the stored version, template_release releases it. With versionId and the template:write scope a specific draft version can be read too. Next step: template_apply_with_merge_fields fills the placeholders with values.
Inputs: templateId (required), reasoning, versionId.
template_listVorlagen auflistenARead-onlyInspect
Listet die Brief-Vorlagen (Vorlagenliste, template list) für Anlässe wie Kündigung, Rechnung, Mahnung, Angebot, Vertrag und Behördenpost, mit Kategorie, Version und Platzhaltern (Merge-Feldern). Der technische Tool-Name ist template_list. Standardmäßig kommen die freigegebenen Vorlagen; statusFilter mit dem Scope template:write liefert auch offene Entwürfe. Jeder Eintrag sagt mit curated: true, ob es eine kuratierte FrankKi-Standardvorlage ist (die Bibliothek zum Kopieren), und mit hasBlocks: true, ob sie ein strukturiertes Layout mit Tabellen und Summen trägt statt Fließtext. Nächster Schritt: template_get liefert eine Vorlage vollständig (bei einer Blockvorlage inklusive blocksTemplate und styleDefs zum Kopieren und Anpassen), template_apply_with_merge_fields füllt sie mit Werten. EN: Lists the letter templates (template list) for occasions such as cancellation, invoice, payment reminder, quote, contract and letters to public authorities, with category, version and placeholders (merge fields). The technical tool name is template_list. By default it returns the released templates; statusFilter with the template:write scope also returns open drafts. Every entry says with curated: true whether it is a curated FrankKi standard template (the library to copy from), and with hasBlocks: true whether it carries a structured layout with tables and totals instead of plain text. Next step: template_get returns one template in full (for a block template including blocksTemplate and styleDefs to copy and modify), template_apply_with_merge_fields fills it with values.
Inputs: limit, query, offset, source, +3 more.
template_page_urls_appBildlinks der Vorlagen-Karte erneuernBRead-onlyInspect
Nur für die interaktive Vorlagen-Karte: erneuert die zeitlich begrenzten Bildlinks der Vorlagenseiten, wenn die alten abgelaufen sind. EN: For the interactive template card only: renews the time-limited image links of the template pages once the old ones have expired.
Inputs: templateId (required), versionId.
template_previewGespeicherte Vorlage ansehenARead-onlyInspect
Rendert eine GESPEICHERTE Vorlage mit Beispielwerten und liefert Inline-PNGs, PDF-Link und designRender. designId oder ein ungespeichertes design bestimmen das Briefpapier; eigenständige Formulare rendern mit documentMode: "form". Die Vorschau ist kostenfrei und rein zum Ansehen. Ein blocks-Layout, das erst entsteht, rendert letter_preview; eine fertige Version speichert template_save (technischer Tool-Name template_save). EN: Renders a STORED template with sample values and returns inline PNGs, PDF link and designRender. designId or an unsaved design selects the stationery; standalone forms render with documentMode: "form". The preview is free of charge and purely for looking at. letter_preview renders a blocks layout still in the making; template_save stores a finished version (technical tool name template_save).
Inputs: templateId (required), pages, design, designId, +3 more.
template_releaseVorlage freigebenADestructiveInspect
Gibt eine Entwurfsversion frei, sodass sie versendet werden kann; letzter Schritt der Gestaltungskette (template_get, anpassen, letter_preview, template_save, template_preview, template_release). template_preview zeigt dem Menschen eine Freigabekarte mit Freigeben-Knopf. template_release macht die Version sofort versandbereit, an dieser Karte vorbei, die die Person sonst selbst bestätigt; die Antwort vermerkt die Freigabe als Freigabe durch den Agenten. Über MCP geht das bei einem Konto mit genau einem aktiven Nutzer. Bei mehreren Nutzern gibt ein Mensch im Dashboard frei (Vier-Augen-Prinzip), und die Antwort enthält den Link dorthin. Danach füllt template_apply_with_merge_fields die Vorlage mit Werten, und letter_create_draft oder order_send verschickt das Ergebnis. EN: Releases a draft version so it can be sent; last step of the crafting chain (template_get, modify, letter_preview, template_save, template_preview, template_release). template_preview shows the human an approval card with a Release button. template_release makes the version sendable at once, bypassing that card, which the person otherwise confirms; the response records the release as released by the agent. Via MCP this works on an account with exactly one active user. With several users a human releases it in the dashboard (four-eyes principle), and the response contains the link. After that, template_apply_with_merge_fields fills the template with values, and letter_create_draft or order_send sends the result.
Inputs: versionId (required), templateId (required), reasoning.
template_saveVorlage speichernAInspect
Speichert eine Vorlage als ENTWURF (Vorlage speichern, Vorlagenversion speichern, Vorlagenentwurf anlegen). documentKind ist letter oder form. Briefkopf und Marke sind eine externe Schicht, die erst bei Vorschau oder Versand aufgelöst wird, und bleiben außerhalb der Vorlage. designId bleibt nur als veralteter Hinweis zur Ableitung der Dokumentart kompatibel; explizites documentKind gewinnt. Ein Formular lässt sich eigenständig speichern. coverTemplateId kann eine Anschreibenversion für ein Paket pinnen. Fehlt templateId, entsteht eine neue Vorlage; mit templateId eine neue Entwurfsversion. Der Entwurf wird mit der Freigabe nutzbar; die Antwort enthält den Prüflink. Der technische Tool-Name ist template_save. Der Vorlageninhalt ist entweder contentTemplate (Fließtext) ODER blocksTemplate (strukturiert: Tabellen, Überschriften, Summenzeilen), genau eines von beiden. Merge-Felder sind typisiert (text, date, number, currency, rows); ein Tabellenblock bindet eine rows-Liste über rowsFrom. Der schnellste Start ist eine Standardvorlage aus template_get, kopiert und angepasst. letter_preview rendert den Stand vor dem Speichern, Seite für Seite neben dem Original; ein Nachbau ist fertig, wenn Seitenzahl und wesentliche Geometrie zum Original passen. Eigenständige Formulare rendern in letter_preview mit einem design im documentMode "form". EN: Saves a template as a DRAFT (save template, save template version, create template draft). documentKind is letter or form. Letterhead and brand are an external layer resolved at preview or send time and stay outside the template. designId remains only as a deprecated hint for inferring document kind; explicit documentKind wins. A form can be saved on its own. coverTemplateId may pin a cover-template version for a package. When templateId is absent, a new template is created; with templateId, a new draft version. The draft becomes usable on release; the response includes the review link. The technical tool name is template_save. The template body is either contentTemplate (plain text) OR blocksTemplate (structured: tables, headings, totals lines), exactly one of the two. Merge fields are typed (text, date, number, currency, rows); a table block binds a rows list via rowsFrom. The fastest start is a standard template from template_get, copied and modified. letter_preview renders the state before saving, page by page next to the original; a rebuild is done when page count and major geometry match the original. Standalone forms render in letter_preview with a design in documentMode "form".
Inputs: name (required), subjectTemplate (required), designId, kategorie, +11 more.
template_status_appVorlagenstand für die Karte lesenBRead-onlyInspect
Nur für die interaktive Vorlagen-Karte: liest den aktuellen Zustand einer Vorlagenversion, damit eine alte Karte den richtigen Endzustand zeigt. EN: For the interactive template card only: reads the current state of a template version so an old card renders the correct end state.
Inputs: templateId (required), versionId.
wallet_balanceWallet-Guthaben abrufenARead-onlyInspect
Liefert den aktuellen Wallet-Stand: Guthaben, den für wartende Briefe reservierten Betrag, das verfügbare Guthaben, Tageslimit für Briefe und Kosten, den nächsten Reset-Zeitpunkt sowie das aktuelle Preismodell (Standardpreis oder Mengenstaffel). Bleibt das verfügbare Guthaben unter den geplanten Versandkosten, liefert wallet_topup_link den Link zum Aufladen. EN: Returns the current wallet status: balance, the amount reserved for waiting letters, the available balance, daily cap for letters and costs, and the next reset time. If the available balance is short of the planned send, wallet_topup_link returns the top-up link.
Inputs: reasoning.
wallet_topup_linkWallet aufladenAInspect
Erstellt einen Stripe-Checkout-Link zum Aufladen des Wallet-Guthabens. Die Kartendaten bleiben bei Stripe; das Guthaben wird nach Abschluss der Zahlung gutgeschrieben. EN: Creates a Stripe checkout link to top up the wallet balance. Card data stays with Stripe; the balance is credited once the payment completes.
Inputs: amountEuros (required), reasoning, requestNonce.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Related MCP Connectors
Let AI agents prepare, review, pay for, and send real letters and postcards.
Your AI writes letters. We send them as real post to 31 countries, with status and e-mail updates.
Mail real US letters, postcards and certified mail from an agent, quoted before sending.
Send real paper letters from AI chat: print, envelope, postage, delivery. Pay per letter.
Related MCP Servers
- FlicenseNot gradedqualityCmaintenanceEnables AI assistants to prepare, price, review, pay for, and send real physical letters and postcards via a hosted MCP server.-
- FlicenseNot gradedqualityCmaintenanceAgentBureau provides the legal and physical infrastructure for AI agents to operate within the German jurisdiction. We bridge the gap between digital intelligence and real-world action by providing "Embodiment-as-a-Service." Through our API, agents can perform legally binding actions—like sending faxes, mailing physical letters, issuing invoices, forming entire companies (GmbH/UG), ...1-
- AlicenseAqualityDmaintenanceEnables AI agents to send physical letters and postcards to over 200 countries using Solana cryptocurrency for payment. It provides tools for generating mail quotes, managing wallet balances, and automating physical correspondence directly through the Model Context Protocol.489 npm1MIT
- AlicenseNot gradedqualityBmaintenanceEnables agents to create and pay for physical postcards and letters, returning print previews and Stripe checkout links, with human review before USPS First-Class mailing to US addresses.MIT
Glama MCP Gateway
Add one secure layer between your agents and this server.