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

query
string

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

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.

last_contacted_from
string

Inclusive lower bound for the last sent LinkedIn message.

last_contacted_to
string

Inclusive upper bound for the last sent LinkedIn message.

last_inbound_from
string

Inclusive lower bound for the last received LinkedIn message.

last_inbound_to
string

Inclusive upper bound for the last received LinkedIn message.

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

Use a SalesTouch workspace with LinkedIn MCP access.

trial_payment_method_required

Add a payment method in SalesTouch billing to activate the trial and LinkedIn MCP access.

On this page

When to use itRequirementsExampleParametersCommon errorsRelated tools