Cold Leads
API · MCP · SDK

Bauen Sie auf Cold Leads

Cold Leads ist ein CRM für Kaltakquise, das Sie aus dem Code steuern können. Prüfen Sie E-Mail-Adressen vor dem Versand, übergeben Sie Leads aus jedem Formular oder System, bewegen Sie Kontakte durch den Funnel und geben Sie Ihrem KI-Agenten über MCP dieselben Werkzeuge. Reines JSON, ein Header für die Authentifizierung und eine OpenAPI-3.1-Spezifikation zum Generieren von Clients.

  • OpenAPI 3.1
  • ·x-api-key-Authentifizierung
  • ·120 Anfragen pro Minute und Schlüssel
  • ·Gehosteter MCP-Server
  • ·SDK unter MIT-Lizenz auf GitHub
POST /api/v1/verify
curl -X POST https://coldleads.app/api/v1/verify \
  -H "x-api-key: $COLDLEADS_API_KEY" \
  -d '{"email":"jane@example.com"}'
{
  "email": "jane@example.com",
  "status": "valid",
  "score": 75,
  "reasons": ["smtp_unreachable"],
  "mx": "mx.example.com",
  "catch_all": null,
  "disposable": false,
  "role": false
}

Beispielantwort. Die Grundcodes zeigen, ob auch das Postfach selbst geprüft wurde.

120/Min.

Anfragen pro Schlüssel, ein Auth-Header

14

MCP-Werkzeuge für Claude, ChatGPT und Cursor

5 Tage

kostenlose Testphase mit API-Zugang in Business

Schnittstellen

Wählen Sie die passende Schnittstelle

REST-API

Eine Adresse oder eine Liste prüfen (Bulk-Jobs), Kontakte im eigenen CRM suchen, das Credit-Guthaben lesen. OpenAPI-3.1-Spezifikation für Codegenerierung und für Agenten, die Werkzeuge aus einer Spezifikation importieren.

OpenAPI-3.1-Spezifikation

Lead- und Stage-Hooks

Ein Website-Schlüssel (lk_…) macht aus jedem Formular eine Lead-Quelle und kann nach einer von Ihnen gewählten Verzögerung eine Auto-Kampagne starten. Der Stage-Hook markiert einen Kontakt als Kunde, sobald Ihr Abrechnungs- oder CRM-System den Deal abschließt.

Gehosteter MCP-Server

https://coldleads.app/api/mcp gibt Claude, ChatGPT, Cursor und anderen MCP-Clients 14 Werkzeuge: Kontakte importieren und ändern, Adressen prüfen, Vorlagen schreiben, Kampagnen entwerfen und nach Ihrer Freigabe starten, Antworten lesen. OAuth oder geheimer Schlüssel.

Cold Leads für KI-Agenten

Node.js-SDK und stdio-MCP

Typisierter Client für Node 20 oder neuer und ein lokaler MCP-Server für Claude Desktop, Cursor und VS Code. Open Source, MIT-Lizenz, Installation direkt von GitHub.

github.com/anttka4cz/coldleads-node-sdk
Schnellstart

Von der Registrierung zum ersten Aufruf in Minuten

1

Registrieren

Erstellen Sie ein Konto mit Google oder einem E-Mail-Link. Starten Sie die 5-tägige kostenlose Testphase im Tarif Business, um die API mit 25 Credits auszuprobieren (Karte erforderlich, bis zum Ende jederzeit kündbar).

2

Schlüssel erstellen

Einstellungen → API. Ein geheimer Schlüssel (sk_…) für Ihren Server, ein Website-Schlüssel (lk_…) für Formulare auf Ihrer Seite. Geheime Schlüssel werden als Hash gespeichert, einmal angezeigt und lassen sich pausieren, rotieren oder löschen.

3

Aufruf senden

Senden Sie den Schlüssel im Header x-api-key und rufen Sie einen der Endpunkte unten auf. Fehler sind JSON mit kurzem Code wie rate_limited, no_credits oder bad_input.

Drei Aufrufe, die die meisten Integrationen abdecken
# 1. Verify an address (1 credit)
curl -X POST https://coldleads.app/api/v1/verify \
  -H "x-api-key: $COLDLEADS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"email":"jane@example.com"}'

# 2. Capture a lead from any form (website key lk_…, safe to ship in HTML)
curl -X POST "https://coldleads.app/api/hooks/lead?key=$COLDLEADS_SITE_KEY" \
  -d email=jane@example.com -d name="Jane Doe"

# 3. Move a contact along the funnel when the deal closes
curl -X POST https://coldleads.app/api/hooks/stage \
  -H "x-api-key: $COLDLEADS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"email":"jane@example.com","stage":"customer"}'

# Node.js SDK and MCP server (installed from GitHub)
npm install --allow-git=root github:anttka4cz/coldleads-node-sdk
npx -y --allow-git=root github:anttka4cz/mcp-server-coldleads

Ersetzen Sie die Umgebungsvariablen durch Ihre Schlüssel. Die Adressen sind Beispiele.

