# Versendo > Versendo verschickt echte Papierbriefe per Deutscher Post innerhalb Deutschlands. Du schickst Daten (Absender, Empfänger, Betreff, Text). Versendo erzeugt daraus ein DIN-5008-PDF, prüft Formvorschriften und übergibt den Brief zum Druck und Versand. ## Zwei Wege - MCP-Server (für Claude, Codex, Cursor, Antigravity u. a.): https://versendo.de/api/mcp mit den Werkzeugen brief_preise, brief_vorbereiten, brief_status. Der Nutzer gibt jeden Brief über einen Link frei und bezahlt dort. Mit Guthaben-Konto (https://versendo.de/guthaben, Schlüssel als "Authorization: Bearer vs_live_…" oder als ?konto= in der Adresse) kommen brief_senden, guthaben und guthaben_aufladen dazu: Dann wird direkt im Chat verschickt und vom Guthaben bezahlt, aber erst nach dem ausdrücklichen Ja des Nutzers für genau diesen Brief. - REST-API (für Automationen): POST https://versendo.de/v1/briefe mit Header "Authorization: Bearer vs_test_…" (Test-Schlüssel verschicken nie echte Briefe) oder "Bearer vs_live_…" (Guthaben-Konto: Brief wird vom Guthaben bezahlt und verschickt; 402, wenn das Guthaben nicht reicht). ## REST-API in Kürze - Test-Schlüssel erzeugen: POST https://versendo.de/api/schluessel (Antwort enthält "schluessel"; nur einmal sichtbar) - Brief erstellen: POST https://versendo.de/v1/briefe, JSON-Body: {"absender":{"name","strasse","plz","ort"},"empfaenger":{"name","zusatz?","strasse","plz","ort"},"betreff","text","briefart","einschreiben":"nein"|"einwurf","referenzen?":[{"bezeichnung","wert"}],"grussformel?","unterzeichner?"} - text: mit Anrede, ohne Grußformel; Absätze durch Leerzeile trennen - briefart: kuendigung_arbeitsverhaeltnis | kuendigung_mietverhaeltnis | aufhebungsvertrag | kuendigung_vertrag | vereinsaustritt | widerspruch_behoerde | widerspruch_sonstiges | mahnung_oder_zahlungserinnerung | reklamation | sonstiges - plz: 5 Ziffern (nur Deutschland) - Header "Idempotency-Key: " verhindert doppelte Briefe bei Wiederholungen (gleicher Key = gleicher Brief, Antwort 200 statt 201). - Status: GET https://versendo.de/v1/briefe/{id} - Preise: GET https://versendo.de/v1/preise ## Antworten - 201 erstellt, 200 Wiederholung (Idempotency-Key), 400 Eingabe ungültig (Liste in fehler.felder), 401/403 Schlüssel, 404 nicht gefunden, 422 schriftform_erforderlich (Brief braucht eigenhändige Unterschrift und wird nicht verschickt), 429 Tageslimit - Fehlerformat: {"fehler":{"code","meldung",...}} ## Preise Standardbrief 2,49 €, Einwurf-Einschreiben 4,99 € (bis 3 Seiten), ab 4 Seiten +0,60 €, max. 8 Seiten. ## Grenzen - Keine Briefe, die gesetzlich eine eigenhändige Unterschrift brauchen (z. B. Kündigung von Arbeits- oder Wohnraummietverhältnis). - Nur Empfänger in Deutschland. - Briefinhalte werden nur verschlüsselt gespeichert (AES-256-GCM, Schlüssel getrennt von der Datenbank) und 30 Tage nach Versand gelöscht. Kein Mensch liest die Briefe. ## Mehr - Doku: https://versendo.de/entwickler - OpenAPI: https://versendo.de/openapi.json