SalesTouch Docs
All MCP tools
Read onlyLinkedIn

Search leads

leads_search

Search the workspace lead directory by identity, CRM status, inbox status, tags, source, and message contact dates.

When to use it

Find and segment leads already observed by SalesTouch without scanning LinkedIn conversations.

Required scopes
linkedin:accesssalestouch:use
Execution
Synchronous MCP tool call

Requirements

All filters are optional and apply to the current workspace.

Example

Ask your agent

Find contacted leads tagged Founder whose last sent message was in the last 90 days.

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

Expected: A cursor-paginated list of mini-profiles, CRM and inbox statuses, tags, contact dates, and source summaries.

Parameters

crm_scope
string

CRM scope: organization, member:<id>, or group:<id>. Defaults to your shared group or personal CRM.

query
string

Text matched against lead names, headline, LinkedIn URL, known identities, email addresses, and phone numbers.

crm_status
array

Additional tool input.

inbox_status
array

Operational messaging state: NOT_CONTACTED means no outbound message was sent; OUTREACH_SCHEDULED means an outbound message is queued; AWAITING_PROSPECT_REPLY means the latest message is ours; PROSPECT_REPLIED means the latest message is from the prospect.

tags_any
array

Additional tool input.

tags_all
array

Additional tool input.

source_type
string

Exact lead source type.

source_id
string

Exact lead source id returned by lead_status or leads_search.

has_email
boolean

true for leads with an email address, false for leads without one.

last_contacted_from
string

Inclusive lower bound for the last sent message, on LinkedIn or by email.

last_contacted_to
string

Inclusive upper bound for the last sent message, on LinkedIn or by email.

last_inbound_from
string

Inclusive lower bound for the last received message, on LinkedIn or by email.

last_inbound_to
string

Inclusive upper bound for the last received message, on LinkedIn or by email.

sort
string

Lead ordering. Defaults to updated_desc.

cursor
string

Opaque lead pagination cursor. Reuse it only with the same filters and sort order.

limit
integer

Maximum leads to return. Defaults to 25.

Aliases are shown independently because MCP clients send a flat JSON object. Use one alias from each required group, not every alias.

Common errors

insufficient_scope

Reconnect the MCP and approve the requested LinkedIn permission.

paid_plan_required

Follow the error's action_url: start the free trial, choose a plan after a trial or subscription ended, or update the payment method after a failed payment. details.reason names which one.

trial_payment_method_required

Retry after a minute if checkout was just completed; otherwise add a payment method in SalesTouch billing to activate the trial and LinkedIn MCP access.

On this page

When to use itRequirementsExampleParametersCommon errorsRelated tools