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

# MCP tools reference

> Every tool the Lusha MCP server exposes, grouped by category.

The Lusha MCP server exposes 22 tools. Most map closely to the underlying Lusha API, so the same plan, credit, and rate-limit rules that apply to the REST API apply to MCP tool calls - see the [API FAQ](/faq/api) and [credits FAQ](/faq/billing).

<Note>
  Available tools may vary depending on the client used to connect. Tool names and behavior can also change as Lusha ships new capabilities - ask your MCP client to list its available Lusha tools for the exact, current set.
</Note>

<AccordionGroup>
  <Accordion title="Known contacts and companies (2)">
    | Tool               | What it does                                                      |
    | ------------------ | ----------------------------------------------------------------- |
    | `contacts_search`  | Enrich contact data using email, LinkedIn URL, or name + company. |
    | `companies_search` | Retrieve company data using domain or company name.               |
  </Accordion>

  <Accordion title="Prospecting (6)">
    | Tool                          | What it does                                                              |
    | ----------------------------- | ------------------------------------------------------------------------- |
    | `prospecting_contact_filters` | Get available filter values for contact prospecting (no credits charged). |
    | `prospecting_contact_search`  | Search contacts by job title, seniority, location, department, and more.  |
    | `prospecting_contact_enrich`  | Enrich contacts by ID to reveal emails and phones (credits consumed).     |
    | `prospecting_company_filters` | Get available filter values for company prospecting (no credits charged). |
    | `prospecting_company_search`  | Search companies by firmographic and technographic filters.               |
    | `prospecting_company_enrich`  | Enrich companies by ID for detailed firmographic data.                    |
  </Accordion>

  <Accordion title="Lookalikes (2)">
    | Tool                  | What it does                              |
    | --------------------- | ----------------------------------------- |
    | `lookalike_contacts`  | Find contacts similar to a seed contact.  |
    | `lookalike_companies` | Find companies similar to a seed company. |
  </Accordion>

  <Accordion title="Signals (6)">
    | Tool                       | What it does                                                          |
    | -------------------------- | --------------------------------------------------------------------- |
    | `signals_contact_filters`  | Get available filter values for contact signals (no credits charged). |
    | `signals_contacts_search`  | Resolve contacts and return recent activity signals.                  |
    | `signals_contacts_get`     | Get signals for known contacts by ID.                                 |
    | `signals_company_filters`  | Get available filter values for company signals (no credits charged). |
    | `signals_companies_search` | Resolve companies and return recent activity signals.                 |
    | `signals_companies_get`    | Get signals for known companies by ID.                                |
  </Accordion>

  <Accordion title="Recommendations (5)">
    | Tool                                | What it does                                                                               |
    | ----------------------------------- | ------------------------------------------------------------------------------------------ |
    | `recommendations_contacts_get`      | Get paginated, scored contact recommendations with signals and Target Profile attribution. |
    | `recommendations_companies_get`     | Get paginated, scored company recommendations with signals and Target Profile attribution. |
    | `recommendations_status_get`        | Check whether a user's recommendations are `none`, `computing`, or `done`.                 |
    | `recommendations_contacts_filters`  | Get valid signal types and Target Profiles for filtering contact recommendations.          |
    | `recommendations_companies_filters` | Get valid signal types and Target Profiles for filtering company recommendations.          |

    <Note>
      Results are drawn from the authenticated user's own Target Profiles (plus any shared account-level profiles) - user and account IDs are inferred from the session, never passed as inputs. If you haven't set up a Target Profile in ICP Hub yet, you'll be nudged to do so with each recommendations request. Recommendations refresh daily and recalculate within minutes of an ICP change.
    </Note>
  </Accordion>

  <Accordion title="Account (1)">
    | Tool            | What it does                                            |
    | --------------- | ------------------------------------------------------- |
    | `account_usage` | Check credit balance, rate-limit status, and plan info. |
  </Accordion>
</AccordionGroup>

## Credits and rate limits

* Lookup and search tools generally consume credits only for successful, matched results - failed lookups are not charged.
* Filter-discovery tools (`*_filters`) and `account_usage` don't consume credits.
* Rate limits follow your Lusha plan, the same as the REST API. `account_usage` returns your current limits and remaining headroom.