Eine Verifizierungsantwort enthält einen Status (valid, risky oder invalid), eine Punktzahl, Grundcodes, den MX-Host und das Feld catch_all. Die Grundcodes zeigen, ob auch das Postfach selbst geprüft wurde.

Warum Cold Leads

Warum Entwickler bleiben

Reines JSON über HTTPS, ein Auth-Header, Fehler mit kurzen Codes — zum Start ist kein SDK nötig.

Jeder Schlüssel hat ein eigenes Rate-Limit und einen eigenen Nutzungszähler und lässt sich pausieren oder rotieren, ohne die anderen anzufassen.

Dieselbe Engine betreibt Ihre eigenen Kampagnen: An als ungültig geprüfte Adressen wird nie gesendet, und Kampagnen gehen aus Ihrem eigenen Gmail-, Microsoft-365- oder SMTP-Postfach raus.

KI-Agenten arbeiten mit Freigabe: Sie bereiten einen Kampagnenentwurf vor und starten ihn erst, nachdem ein Mensch Vorlage und Zielgruppe bestätigt hat.

Ein Agent kann sogar ohne Schlüssel starten: POST /api/agent/provision liefert einen Zahlungslink für den menschlichen Inhaber und ein Claim-Token.

Preise

Preise

$99pro Monat · Business · 10,000

Website-Schlüssel funktionieren in jedem Tarif. Die API mit geheimem Schlüssel (Verifizierung, Finder, Kontaktsuche, Stage-Hook) und MCP gehören zu Business: $99 pro Monat inklusive 10,000 Credits im Monat. Zusätzliche Credits kosten $5 pro 1 000.

Erst testen: Die 5-tägige kostenlose Testphase in Business enthält die API im Rahmen der Testlimits (25 Credits). Neukunden, die innerhalb von 24 Stunden nach der Registrierung abonnieren, erhalten statt der Testphase 30 % Rabatt auf die erste Zahlung — beides lässt sich nicht kombinieren.

Limits

  • 120 Anfragen pro Minute und Schlüssel.
  • 5 parallele Bulk-Jobs, bis zu 5 000 Adressen pro Job.
  • 1 Credit pro geprüfter Adresse oder Finder-Aufruf; Ergebnisse werden 30 Tage zwischengespeichert, und eine wiederholte Prüfung kostet ebenfalls einen Credit.
  • Website-Schlüssel (lk_…) können nur Kontakte anlegen, mit einer Tagesgrenze pro Schlüssel.
Klartext

Was es nicht ist

Keine Lead-Datenbank: Cold Leads verkauft keine Personen- oder Firmendaten und reichert Kontakte nicht an. Die Suche läuft über die Kontakte in Ihrem eigenen Konto.
Die Postfach- und Accept-all-Prüfung per SMTP läuft nur, wenn unser Server den Mailserver des Empfängers erreicht; sonst zeigt der Grundcode, dass das Postfach nicht geprüft wurde.
Noch keine ausgehenden Webhooks: Ergebnisse per Abruf lesen oder MCP nutzen.
SDK und stdio-MCP-Server werden von GitHub installiert; sie sind nicht auf npm.
Rezepte

Rezepte

Alle Rezepte
FAQ

FAQ für Entwickler

Brauche ich eine Karte, um die API zu testen?

Ja. Die 5-tägige kostenlose Testphase braucht eine Karte und ist vor ihrem Ende kündbar; währenddessen wird nichts abgebucht. Einen kostenlosen Tarif gibt es nicht.

Welcher Tarif enthält die API?

Business ($99 pro Monat, 10,000 Credits). Website-Schlüssel für Formulare funktionieren in jedem Tarif. In der Business-Testphase funktioniert die API im Rahmen der Testlimits.

Kann ich einen Client aus der Spezifikation generieren?

Ja, /api/v1/openapi.json ist ein OpenAPI-3.1-Dokument. Die beiden Hooks sind einfache HTTP-Aufrufe, die auf dieser Seite beschrieben sind.

Gibt es ein SDK?

Ein typisiertes Node.js-SDK (Node 20 oder neuer) und ein MCP-Server für lokale Clients, beide unter MIT-Lizenz auf GitHub. Andere Sprachen nutzen die HTTP-API direkt.

Kann sich ein KI-Agent selbst registrieren?

Ein Agent ruft POST /api/agent/provision mit der E-Mail des Inhabers auf. Er erhält einen Stripe-Zahlungslink für den menschlichen Inhaber und ein Claim-Token; nachdem der Inhaber bezahlt hat, bekommt der Agent seinen Schlüssel einmalig.

Was passiert, wenn meine Credits aufgebraucht sind?

Aufrufe liefern den Fehler 402 no_credits mit dem Restguthaben. Credits erneuern sich monatlich, zusätzliche Pakete kosten $5 pro 1 000.

Bereit zum Bauen?

Konto erstellen, Schlüssel holen und in wenigen Minuten den ersten Aufruf senden.

API-Schlüssel holen