SalesTouch Docs
Alle MCP-Tools
Nur LesenLinkedIn

Leads suchen

leads_search

Durchsuche das Lead-Verzeichnis des Workspace nach Identität, CRM-Status, Postfachstatus, Tags, Quelle und Kontaktzeitpunkten per Nachricht.

Wann verwenden

Finde und segmentiere bereits von SalesTouch erfasste Leads, ohne LinkedIn-Konversationen zu scannen.

Erforderliche Scopes
linkedin:accesssalestouch:use
Ausführung
Synchroner MCP-Tool-Aufruf

Voraussetzungen

Alle Filter sind optional und gelten für den aktuellen Workspace.

Beispiel

Frage deinen Agenten

Finde kontaktierte Leads mit dem Tag Founder, deren letzte gesendete Nachricht in den vergangenen 90 Tagen lag.

Tool-Argumente
{
  "crm_status": [
    "Contacted"
  ],
  "tags_any": [
    "Founder"
  ],
  "limit": 25
}
MCP-Antwortumschlag
{
  "content": [
    {
      "type": "text",
      "text": "{\n  \"data\": { ... },\n  \"meta\": null\n}"
    }
  ],
  "isError": false
}

Erwartet: Eine per Cursor paginierte Liste mit Mini-Profilen, CRM- und Postfachstatus, Tags, Kontaktdaten und Quellenzusammenfassungen.

Parameter

crm_scope
string

CRM-Bereich: organization, member:<id> oder group:<id>. Standardmäßig Ihre gemeinsame Gruppe oder Ihr persönliches CRM.

query
string

Text, der mit Lead-Namen, Headline, LinkedIn-URL, bekannten Identitäten und E-Mail-Adressen abgeglichen wird.

crm_status
array

Additional tool input.

inbox_status
array

Betriebsstatus der Nachrichten: NOT_CONTACTED bedeutet, dass keine ausgehende Nachricht gesendet wurde; OUTREACH_SCHEDULED bedeutet, dass eine ausgehende Nachricht eingereiht ist; AWAITING_PROSPECT_REPLY bedeutet, dass die letzte Nachricht von uns stammt; PROSPECT_REPLIED bedeutet, dass die letzte Nachricht vom Interessenten stammt.

tags_any
array

Additional tool input.

tags_all
array

Additional tool input.

source_type
string

Exakter Typ der Lead-Quelle.

source_id
string

Exakte Lead-Quell-ID, zurückgegeben von lead_status oder leads_search.

has_email
boolean

true für Leads mit E-Mail-Adresse, false für Leads ohne.

last_contacted_from
string

Inklusive Untergrenze for die zuletzt gesendete Nachricht, auf LinkedIn oder per E-Mail.

last_contacted_to
string

Inklusive Obergrenze for die zuletzt gesendete Nachricht, auf LinkedIn oder per E-Mail.

last_inbound_from
string

Inklusive Untergrenze for die zuletzt empfangene Nachricht, auf LinkedIn oder per E-Mail.

last_inbound_to
string

Inklusive Obergrenze for die zuletzt empfangene Nachricht, auf LinkedIn oder per E-Mail.

sort
string

Lead-Sortierung. Standard: updated_desc.

cursor
string

Undurchsichtiger Cursor für die Lead-Paginierung. Nur mit denselben Filtern und derselben Sortierreihenfolge wiederverwenden.

limit
integer

Höchstzahl zurückzugebender Leads. Standard: 25.

Aliasse werden einzeln angezeigt, da MCP-Clients ein flaches JSON-Objekt senden. Verwende pro erforderlicher Gruppe genau einen Alias, nicht alle Aliasse.

Häufige Fehler

insufficient_scope

Verbinde das MCP erneut und genehmige die angeforderte LinkedIn-Berechtigung.

paid_plan_required

Folge der action_url des Fehlers: Starte die kostenlose Testphase, wähle einen Tarif, wenn die Testphase oder das Abo beendet ist, oder aktualisiere die Zahlungsmethode nach einer fehlgeschlagenen Zahlung. details.reason nennt den Fall.

trial_payment_method_required

Versuche es nach einer Minute erneut, wenn der Checkout gerade abgeschlossen wurde; füge sonst in der SalesTouch-Abrechnung eine Zahlungsmethode hinzu, um die Testphase und den Zugriff auf das LinkedIn-MCP zu aktivieren.

Auf dieser Seite

Wann verwendenVoraussetzungenBeispielParameterHäufige FehlerVerwandte Tools