Overview
The Lusha MCP Server brings enterprise-grade B2B contact and company data directly to your AI conversations. Built on Lusha's comprehensive database of business contacts and companies, this MCP server enables AI assistants to find, verify, and enrich prospect and company information through natural language interactions.
The Model Context Protocol (MCP) is an open standard that allows AI assistants to securely connect to external data sources and tools. By integrating the Lusha MCP Server with your AI assistant, you can access Lusha's powerful data enrichment capabilities directly within your workflow.
Key Features
Contact Data Enrichment - Access verified email addresses, phone numbers, and professional profiles for business contacts using email, LinkedIn URL, or name + company combinations.
Company Data Enrichment - Retrieve detailed company information including firmographics, employee counts, industry data, and business insights.
Bulk Processing - Enrich up to 100 contacts or companies in a single request for high-volume workflows and efficient data processing.
Natural Language Integration - Interact with Lusha's data through conversational AI without needing to write API calls or manage technical integrations.
Requirements
Before setting up the Lusha MCP Server, ensure you have:
Node.js 18 or higher installed on your system
A valid Lusha API key
An AI assistant that supports MCP (such as Claude Desktop or Cursor)
To obtain your API key, sign in to your Lusha account and visit the API section in your admin panel.
π‘ Note: Only admins/managers with API feature access can view and manage API keys.
Setup Instructions
Claude Desktop Integration
Locate Your 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, create it in the appropriate directory for your system.
Add the Lusha MCP Configuration
Add this entry to your
claude_desktop_config.json
file:{ "mcpServers": { "lusha": { "command": "npx", "args": ["@lusha-org/mcp"], "env": { "LUSHA_API_KEY": "your_lusha_api_key_here" } } } }
Replace
your_lusha_api_key_here
with your actual Lusha API key.Restart Claude Desktop
Close and reopen Claude Desktop to load the new configuration.
Cursor Integration
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 powerful data enrichment 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. |
Usage Examples
Here's how you can interact with the Lusha MCP Server through your AI assistant:
Single Contact Enrichment
"Can you get John Smith's email from Lusha? He works at Microsoft."
Bulk Contact Enrichment
"Enrich this list of email addresses with full contact details: john@company.com, sarah@startup.io, mike@enterprise.net"
Company Data Lookup
"Get company information for Lusha including employee count, industry, and location."
Bulk Company Enrichment
"Get company details for these domains: microsoft.com, salesforce.com, hubspot.com"
LinkedIn Profile Enrichment
"Find contact details for this LinkedIn profile: https://linkedin.com/in/johnsmith"
Credit Usage
Credits are consumed based on successful data matches:
Failed Lookups: No credits are charged for contacts or companies that cannot be found
You can monitor your credit usage through your Lusha dashboard or by using Lusha's Credit Usage API.
Best Practices
Provide Sufficient Information: For best results, provide as much identifying information as possible (email, LinkedIn URL, or full name + company).
Use Bulk Operations: When enriching multiple records, use bulk requests to improve efficiency and reduce processing time.
Monitor Credit Usage: Keep track of your credit consumption to ensure you stay within your plan limits.
Troubleshooting
Common Issues
"API Key Not Found" Error
Verify your API key is correctly set in the configuration file
Ensure you have API access enabled on your Lusha plan
Check that the API key hasn't expired or been regenerated
"No Results Found"
Try different identifier combinations (email, LinkedIn URL, name + company)
Verify the contact or company exists in Lusha's database
Check for typos in the provided information
"Rate Limit Exceeded"
Lusha API allows up to 50 requests per second
Space out your requests if processing large volumes
Consider using bulk operations to reduce the number of API calls
Additional Resources
NPM Package - Official package repository
Lusha API Documentation - Complete API reference
MCP Protocol Specification - Learn about Model Context Protocol
Data Compliance Guide - Privacy and security information