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.

lead_id
string

Canonical SalesTouch lead id. Resolved locally before any LinkedIn provider request.

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.

provider_request_limit
integer

Maximum targeted message-read requests during local text filtering. Defaults to 8.

inspected_conversation_ids
array

Conversation ids already inspected by this workflow. They are preserved and skipped when resuming.

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