Skip to content
Last updated

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.

Features

FeatureDescription
Contact Data EnrichmentAccess verified emails, phone numbers, and professional profiles for business contacts
Company Data EnrichmentRetrieve detailed firmographics, employee counts, and industry data
Bulk ProcessingEnrich up to 100 contacts or companies in a single request
ProspectingQuery Lusha's database by job title, seniority, location, and more

Requirements

  • A Lusha plan with sufficient credits
  • A valid Lusha API key

Get your API key: Sign in to your Lusha account and navigate to the API section in your admin panel.

Installation by Client

Claude (Web & Desktop)

The easiest, UI-first route. Works in Claude Web and Claude Desktop.

  1. Go to claude.ai/directory/connectors/lusha
  2. Click Add to Claude
  3. Complete authentication (OAuth)
  4. In any chat, open the tools menu to see the Lusha MCP tools

Try it: "Find 10 marketing managers at SaaS companies in New York and enrich the top 5."

Best for: Non-technical users, quick pilots, shared team setups.

ChatGPT

Access must be configured by account admins through Workspace Management.

Administrator Setup

  1. Click Settings in your ChatGPT workspace
  2. Click Manage Workspace > Apps & Connectors
  3. Click Create
  4. Toggle on Dev Mode
  5. Enter the following:
    • Name: Lusha MCP
    • URL: https://mcp.lusha.com
    • Add your API authentication details
  6. Click Create, then toggle the connector ON

User Setup (after admin enables the connector)

  1. Click Settings > Apps & Connectors
  2. Find Lusha Connector and click Enable

Once enabled, use natural language to access Lusha's data in your ChatGPT conversations.

VS Code (GitHub Copilot)

Use the Lusha MCP Server directly in VS Code via GitHub Copilot's MCP support (available in VS Code 1.99+).

Option A: Add via Settings UI

  1. Open the Command Palette (Cmd+Shift+P / Ctrl+Shift+P)
  2. Run MCP: Add Server
  3. Select HTTP as the server type
  4. Enter the URL: https://mcp.lusha.com
  5. Name the server lusha
  6. When prompted, add your Lusha API key as an authentication header

Option B: Add via settings.json

Open your VS Code settings.json and add the following under mcp.servers:

{
  "mcp": {
    "servers": {
      "lusha": {
        "type": "http",
        "url": "https://mcp.lusha.com",
        "headers": {
          "Authorization": "Bearer YOUR_LUSHA_API_KEY"
        }
      }
    }
  }
}

Replace YOUR_LUSHA_API_KEY with your actual API key.

Using Lusha in VS Code

  1. Open GitHub Copilot Chat (Ctrl+Alt+I / Cmd+Alt+I)
  2. Switch to Agent mode using the mode selector
  3. Click the Tools icon and enable the Lusha tools
  4. Ask naturally: "Find senior engineers at fintech companies in London"

Best for: Developers who want Lusha data without leaving their editor.

Cursor

Cursor supports MCP servers natively through its configuration file.

Setup

  1. Open (or create) your Cursor MCP config file:

    • macOS/Linux: ~/.cursor/mcp.json
    • Windows: %APPDATA%\Cursor\mcp.json

  2. Add the Lusha server configuration:

{
  "mcpServers": {
    "lusha": {
      "url": "https://mcp.lusha.com",
      "headers": {
        "Authorization": "Bearer YOUR_LUSHA_API_KEY"
      }
    }
  }
}
  1. Restart Cursor
  2. In Cursor Chat or Composer, the Lusha tools will be available automatically

Verify the connection

Open Cursor Chat and ask: "What Lusha tools are available?" - Cursor will list the active MCP tools.

Best for: Developers using Cursor as their primary AI-assisted editor.

n8n

Connect the Lusha MCP Server to your n8n workflows using the built-in MCP Client Tool node. This lets your AI agent workflows call Lusha tools - prospecting, enrichment, and more - as part of any automated sequence.

Requires: n8n version 1.88.0 or higher. The MCP Client Tool node is included by default in n8n Cloud and recent self-hosted installations.

