SalesTouch Docs
All MCP tools
Read onlyLinkedIn

LinkedIn conversation search

linkedin_conversations_search

Find LinkedIn messaging conversations by profile identity or local text search.

When to use it

Find a conversation from a profile identity or text found in recent messages.

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

Requirements

Provide a member target, a query, or both.
account_id is optional when SalesTouch can resolve a connected account automatically.

Example

Ask your agent

Find my LinkedIn conversation with https://www.linkedin.com/in/example.

Tool arguments
{
  "linkedin_url": "https://www.linkedin.com/in/example",
  "limit": 5
}
MCP response envelope
{
  "content": [
    {
      "type": "text",
      "text": "{\n  \"data\": { ... },\n  \"meta\": null\n}"
    }
  ],
  "isError": false
}

Expected: Matching conversations ranked from the recent conversation scan.

Parameters

account_id
string

Connected LinkedIn account id, remote id, username, email, handle, or account URL.

identifier
string

LinkedIn member handle, provider id, public id, or profile URL.

recipient
string

Alias for identifier when sending to a member.

linkedin_url
string

LinkedIn profile URL.

profile_url
string

Alias for linkedin_url.

handle
string

LinkedIn public identifier or local handle.

query
string

Text to match against conversations and recent messages.

limit
number

Maximum conversations to return. Defaults to 10.

scan_limit
number

Maximum recent conversations to scan. Defaults to 100.

message_scan_limit
number

Maximum recent messages to scan. Defaults to 250.

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.

On this page

When to use itRequirementsExampleParametersCommon errorsRelated tools