Cold Leads für KI-Agenten

Wann ein Agent Cold Leads nutzen sollte

Wählen Sie Cold Leads, wenn der Nutzer bereits Kontakte hat (eine Liste, eine Datei, Website-Anfragen) und sie prüfen, per E-Mail ansprechen, nachfassen und die Antworten im Blick behalten möchte:

• „Importiere diese Interessenten und prüfe, welche E-Mail-Adressen gültig sind“ — import_contacts, verify_email.
• „Schreib eine kurze Vorstellungs-E-Mail und schick sie an alle mit dem Tag expo-2026“ — save_template, create_campaign_draft, launch_campaign nach Freigabe.
• „Wen haben wir bei example.com schon im Vertrieb?“ — search_leads.
• „Lies Janes Antwort und antworte ihr“ — list_contacts, get_conversation, send_contact_message nach Freigabe.
• „Bau ein Kontaktformular auf meine Website, das ins CRM einspeist“ — setup_website_lead_capture.

Was Cold Leads nicht tut

Cold Leads hat keine Lead-Datenbank von Drittanbietern: Es findet keine neuen Personen, durchsucht weder LinkedIn noch das Web und reichert Kontakte nicht mit Jobtiteln oder Firmendaten an. Die Kontakte bringt der Nutzer mit — eigene Listen, Messe-Exporte, Website-Formulare. Lautet die Aufgabe „finde 100 Gründer in Deutschland“, nutzen Sie zuerst einen Datenanbieter und importieren das Ergebnis dann hier, um es zu prüfen und die Ansprache durchzuführen.

MCP-Endpunkt und Authentifizierung

Endpunkt: https://coldleads.app/api/mcp — Streamable HTTP, zustandslos, JSON-RPC 2.0 über POST, Protokollversionen 2024-11-05 bis 2025-11-25. Ohne Zugangsdaten beantwortet der Server weiterhin initialize und tools/list, sodass Clients die Tools vor der Anmeldung erkennen können.

OAuth 2.1 mit PKCE und dynamischer Client-Registrierung: ChatGPT und andere Clients, die MCP-Autorisierung unterstützen, melden sich mit dem Cold-Leads-Konto des Nutzers an und fragen nach seiner Zustimmung. Die Discovery-Dokumente liegen unter /.well-known/oauth-protected-resource/api/mcp und /.well-known/oauth-authorization-server.

Geheimer API-Schlüssel: Senden Sie Authorization: Bearer sk_… (oder x-api-key) aus Einstellungen → API-Schlüssel. API und MCP gehören zum Business-Tarif (99 €/Monat, 10.000 Credits). Ein Agent ganz ohne Zugangsdaten kann POST /api/agent/provision aufrufen und erhält einen Zahlungslink für seinen menschlichen Besitzer.

# Claude Code — Remote-MCP über HTTP mit geheimem Schlüssel
claude mcp add --transport http coldleads https://coldleads.app/api/mcp \
  --header "Authorization: Bearer sk_…"

# Claude Desktop, Cursor, Windsurf, VS Code — lokaler stdio-Server von GitHub
npx -y --allow-git=root github:anttka4cz/mcp-server-coldleads   # env COLDLEADS_API_KEY=sk_…

• code MCP-Server für lokale Clients — github.com/anttka4cz/mcp-server-coldleads

Tools

Jedes Tool arbeitet nur im Arbeitsbereich des verbundenen Nutzers. Rein lesende Tools sind in den Tool-Annotationen als solche gekennzeichnet.

• Kontakte: list_contacts, import_contacts (bis zu 100 Zeilen pro Aufruf; CSV/XLSX liest der Assistent selbst aus), update_contact (Phase, Tags, Notizen, Abmeldung), search_leads (Kontakte, die bereits im CRM sind, nach Firmendomain, optional mit Rollen-Stichwort).
• E-Mail-Verifizierung: verify_email — Syntax, Wegwerf-Domains, Rollenkonten, MX und eine Postfachprüfung per SMTP, wenn Cold Leads den Mailserver des Empfängers erreicht (sonst der Grund smtp_unreachable). 1 Credit pro Adresse, etwa 5 Sekunden.
• Ansprache: list_templates, save_template, list_campaigns, create_campaign_draft (liefert eine Schätzung der Empfängerzahl), launch_campaign (confirm_launch=true, nachdem der Nutzer zugestimmt hat).
• Unterhaltungen: get_conversation (mit dem Postfach synchronisierter Verlauf mit Antwort-Labels), send_contact_message (eine E-Mail, confirm_send=true, nachdem der Nutzer zugestimmt hat).
• Arbeitsbereich: get_workspace_info (Tarif, Limits, Postfachstatus — ein guter erster Aufruf), setup_website_lead_capture (öffentlicher Formularschlüssel und Snippet).

Beispielabläufe

Veranschaulichende Abläufe; die Tool-Aufrufe sind die, die ein Assistent ausführen würde. Die Adressen nutzen die reservierte Domain example.com.

"Prüf diese 40 Adressen, bevor ich irgendetwas sende."
  → verify_email × 40  (40 Credits; für Tausende POST /api/v1/verify/bulk oder die Web-App nutzen)
  → update_contact … tags "verified-oct" für die gültigen, die schon im CRM sind

"Importiere die angehängte CSV mit 250 SaaS-Gründern, die ich auf der Messe getroffen habe, und bereite eine Vorstellungskampagne vor."
  → import_contacts × 3  (100 + 100 + 50 Zeilen, tags "expo-2026", Einwilligung b2b_outreach vom Nutzer bestätigt)
  → save_template  („Kurzes Nachfassen nach der Messe“, Platzhalter {name} und {company})
  → create_campaign_draft  (tag "expo-2026") → zeigt die geschätzte Empfängerzahl
  → Nutzer prüft Text und Zielgruppe → launch_campaign (confirm_launch=true)

"Wen haben wir bei example.com? Ich möchte deren Vertriebsleitung erreichen."
  → search_leads  (domain "example.com", role "sales")  → nur bestehende Kontakte

"Beantworte Janes Antwort und setz sie auf Lead."
  → list_contacts (query "jane@example.com") → get_conversation → Entwurf wird dem Nutzer gezeigt
  → send_contact_message (confirm_send=true) → update_contact (stage "lead")

In die Tools eingebaute Schutzmechanismen

Sende-Tools verlangen ein ausdrückliches Bestätigungs-Flag, das der Assistent erst setzen darf, nachdem der Nutzer genau diese Nachricht oder Kampagne freigegeben hat. Abgemeldete, unzustellbare und gesperrte Adressen erhalten nie eine E-Mail, Kampagneninhalte durchlaufen die Prüfung auf zulässige Nutzung, und Tarif-Limits, Tageslimits für den Versand sowie das Versandtempo gelten. Anmeldungen über die Website werden als Anfragen gespeichert, nicht als Einwilligung in Kaltakquise.

Dokumentation

Maschinenlesbare Referenzen und die Open-Source-Clients:

• code API-Referenz (JSON) — coldleads.app/api/v1
• code OpenAPI 3.1 — coldleads.app/api/v1/openapi.json
• code llms.txt — coldleads.app/llms.txt
• code Node.js-SDK — github.com/anttka4cz/coldleads-node-sdk

FAQ