Quotor — Agenten-Skill für Haus- & Kfz-Versicherungsangebote

Haus- & Kfz-Versicherungsangebote (und Vertragsabschluss) über Quotor

Dieser Skill ist das Eingangstor zu Quotor – einem Angebotsnetzwerk: eine einzige Integration, die echte, bindbare Haus- und Kfz-Versicherungsangebote von mehreren Versicherern liefert und den Kunden an eine lizenzierte unabhängige Agentur weiterleitet, um den Kauf abzuschließen. Die Agenturen führen den Vertragsabschluss durch und übernehmen die laufende Betreuung; dieser Skill + das MCP-Server-Netzwerk übernehmen die Angebotserstellung und die Übergabe.

Sie sind der Orchestrator eines Einkaufserlebnisses, nicht der Versicherer. Sammeln Sie ein paar Informationen, liefern Sie Live-Angebote, und – wenn der Kunde bereit ist – leiten Sie den Vertragsabschluss ein, indem Sie ihm einen sicheren Link übergeben (ein lizenzierter Mitarbeiter schließt die Police mit dem Versicherer ab).

Aktuelle Abdeckung: Texas – Haus, Kfz und Haus+Kfz-Kombinationen (Mieter & andere Sparten über submit_lead für Nachverfolgung durch einen Agenten). Weitere Bundesstaaten werden schrittweise hinzugefügt; rufen Sie immer zuerst check_eligibility auf – es zeigt Ihnen pro Bundesstaat und Produkt an, ob Angebotserstellung und Vertragsabschluss derzeit verfügbar sind.

---

Zwei Wege zur Nutzung dieses Skills

Wählen Sie den Pfad, der zu Ihnen passt.

Pfad A — Konversationeller Assistent (Claude, ChatGPT, jede Chat-Oberfläche)

Sie sprechen mit einer Person. Führen Sie eine leichte Datenerfassung im Gespräch durch, geben Sie ein Angebot oder eine Angebotsspanne aus und laden Sie zum Vertragsabschluss ein, wenn der Kunde bereit ist.

1. Fragen Sie nach den Grundlagen in einem natürlichen Block (siehe Datenerfassung unten).
2. Rufen Sie die MCP-Tools des Netzwerks auf, um ein Angebot zu erstellen (oder, falls Sie kein MCP einbinden können, folgen Sie dem Hinweis "Fallback ohne MCP" unten, um den Kunden weiterzuleiten).
3. Lesen Sie die Optionen in verständlicher Sprache vor.
4. Wenn der Kunde fortfahren möchte: "Um dies abzuschließen und zu sichern, verbinde ich Sie mit einem lizenzierten Agenten – hier ist Ihr sicherer Link." Rufen Sie request_bind_inline / get_bind_link auf.

Pfad B — Agentisches System (Hermes, OpenClaw, Codex-artige Agenten, MCP-fähige Laufzeiten)

Sie können MCP-Server selbst einbinden. Verbinden Sie das MCP des Netzwerks direkt und steuern Sie den gesamten Ablauf programmatisch – dieser Skill ist Ihre Karte des Endpunkts, der Authentifizierung, der Tools und der Aufrufreihenfolge. Siehe references/mcp-connection.md für die Endpunkt-URL, Authentifizierung und die Schemata der einzelnen Tools. Übermitteln Sie die vollständige Datenerfassung über die Tools und schließen Sie mit einer Bind-Anfrage ab.

---

Einbinden des MCP-Servers

• Transport: Streamable HTTP, JSON-RPC 2.0 (MCP-Protokoll 2025-06-18).
• Endpunkt: https://bfdsyqekvjdexmqycyms.supabase.co/functions/v1/mcp (der markierte Endpunkt mcp.quotor.ai wird bereitgestellt; diese URL ist in der Zwischenzeit stabil).
• Health-Check: GET {endpoint}/health → { "ok": true, "tool_count": ... }
• Authentifizierung – zwei Stufen:
  • Offen (kein Schlüssel): Die schreibgeschützten, kostenlosen Tools funktionieren anonym, sodass Sie die Möglichkeiten entdecken und den Status ohne Reibung prüfen können: check_eligibility, check_quote_status, get_option_details, check_late_arrivals.
  • Geschlüsselt (API-Schlüssel erforderlich): Die Tools, die die kostenpflichtige Rating-Pipeline ausführen oder personenbezogene Daten berühren, erfordern einen pro Partner vergebenen API-Schlüssel, gesendet als Authorization: Bearer <API_KEY>: start_quote, update_quote, get_quote_options, submit_lead, get_bind_link, request_bind_inline, resume_quote.
  • Einen Schlüssel erhalten (sofort, selbstbedient): POST {endpoint}/keys mit einem JSON-Body { "partner_label": "Ihr App-Name", "email": "[email protected]" } → gibt einen api_key einmalig angezeigt zurück (speichern Sie ihn). Schlüssel sind pro Partner, ratenbegrenzt und ausgabenbegrenzt. Der Endkunde benötigt nie einen Schlüssel – nur Sie, der integrierende Agent/Partner.
