# Lusha MCP Server

The **Lusha MCP Server** brings enterprise-grade B2B contact and company data directly to your AI conversations. Built on Lusha's comprehensive database of 100+ million business contacts and 60+ million companies, this MCP server enables AI assistants to find, verify, and enrich prospect information through natural language interactions.

## Features

- **Contact Data Enrichment** - Access verified email addresses, phone numbers, and professional profiles for business contacts
- **Company Data Enrichment** - Retrieve detailed company information including firmographics, employee counts, and industry data
- **Bulk Processing** - Enrich up to 100 contacts or companies in a single request for high-volume workflows
- **Prospecting Contacts & Companies** - Query Lusha's extensive database based on specific criteria (such as job title, seniority, location, and more) to retrieve detailed contact and company information.


## Installation

**Requirements:**

- A plan with sufficient credits
- Valid Lusha API key


**Set Up Your API Key**:
To obtain an API key, sign in to your Lusha account and visit the API section in your admin panel.

### Integration with AI clients

#### **Claude Remote MCP Setup**

This is the easiest, UI‑first route and works in **Claude Web** and **Claude Desktop**.

1. Open **Claude** → **Settings** → **Connectors**.
2. Click **Add custom connector**.
3. Paste your **Lusha Remote MCP URL: (https://mcp.lusha.com).**
4. Complete authentication (OAuth as configured).
5. In any chat, use the tools menu to see the **Lusha MCP tools**.
6. Try: *"Find 10 marketing managers at SaaS companies in New York and enrich the top 5."*


**Good for:** non‑technical users, quick pilots, shared team setups.

## Available Tools

The Lusha MCP Server provides access to these API tools:

| Category | Tool | Description |
|  --- | --- | --- |
| **Contact Data** | *contacts_search* | Enrich contact information using email, LinkedIn URL, or name + company. Supports up to 100 contacts per request for efficient bulk processing. |
| **Company Data** | *companies_search* | Get comprehensive company data using domain or company name. Supports up to 100 companies per request. |
| **Prospecting - Companies** | *prospecting_company_filters* | Get available filter options for company prospecting (no credits charged) |
|  | *prospecting_company_search* | Search companies by firmographic/technographic filters (domains, technologies, intent topics, sizes, revenues, SIC/NAICS codes) |
|  | *prospecting_company_enrich* | Enrich companies by IDs for detailed firmographic and technographic data (may consume credits) |
| **Prospecting - Contacts** | *prospecting_contact_filters* | Get available filter values for contact search |
|  | *prospecting_contact_search* | Search for contacts using structured filters (company, location, department, seniority, etc.) |
|  | *prospecting_contact_enrich* | Enrich contacts by IDs to reveal emails/phones (consumes credits) |


> Tip: Use *Filters* first to preview valid values (no credits), then *Search*, then *Enrich*.


**Billing, limits & compliance**

* **Credits**: Same as Public API. Search is low‑cost discovery; **enrichment** charges by data revealed (e.g., email, phone).
* **Rate limits**: Same as Public API.
* **Restricted states**: If your account has state‑based restrictions, MCP returns compliant results (fields may be null).


**Troubleshooting**

* *''I don't see the tools in Claude''*: Confirm connector is added and you have permission to use tools. Restart the app.
* **Credits**: If a call returns partial or no results, charges follow API rules (no charge on failed lookups).


**Security tips**

* Store API keys in **secure credentials** (Claude/OS keychain, n8n credentials).
* Limit tool permissions in Claude Connectors to the minimum needed.
* Rotate keys periodically and remove unused connectors.


## Example Usage

Here's how you might interact with the Lusha MCP Server through an AI assistant:

### Direct Lookups

**Enrich Contact Data:** "Can you get Yoni Tserruya's email from Lusha?"

**Enrich Contacts in Bulk:** "Enrich this list of email addresses with full contact details."

**Enrich Company Data:** "Get company information for Lusha"

**Enrich Companies in Bulk:** "Get company details for these domains: microsoft.com, salesforce.com, hubspot.com"

### Quick prompts to try

* *"Find 15 senior directors of IT at 200–1,000 employee SaaS companies in the UK. Enrich the top 5 with work email and mobile if available using Lusha"*
* *"Use Lusha to bulk enrich these domains: microsoft.com, salesforce.com, monday.com."*
* *"What filters can I use for contact search by department and seniority using Lusha?"*


### Prospecting Workflows

**Search for Contacts:**

- "Find 10 contacts in Boston working in technology companies"
- "Search for senior directors in IT at companies with 500+ employees"
- "Get marketing managers at SaaS companies in New York"


**Search for Companies:**

- "Find tech companies in California with 50-200 employees"
- "Search for companies using React with revenue over $10M"
- "Get fintech companies that received funding in the last year"


**Filter Discovery:**

- "What departments can I filter by in Lusha?"
- "Show me available seniority levels for contact search"
- "What industry categories are available for company search?"


**Enrichment After Search:**

- "Get the email and phone for the first 5 contacts from that search"
- "Enrich those companies with full details including funding and revenue"
- "Get mobile numbers for contacts who have them available"


## Additional Resources

- [Lusha API Documentation](https://docs.lusha.com/) - Complete API reference
- [MCP Protocol Specification](https://spec.modelcontextprotocol.io/) - Learn about Model Context Protocol
- [Data Compliance Guide](https://www.lusha.com/privacy/) - Privacy and security information