Read onlyLinkedIn

LinkedIn company lookup

linkedin_lookup_company

Fetch one LinkedIn company or school profile from a handle, id, or URL.

When to use it

Resolve a LinkedIn company or school page from a handle, identifier, or URL.

Required scopes

linkedin:accesssalestouch:use

Execution

Synchronous MCP tool call

Requirements

Provide identifier, company, company_linkedin_url, or handle.

Example

Ask your agent

Look up the LinkedIn company at https://www.linkedin.com/company/example.

Tool arguments

{
  "company_linkedin_url": "https://www.linkedin.com/company/example"
}

MCP response envelope

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

Expected: Normalized organization identity and available company profile fields.

Parameters

NameTypeDescription

account_id

string

Connected SalesTouch account id, username, email, handle, or account URL.

identifierrequired

string

LinkedIn company or school handle, public id, account id, or URL.

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.