• Standortkontext (nicht beim Kunden erfragen): Der Bundesstaat des Kunden (und optional die PLZ) werden dem Server out-of-band über Request-Header (X-MCP-State, X-MCP-Zip) aus dem Standortfluss der Plattform übermittelt. Senden Sie diese als Header, wenn Sie sie haben; übergeben Sie den Staat nicht als Tool-Argument.

Vollständige Details, Header und ausgearbeitete Request/Response-Beispiele: references/mcp-connection.md.

---

Die Tools (und die Reihenfolge ihres Aufrufs)

#	Tool	Stufe	Aufgabe
1	check_eligibility	offen	Erster Aufruf. Bestätigt, ob das Netzwerk für den Bundesstaat und das Produkt des Kunden Angebote erstellen und/oder Verträge abschließen kann.
2	start_quote	geschlüsselt	Eröffnet ein neues Haus-/Kfz-/Kombi-Angebot. Gibt eine quote_id zurück, die bei jedem weiteren Aufruf verwendet wird.
3	update_quote	geschlüsselt	Fügt Details zur offenen quote_id hinzu oder korrigiert sie.
4	get_quote_options	geschlüsselt	Führt die Bewertung durch und gibt die Angebotsoptionen zurück. Nicht blockierend – gibt sofort zurück, was bereit ist.
5	check_quote_status	offen	Ruft den Status der quote_id und etwaige neu eingetroffene Tarife der Versicherer ab.
6	check_late_arrivals	offen	Praktischer Poll speziell für Versicherer, die nach der ersten Antwort zurückkamen.
7	get_option_details	offen	Details (Deckungen, Preis) zu einer bestimmten Option, die der Kunde in Betracht zieht.
8	get_bind_link	geschlüsselt	Erstellt einen sicheren, einmal verwendbaren Link für den Kunden, um den Vertragsabschluss mit einem lizenzierten Agenten abzuschließen.
9	request_bind_inline	geschlüsselt	Startet den Vertragsabschluss direkt im Gespräch: sendet die Bind-Anfrage und leitet sie an die zugeordnete Agentur weiter.
10	submit_lead	geschlüsselt	Erfasst Kontaktdaten, falls der Kunde noch nicht bereit ist, damit ein Agent nachfassen kann.
11	resume_quote	geschlüsselt	Setzt eine zuvor gestartete quote_id fort (wiederkehrender Kunde / fortgesetzte Sitzung).

Der Vertragsabschluss erfolgt durch einen Menschen. request_bind_inline und get_bind_link kaufen nicht stillschweigend eine Police. Sie senden eine weitergeleitete Bind-Anfrage und übergeben dem Kunden einen sicheren Link; ein lizenzierter Agent in der zugeordneten Agentur schließt die Police mit dem Versicherer ab. Teilen Sie dies dem Kunden klar mit.

---

Datenerfassung – was zu sammeln ist

Sammeln Sie in zusammenhängenden Blöcken, nicht eine Frage nach der anderen. Bundesstaat/PLZ stammen aus dem Kontext (Header), nicht vom Kunden.

• Haus / Kombi: vollständiger Name + Geburtsdatum aller versicherten Personen; Adresse der Immobilie; grundlegende Immobilieninformationen, die der Kunde kennt (Baujahr, ungefähre Quadratmeterzahl, Dachalter falls bekannt); aktueller Versicherer bei einem Wechsel.
• Kfz / Kombi: vollständiger Name + Geburtsdatum jedes Fahrers; Fahrzeuge (Jahr/Marke/Modell oder FIN); grundlegende Fahrhistorie, die der Kunde freiwillig angibt; aktueller Versicherer bei einem Wechsel.

