> ## Documentation Index
> Fetch the complete documentation index at: https://docs.pipecorn.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Tools

> Every tool the Pipecorn MCP server exposes, grouped by what it acts on.

Tools trigger actions on behalf of the user based on the goals and information
already in the assistant's context. The server exposes 31 tools. Each one
maps to a REST endpoint and spends the same credits or plan limits; see
[Credits vs limits](/api-reference/credits-vs-limits).

<Tip>
  The `preview_*` tools are free and synchronous. Ask the assistant to preview
  a search before running the full extraction, and to call `get_credits`
  before bulk enrichment.
</Tip>

## Companies

| Tool                       | Description                                                                          |
| -------------------------- | ------------------------------------------------------------------------------------ |
| `enrich_account`           | Enrich a company with firmographic data                                              |
| `search_accounts`          | Search companies on LinkedIn Sales Navigator by filters                              |
| `preview_search_accounts`  | Preview an account search to estimate result count and credit cost before running it |
| `find_lookalike_companies` | Find companies similar to one or more reference companies                            |
| `get_company_stack`        | Get the technology stack of a company                                                |
| `get_company_hiring`       | Get active job openings for a company                                                |
| `get_headcount`            | Get department headcount evolution (3-month, 6-month, 12-month) for a company        |

## Leads

| Tool                            | Description                                                                                                    |
| ------------------------------- | -------------------------------------------------------------------------------------------------------------- |
| `search_leads`                  | Extract leads from a LinkedIn Sales Navigator URL                                                              |
| `search_leads_in_company`       | Search for leads at a specific company                                                                         |
| `advanced_search_leads`         | Search for leads using advanced filters (job titles, locations, seniority, company size, industries, signals…) |
| `preview_advanced_search_leads` | Preview an advanced lead search to estimate result count and credit cost before running it                     |
| `get_searches`                  | Retrieve all lead searches                                                                                     |
| `get_search`                    | Get the status and results of a lead search                                                                    |

## Contacts

| Tool                     | Description                                                   |
| ------------------------ | ------------------------------------------------------------- |
| `single_enrich_contact`  | Synchronously enrich a single contact with email and/or phone |
| `bulk_enrich_contacts`   | Enrich multiple contacts with email or phone (min 2, max 100) |
| `get_contact_enrichment` | Get the enrichment result for a contact by its enrichment ID  |

## Lists

| Tool          | Description                                                                      |
| ------------- | -------------------------------------------------------------------------------- |
| `create_list` | Create a new company list and push companies into it on LinkedIn Sales Navigator |
| `get_lists`   | Retrieve all Sales Navigator lists                                               |
| `get_list`    | Retrieve a single list by its ID                                                 |
| `update_list` | Add companies to an existing Sales Navigator list                                |

## Personas

| Tool             | Description                                           |
| ---------------- | ----------------------------------------------------- |
| `list_personas`  | Retrieve all personas defined in the Pipecorn account |
| `get_persona`    | Retrieve a single persona by its UUID                 |
| `create_persona` | Create a new persona                                  |
| `update_persona` | Update an existing persona by its UUID                |
| `delete_persona` | Delete a persona by its UUID                          |

## Signals

| Tool                    | Description                                                                                    |
| ----------------------- | ---------------------------------------------------------------------------------------------- |
| `extract_posts`         | Extract recent posts from a LinkedIn profile or company page                                   |
| `extract_reactions`     | Extract posts that a LinkedIn member has reacted to                                            |
| `extract_comments`      | Extract comments made by a LinkedIn member                                                     |
| `extract_post_engagers` | Extract people who reacted or commented on a LinkedIn post                                     |
| `find_connections`      | Find mutual 1st-degree LinkedIn connections between your account and a target LinkedIn profile |

## Jobs

| Tool             | Description                         |
| ---------------- | ----------------------------------- |
| `get_job_result` | Poll for the result of an async job |

## Utilities

| Tool                | Description                                                                                                            |
| ------------------- | ---------------------------------------------------------------------------------------------------------------------- |
| `search_locations`  | Search for LinkedIn Sales Navigator location IDs by name                                                               |
| `search_industries` | Search for LinkedIn industry IDs by name — call this before `advanced_search_leads` when the user mentions an industry |
| `get_credits`       | Get remaining Pipecorn credits                                                                                         |