# 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


## Installation

**Requirements:**

- Node.js 18+
- Valid Lusha API key


### Quick Start

**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 Desktop**

Follow the official Model Context Protocol guide to set up Claude Desktop for MCP servers.

**Locating the Configuration File:** The `claude_desktop_config.json` file is located in different directories depending on your operating system:

- **macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`
- **Windows**: `%APPDATA%\Claude\claude_desktop_config.json`
- **Linux**: `~/.config/Claude/claude_desktop_config.json`


If the file doesn't exist, you'll need to create it in the appropriate directory for your system.

**Adding the Configuration:** Add this entry to your `claude_desktop_config.json` file:


```json
{
  "mcpServers": {
    "lusha": {
      "command": "npx",
      "args": ["@lusha-org/mcp"],
      "env": {
        "LUSHA_API_KEY": "your_lusha_api_key_here"
      }
    }
  }
}
```

**Cursor**

Cursor has built-in support for MCP servers:

- Go to Cursor > Settings > Cursor Settings > MCP
- Add a "Lusha" entry with this command: `npx @lusha/mcp`
- Set your API key in the environment variables section
- Optionally enable "Yolo mode" in Cursor settings to use tools without confirming (Cursor > Settings > Cursor Settings > Features > Chat > Enable Yolo mode)


## Available Tools

The Lusha MCP Server provides access to these API tools:

| Category | Tool | Description |
|  --- | --- | --- |
| **Contact Data** | `personBulkLookup` | Enrich contact information using email, LinkedIn URL, or name + company. Supports up to 100 contacts per request for efficient bulk processing. |
| **Company Data** | `companyBulkLookup` | Get comprehensive company data using domain or company name. Supports up to 100 companies per request. |


## Example Usage

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

- **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"


## Additional Resources

- [NPM Package](https://www.npmjs.com/package/@lusha-org/mcp) - Official package repository
- [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