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 SalesTouch account id, username, email, handle, or account URL.

identifier
string

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

query
string

Text to match against conversations and recent messages.

limit
integer

Maximum conversations to return. Defaults to 10.

scan_limit
integer

Maximum recent conversations to scan. Defaults to 100.

message_scan_limit
integer

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.

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