Read onlyLinkedIn

Describe a data tool

data_describe

Read one data tool's parameters, estimated credit cost, output shape, an example response and cheaper or better alternatives. Use before data_call.

When to use it

Check the parameters, price and output of a data tool before spending credits.

Required scopes

salestouch:use

Execution

Synchronous MCP tool call

Requirements

Provide id from data_search.

Example

Ask your agent

What inputs does the data tool salestouch.people.email.find need, and what does it cost?

Tool arguments

{
  "id": "salestouch.people.email.find"
}

MCP response envelope

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

Expected: The tool's inputs, estimated credits, output shape, an example response and alternatives.

Parameters

NameTypeDescription

idrequired

string

Data tool id returned by data_search.

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.

data_tool_not_found

Use an id returned by data_search.