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

query
string

Text matched against lead names, headline, LinkedIn URL, und known identities.

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.

last_contacted_from
string

Inklusive Untergrenze for die zuletzt gesendete LinkedIn-Nachricht.

last_contacted_to
string

Inklusive Obergrenze for die zuletzt gesendete LinkedIn-Nachricht.

last_inbound_from
string

Inklusive Untergrenze for die zuletzt empfangene LinkedIn-Nachricht.

last_inbound_to
string

Inklusive Obergrenze for die zuletzt empfangene LinkedIn-Nachricht.

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

Verwende einen SalesTouch-Workspace mit Zugriff auf das LinkedIn-MCP.

trial_payment_method_required

Füge in der SalesTouch-Abrechnung eine Zahlungsmethode hinzu, um die Testphase und den Zugriff auf das LinkedIn-MCP zu aktivieren.