SalesTouch Docs
All MCP tools
Read onlyLinkedIn

Browse Sales Navigator lead list

linkedin_sales_navigator_browse_lead_list

Browse the people saved in one LinkedIn Sales Navigator lead list.

When to use it

Browse the people saved in one Sales Navigator lead list, optionally prioritized or sorted.

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

Requirements

Provide list_id from linkedin_sales_navigator_get_lead_lists.
The selected account must have Sales Navigator access.

Example

Ask your agent

Browse leads who recently changed position in Sales Navigator lead list list_456.

Tool arguments
{
  "list_id": "list_456",
  "offset": 0,
  "limit": 25,
  "spotlight": "RECENT_POSITION_CHANGE"
}
MCP response envelope
{
  "content": [
    {
      "type": "text",
      "text": "{\n  \"data\": { ... },\n  \"meta\": null\n}"
    }
  ],
  "isError": false
}

Expected: Saved lead profiles plus total count, has-more state, and the next offset when available.

Parameters

account_id
string

Connected SalesTouch account id, username, email, handle, or account URL.

list_idrequired
string

Exact Sales Navigator lead-list id returned by linkedin_sales_navigator_get_lead_lists.

offset
integer

Zero-based pagination offset. Defaults to 0.

limit
integer

Maximum leads to return. Defaults to 25.

spotlight
string

Optional smart filter used to prioritize leads.

sort_by
string

Sort method. Defaults to DATE_ADDED.

sort_order
string

Sort order. Defaults to DESCENDING.

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.

sales_navigator_required

Select or connect a LinkedIn account with active Sales Navigator access.

search_parameter_not_resolved

Inspect the returned candidates and retry the filter with the intended candidate id.

deprecated_filter_v2

Run the equivalent native Sales Navigator search by URL because this legacy filter is absent from the v2 structured contract.

filter_not_expressible_v2

Use a native Sales Navigator search URL to preserve this exact filter intent.

On this page

When to use itRequirementsExampleParametersCommon errorsRelated tools