SalesTouch Docs
All MCP tools
Read onlyLinkedIn

Status

status

Inspect SalesTouch LinkedIn outreach stats, queue counts, and optional detailed items. Also reports onboarding next steps, with a link, when the plan or LinkedIn connection is not set up yet. With email access, also reports mailbox health and email outreach (sent, queued, failed, bounces, replies).

When to use it

Check workspace health, outreach activity, limits, and queued actions before or after a workflow.

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

Requirements

No input is required.
Use detail: items only when you need row-level results.

Example

Ask your agent

Show my SalesTouch status, including queue and LinkedIn limits.

Tool arguments
{
  "detail": "summary",
  "include": [
    "accounts",
    "queue",
    "limits"
  ]
}
MCP response envelope
{
  "content": [
    {
      "type": "text",
      "text": "{\n  \"data\": { ... },\n  \"meta\": null\n}"
    }
  ],
  "isError": false
}

Expected: A normalized workspace snapshot with the requested sections.

Parameters

detail
string

Response detail level. Summary omits row-level action previews; items includes them. Defaults to summary.

include
array

Sections to include. Use accounts, outreach, queue, limits, invitations, messages, or follow_ups.

from
string

Inclusive ISO 8601 lower date bound.

to
string

Inclusive ISO 8601 upper date bound.

account_id
string

Connected LinkedIn account id.

limit
integer

Default maximum items per detailed section. Defaults to 20.

preview_limit
integer

Maximum actions_preview items when detail is items. Defaults to 10.

limits
object

Per-section item limits for queue, invitations, messages, and follow_ups.

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

Follow the error's action_url: start the free trial, choose a plan after a trial or subscription ended, or update the payment method after a failed payment. details.reason names which one.

trial_payment_method_required

Retry after a minute if checkout was just completed; otherwise add a payment method in SalesTouch billing to activate the trial and LinkedIn MCP access.

On this page

When to use itRequirementsExampleParametersCommon errorsRelated tools