SalesTouch Docs
All MCP tools
Read onlyExtraction

Search Sales Navigator people

scrape_sales_navigator_people

Search and extract Sales Navigator leads from a URL or structured filters, optionally restricted to companies from a previous result.

When to use it

Build and extract a Sales Navigator lead search from readable structured filters or a search URL.

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

Requirements

Provide url, filters, or company_result_id.
The selected account must have Sales Navigator access.

Example

Ask your agent

Find 100 HR directors at companies from my previous Sales Navigator company result.

Tool arguments
{
  "company_result_id": "scrape_companies_123",
  "filters": {
    "current_job_title": {
      "include": [
        {
          "query": "Human Resources Director"
        }
      ]
    }
  },
  "limit": 100,
  "preview_limit": 20
}
MCP response envelope
{
  "content": [
    {
      "type": "text",
      "text": "{\n  \"data\": { ... },\n  \"meta\": null\n}"
    }
  ],
  "isError": false
}

Expected: A stored person result with preview, pagination, and signed JSONL/CSV exports.

Parameters

account_id
string

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

url
string

Sales Navigator search URL. Cannot be combined with filters or company_result_id.

filters
object

Additional tool input.

company_result_id
string

Stored Sales Navigator company result id used to restrict current companies.

limit
integer

Maximum results to extract.

preview_limit
integer

Maximum preview items to return inline. Defaults to 20.

context
string

Extraction context.

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.

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.

On this page

When to use itRequirementsExampleParametersCommon errorsRelated tools