Read onlyEmail

Email threads

email_threads

Read the email threads, known addresses, and scheduled email sends of one lead from the mailboxes you can access.

When to use it

Read the email history with a lead before replying or planning a follow-up.

Required scopes

email:accesssalestouch:use

Execution

Synchronous MCP tool call

Provide lead_id from leads_search, lead_status, or leads_import.

Ask your agent

Show my email conversation with this lead and any emails still scheduled.

Tool arguments

{
  "lead_id": "lead_example"
}

MCP response envelope

{
  "content": [
    {
      "type": "text",
      "text": "{\n  \"data\": { ... },\n  \"meta\": null\n}"
    }
  ],
  "isError": false
}

Expected: The lead's email addresses with their status, threads with messages in chronological order, and scheduled sends.

NameTypeDescription

lead_idrequired

string

Canonical SalesTouch lead id returned by lead_status or leads_search.

Aliases are shown independently because MCP clients send a flat JSON object. Use one alias from each required group, not every alias.

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.

ACCESS_DENIED

Use a lead id from this workspace that is visible in your CRM scope.