Setup

  1. Open your n8n instance and create a new workflow (or open an existing AI agent workflow)
  2. Click Add node and search for MCP Client Tool
  3. Add the node to your canvas and open its settings
  4. In the SSE Endpoint field, enter:
    https://mcp.lusha.com/sse
  5. Under Authentication, select Header Auth
  6. Set the header name to Authorization and the value to:
    Bearer YOUR_LUSHA_API_KEY
    Replace YOUR_LUSHA_API_KEY with your actual key from the Lusha admin panel
  7. Under Tools to Use, select All Tools to expose the full Lusha toolset, or pick specific tools as needed
  8. Connect the MCP Client Tool node to your AI Agent node
  9. Activate the workflow

Using Lusha tools in your workflow

Once connected, your AI Agent node can call any Lusha tool as part of its reasoning. For example, you can prompt the agent:

  • "Find 5 VP-level contacts at fintech companies in the US and enrich their emails"
  • "Enrich this list of company domains with headcount and industry data"
  • "Search for marketing directors at SaaS companies with 100-500 employees"

The agent will automatically discover and invoke the appropriate Lusha tools during execution.

Verify the connection

After activating the workflow, run a test execution. Open the MCP Client Tool node output to confirm it lists the available Lusha tools. If tools are not appearing, double-check the SSE endpoint URL and that your API key is valid.

Best for: Teams building automated prospecting or enrichment pipelines, CRM sync workflows, or any multi-step AI agent sequence that needs live B2B data.

Available Tools

Recommended workflow: prospecting_search_guide → Filters (no credits) → Search → Enrich

CategoryToolDescription
Contact Datacontacts_searchEnrich contact info using email, LinkedIn URL, or name + company. Up to 100 contacts per request.
Company Datacompanies_searchGet company data using domain or company name. Up to 100 companies per request.
Prospecting - Guideprospecting_search_guideStart here. Returns step-by-step workflow guidance before using any other prospecting tools.
Prospecting - Companiesprospecting_company_filtersGet available filter options for company prospecting (no credits charged)
prospecting_company_searchSearch companies by firmographic/technographic filters
prospecting_company_enrichEnrich companies by ID for detailed data (may consume credits)
Prospecting - Contactsprospecting_contact_filtersGet available filter values for contact search (no credits charged)
prospecting_contact_searchSearch contacts using structured filters (company, location, department, seniority, etc.)
prospecting_contact_enrichEnrich contacts by ID to reveal emails and phones (consumes credits)

Billing, Limits & Compliance

  • Credits: Same as the Public API. Search is low-cost discovery; enrichment is charged per data point revealed (email, phone, etc.)
  • Rate limits: Same as the Public API
  • State-based restrictions: If your account has geographic restrictions, MCP returns compliant results - some fields may be null

Example Usage

Getting Started

Always start with the guide for prospecting workflows:

"How should I use Lusha for prospecting?" (This triggers prospecting_search_guide first)

Direct Lookups

Enrich a contact: "Can you get Yoni Tserruya's email from Lusha?"

Bulk enrich contacts: "Enrich this list of email addresses with full contact details."

Enrich a company: "Get company information for Lusha."

Bulk enrich companies: "Get company details for these domains: microsoft.com, salesforce.com, hubspot.com."

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"

Troubleshooting

IssueResolution
Tools not showing in ClaudeConfirm the connector is added and you have permission to use tools. Restart the app.
Tools not showing in VS CodeMake sure you're in Agent mode in Copilot Chat. Check that mcp.servers is correctly formatted in settings.json.
Tools not showing in CursorVerify mcp.json is in the correct path and properly formatted JSON. Restart Cursor fully.
Tools not showing in n8nConfirm the MCP Client Tool node is connected to your AI Agent node and the workflow is activated. Check that the SSE endpoint URL ends in /sse and the API key header is correctly formatted.
Partial or no results returnedCredits follow API rules - no charge on failed lookups. Check your remaining credits in the Lusha admin panel.
Auth errorsConfirm your API key is valid and correctly formatted in your config (no extra spaces or line breaks).

Security Tips

  • Store API keys in secure credentials (OS keychain, password manager, or your editor's secrets manager) - avoid hardcoding them in shared config files
  • In n8n, use the built-in Credentials system to store your API key rather than pasting it directly into node fields
  • Limit tool permissions to the minimum needed for your use case
  • Rotate API keys periodically and remove unused connectors
  • For team setups, use environment variables rather than committing keys to version control

Additional Resources

Previous page
 
Terms
Copyright © Lusha. All rights reserved.