SalesTouch Docs
All MCP tools
Read onlyLinkedIn

LinkedIn search parameters

linkedin_sales_navigator_search_parameters

Discover account-specific v2 parameter ids for LinkedIn Classic or Sales Navigator structured searches. The legacy tool name is preserved for compatibility.

When to use it

Discover exact account-specific v2 ids before a LinkedIn Classic or Sales Navigator structured search.

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

Requirements

Provide one explicit parameter type; use saved_people_search, saved_company_search, or recent_search for reusable searches.
Pass the returned id in {id: ...}; {query: ...} is also accepted when its label resolves uniquely.
Set product to classic for Classic search filters; the default remains sales_navigator for compatibility.

Example

Ask your agent

Find the Sales Navigator location parameter for Paris.

Tool arguments
{
  "type": "location",
  "query": "Paris",
  "limit": 10
}
MCP response envelope
{
  "content": [
    {
      "type": "text",
      "text": "{\n  \"data\": { ... },\n  \"meta\": null\n}"
    }
  ],
  "isError": false
}

Expected: Candidate parameter ids, labels, and available saved-search metadata that can be passed directly to a structured v2 search.

Parameters

account_id
string

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

product
string

Search product. Defaults to sales_navigator for backward compatibility.

typerequired
string

LinkedIn Classic or Sales Navigator parameter family to search.

query
string

Human-readable value to resolve. Optional for list-like types.

limit
integer

Maximum candidates to return. Defaults to 10.

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