Coldleads als MCP-Server für KI-Agenten
Sag deinem Agenten „Such mir Friseure in Köln ohne Website“ — und er startet die Suche, wartet, filtert und legt die Liste an. Vierzehn Werkzeuge, dieselben Regeln wie in der App.
Kurzüberblick
Der MCP-Server von Coldleads gibt KI-Agenten 14 Werkzeuge: suchen, filtern, Listen anlegen, Status und Anrufergebnisse zurückschreiben.
- Einrichtung in Claude Code mit einer Zeile, Schlüssel aus der App.
- Coldleads ist das CRM, das seine Leads selbst findet: Betriebe aus Google Maps, qualifiziert, angerufen und nachgefasst bis zum Termin.
- Dieselben Regeln wie in der App: Credits, Anlass vor dem Anruf, Widerspruch.
- Der Agent sucht und sortiert. Anrufen tust du.
Ein Gespräch mit dem Agenten
So sieht es aus, wenn Claude Coldleads als Werkzeug hat. Gekürzt, Zahlen aus dem Lauf „Friseur Köln 20 km“.
- DuSuch mir Friseure in Köln im Umkreis von 20 km und leg die ohne Website in eine Liste „Website-Angebot Köln“.
- Werkzeugsearch_start(industry="Friseur", location="Köln", radius_km=20, target=300)
- AgentDie Suche läuft. Ich frage den Stand alle 30 Sekunden ab.
- Werkzeugsearch_status(…) → status=fertig, found=336, new=336, credits_spent=327
- Werkzeuglists_create(name="Website-Angebot Köln") · lists_add_search(…)
- AgentFertig: 336 Betriebe, 327 Credits. Bevor du anrufen kannst, braucht die Liste einen Anlass — soll ich „Betriebe ohne eigene Website, Angebot einer Website für lokale Kundschaft“ eintragen?
- DuJa, und zeig mir die zehn mit den besten Bewertungen.
- Werkzeuglists_set_reason(…) · leads_list(website="ohne", sort="bewertung", limit=10)
Einrichten
Der Server spricht Streamable HTTP, zustandslos, mit dem API-Schlüssel im Header.
claude mcp add --transport http coldleads https://app.coldleads.net/mcp \
--header "Authorization: Bearer cl_live_…"{
"mcpServers": {
"coldleads": {
"command": "npx",
"args": ["mcp-remote", "https://app.coldleads.net/mcp",
"--header", "Authorization: Bearer cl_live_…"]
}
}
}1. Schlüssel anlegen. In der App unter „Verwalten → API-Schlüssel“, ab Tarif Agency. Der Schlüssel beginnt mit cl_live_ und gehört zu genau einem Workspace.
2. Server eintragen. Adresse app.coldleads.net/mcp, Header Authorization: Bearer …. In Claude Code reicht die Zeile links. Clients, die keinen eigenen Header setzen können, binden den Server über das Hilfsprogramm mcp-remote ein, wie im zweiten Beispiel.
3. Fragen. Der Server gibt dem Agenten beim Verbinden eine kurze Anleitung mit: erst suchen, dann den Stand abfragen, vor dem Status einen Anlass setzen. Du musst ihm das nicht erklären.
Ohne gültigen Schlüssel antwortet der Server mit einem deutschen Satz, der sagt, wo es den Schlüssel gibt — der Agent kann ihn dir weitergeben.
Die 14 Werkzeuge
Dieselben Vorgänge wie die REST-API. Namen mit Unterstrich, weil manche Clients keine Punkte zulassen.
| Werkzeug | Titel | Was es tut |
|---|---|---|
search_start | Suche starten | Branche, Ort, Radius, Zielmenge — kehrt sofort zurück |
search_status | Stand einer Suche | Gefunden, neu, verbrauchte Credits, Ziel verfehlt |
searches_list | Letzte Suchen | Neueste zuerst |
search_control | Suche steuern | Anhalten, fortsetzen, beenden |
leads_list | Leads filtern | Ohne Website, Bewertung, PLZ, heute fällig |
leads_get | Ein Lead | Alle Felder und die Anrufhistorie |
leads_update_status | Status setzen | Offen, angerufen, Rückruf, Termin, kein Interesse |
leads_log_result | Anrufergebnis erfassen | Inhaber erreicht, Mailbox, Unterlagen angefordert … |
leads_note | Notiz ersetzen | Eine Notiz je Betrieb |
lists_list | Listen | Mit Anzahl, Anlass und ob anrufbereit |
lists_create | Liste anlegen | Zum Beispiel für eine Kampagne |
lists_add_search | Suche zuordnen | Die Betriebe einer Suche in eine Liste |
lists_set_reason | Anlass setzen | Warum das Angebot zu diesen Betrieben passt |
credits_get | Guthaben | Verfügbar, Kontingent, Nachkauf |
Was der Agent nicht darf
Ein Agent ist ein zweiter Weg in die Liste — kein Weg an den Regeln vorbei.
- Kein Status ohne Anlass. Ein Statuswechsel gilt als Anruf. Ohne Anlassbegründung der Liste lehnt der Server ihn ab — im B2B darf nur mit sachlichem Anlass angerufen werden (§ 7 UWG).
- Keine gesperrten Nummern. Betriebe, die widersprochen haben, liefert der Server nicht aus.
- Kein Anruf, keine Mail. Der Agent ruft nicht an und schreibt keine Mails. E-Mail-Entwürfe mit Prüfung der Einwilligung sind in Entwicklung — Kalt-E-Mail-Sequenzen wird es nicht geben.
- Keine Credits ohne Betrieb. Werkzeugaufrufe kosten nichts; ein Credit fällt nur für einen neuen Betrieb mit Telefonnummer an.
Coldleads bleibt dabei das CRM bis zum Termin — der Agent ist eine zweite Hand an derselben Liste. Wie die Liste in der App aussieht, zeigt Produkt.
© OpenStreetMap
Schlüssel anlegen, Zeile kopieren, fragen
Ab Agency: den API-Schlüssel unter „Verwalten → API-Schlüssel“ anlegen und in die Einrichtung setzen. Danach ist Coldleads ein Werkzeug deines Agenten.
25 Credits für 7 Tage · ohne Kreditkarte. Credits nur für neue Betriebe mit Telefonnummer.
Häufige Fragen
Was ist der Coldleads MCP-Server?
Eine Schnittstelle nach dem Model Context Protocol, über die KI-Agenten wie Claude Coldleads bedienen: Suchen starten, Leads filtern, Status und Anrufergebnisse setzen — mit 14 Werkzeugen.
Welche KI-Clients funktionieren?
Jeder MCP-Client, der Streamable HTTP mit eigenem Authorization-Header spricht, etwa Claude Code. Clients ohne Header-Unterstützung binden den Server über das Hilfsprogramm mcp-remote ein.
Ab welchem Tarif gibt es den MCP-Server?
Ab Agency, mit demselben API-Schlüssel wie die REST-API.
Kann der Agent für mich anrufen?
Nein. Er sucht, sortiert und schreibt zurück, was du ihm sagst. Angerufen wird von dir, und Status oder Ergebnis lassen sich nur setzen, wenn die Liste einen dokumentierten Anlass hat.
Kostet die Nutzung über einen Agenten extra?
Nein. Es gelten dieselben Credits wie in der App: einer je neuem Betrieb mit Telefonnummer.
Dein Agent findet die Betriebe. Du rufst an.
Suchen, filtern, Listen anlegen — per Satz statt per Klick, mit denselben Credits wie in der App.