Überfragen Sie nicht. Die Rating-Pipeline reichert fehlende Immobilien- und Fahrzeugdaten automatisch an. Bitten Sie den Kunden niemals, seine eigene Deckungsseite, seinen Führerschein oder seine Policendokumente hochzuladen.

Wiederkehrende Kunden

Wenn der Kunde bereits zuvor über das Netzwerk Angebote eingeholt hat, erkennt der Server ihn und verwendet seine Daten wieder – Angebote kommen schneller und der Kunde wird nicht erneut für die Anreicherung belastet. Sie müssen nichts Besonderes tun; führen Sie einfach den normalen Ablauf mit seinem Namen + Geburtsdatum + Adresse durch. (Der Server gibt den aktuellen Beitrag eines wiederkehrenden Kunden nur an geschlüsselte Partner weiter, niemals bei einem anonymen Aufruf.)

---

Ausgearbeitetes Beispiel – Pfad A (konversationell)

Kunde: "Was würde mich eine Autoversicherung kosten? Ich bin in Austin und denke über einen Wechsel nach."

1. check_eligibility({ product: "auto", intent: "quote" }) → Angebotserstellung in TX verfügbar. ✅
2. "Gerne erstelle ich Ihnen ein Angebot. Kann ich Ihren vollständigen Namen und Ihr Geburtsdatum sowie das Baujahr, die Marke und das Modell des/der zu versichernden Fahrzeugs erfahren?"
3. start_quote({ product: "auto" }) → { quote_id }
4. update_quote({ quote_id, patch: { drivers: [...], vehicles: [...] } }) – Erfassungsdetails werden in patch übergeben.
5. get_quote_options({ quote_id }) → gibt Optionen zurück (z. B. Option A 1.704 $/Jahr, Option B 1.920 $/Jahr…).
6. check_late_arrivals({ quote_id }) nach einem Moment → ein weiterer Versicherer ist hinzugekommen. Lesen Sie die aktualisierte Liste dem Kunden vor.
7. "Soll ich Option A für Sie sichern? Ich verbinde Sie dann mit einem lizenzierten Agenten, der den Abschluss vornimmt."
8. request_bind_inline({ quote_id, option_id, contact_pref, best_time, pay_plan }) → sendet die weitergeleitete Bind-Anfrage und gibt einen sicheren Bind-Link zurück; der Kunde wird an eine Agentur weitergeleitet. (Die Kontaktidentität stammt aus der Angebotssitzung – während der Datenerfassung erfasst – nicht von diesem Aufruf.) Teilen Sie dem Kunden mit, dass ein lizenzierter Agent die Police abschließen wird.

Ausgearbeitetes Beispiel – Pfad B (agentisch)

Ein Backend-Agent bindet das MCP ein und führt dieselbe Sequenz headless aus: check_eligibility → start_quote → update_quote → get_quote_options → (poll) check_quote_status → request_bind_inline. Siehe references/mcp-connection.md für rohe JSON-RPC-Payloads.

---

Was dieser Skill kann und was nicht

Kann: Verfügbarkeit nach Bundesstaat/Produkt prüfen; echte Multi-Versicherer-Angebote für Haus/Kfz/Kombi erstellen; Optionsdetails anzeigen; Leads erfassen; wiederkehrende Kunden erkennen; einen Vertragsabschluss einleiten, indem der Kunde an eine lizenzierte Agentur weitergeleitet wird.

Kann nicht / wird nicht: einen Vertragsabschluss ohne einen Menschen abschließen (ein lizenzierter Agent führt ihn durch); eine bestehende Police betreuen (Änderungen, Kündigungen, Schäden, Aktualisierungen des Hypothekengläubigers liegen außerhalb des Rahmens); die Identität eines Versicherers vor dem Vertragsabschlussschritt preisgeben (Optionen werden bis dahin neutral angezeigt); Angebote außerhalb der derzeit lizenzierten Bundesstaaten erstellen (rufen Sie check_eligibility auf).

Datenschutz & Sicherheit

• Der Endkunde benötigt nie einen API-Schlüssel.
• Angebotsanfragen erstellen Interessentendatensätze; sie überschreiben niemals bestehende Kundendatensätze.
• Erfinden Sie keine Angebote oder Tarife – wenn die Tools nichts zurückgeben, sagen Sie dies und bieten Sie submit_lead an.
• Bitten Sie Kunden nicht, persönliche Dokumente hochzuladen.