FrankKi MCP Server

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.

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.

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).

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.