> ## 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.

# MCP Server

> Connect any MCP-compatible AI assistant to Pipecorn to find companies, search leads, and enrich contacts from a chat interface.

The Pipecorn MCP server enables your AI agents and tools to interact directly with Pipecorn's products via the [Model Context Protocol](https://modelcontextprotocol.io). Once connected, your AI assistant can find companies, search leads, and enrich contacts on your behalf.

**Server URL:** `https://mcp.pipecorn.com/mcp`

<Note>
  Two authentication methods are supported: **OAuth** (for Claude and ChatGPT) and **API key** (for Claude Code, Cursor, and any MCP-compatible tool that supports custom headers).
</Note>

## Prerequisites

* A Pipecorn account with an [API key](/api-reference/API-key)
* Node.js — only required for Claude Code and Cursor

## Installation

### Claude

<Steps>
  <Step title="Open the Connectors panel">
    In the Claude sidebar, click **Customize**, then go to **Connectors**.
  </Step>

  <Step title="Add a custom connector">
    Click **+**, then **Add custom connector**.
  </Step>

  <Step title="Fill in the connector details">
    Set **Name** to `Pipecorn` and **URL** to `https://mcp.pipecorn.com/mcp`, then save.
  </Step>

  <Step title="Authenticate">
    Follow the OAuth flow to connect your Pipecorn account.
  </Step>
</Steps>

### ChatGPT

<Steps>
  <Step title="Enable developer mode">
    Go to **Settings → Apps → Advanced settings** and activate **Developer mode**.
  </Step>

  <Step title="Create a new app">
    Click **Create app**.
  </Step>

  <Step title="Fill in the app details">
    Set **Name** to `Pipecorn`, **MCP server URL** to `https://mcp.pipecorn.com/mcp`, and **Authentication** to `OAuth`, then save.
  </Step>

  <Step title="Authenticate">
    Follow the OAuth flow to connect your Pipecorn account.
  </Step>
</Steps>

### Claude Code

Run the following command in your terminal, replacing `YOUR-API-KEY` with your Pipecorn API key:

```bash theme={null}
claude mcp add pipecorn -e API_KEY=YOUR-API-KEY -- npx mcp-remote https://mcp.pipecorn.com/mcp --header "X-API-Key:\${API_KEY}"
```

## Available tools

Tools trigger actions on behalf of the user based on the goals and information already in the LLM's context.

### 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                                                                                         |

## Example prompts

Here are some examples of what you can ask your AI agent to do with the Pipecorn MCP server.

### People enrichment

> Find the workers at Pipecorn and find their phones and emails.

The agent uses `enrich_account` to find Pipecorn's LinkedIn ID, then `search_leads_in_company` to list employees, then `bulk_enrich_contacts` to retrieve their emails and phones.

### Targeted prospecting

> Find the \[job title] of \[industry] companies in Paris.

The agent uses `search_locations` to get the Paris location ID, then `search_accounts` to find \[industry] companies, then `search_leads_in_company` to find \[job title] at each company, then `bulk_enrich_contacts` to retrieve their emails and phones.

## Roadmap

The MCP server is updated regularly. Upcoming work:

* Additional tools for Signals and Lists
* CSV download support
* Custom UI cards
* Token-usage optimizations