Skip to main content

Lusha Model Context Protocol (MCP) Server

Marine Melamed avatar
Written by Marine Melamed
Updated this week

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

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

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

  3. Restart Claude Desktop

    Close and reopen Claude Desktop to load the new configuration.

Cursor Integration

Cursor has built-in support for MCP servers:

  1. Go to Cursor > Settings > Cursor Settings > MCP

  2. Add a "Lusha" entry with this command: npx @lusha/mcp

  3. Set your API key in the environment variables section

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

Did this answer your question?