Lusha MCP server for your AI

Find the right people at a target account, reveal their details only when you say so, see who changed jobs or which accounts are hiring, and save the results to a Lusha table.

PopMCPLusha

How many Lusha credits do I have left, and when do they renew?

Contact sales Connect

Supported Lusha tools

Every endpoint of Lusha's current API is here, from search, enrichment and prospecting to signals, Target Profile scores, website visitors, tables, webhooks and call transcripts. Searches come back as previews first, so you choose whose contact details to pay for.

77 tools in the full catalog: 54 read and 23 write. 35 load by default, and the rest are found with tool search.

lusha_add_contacts_table_rows

Add Entities to Contacts Table.

lusha_create_contacts_table

Create Contacts Table.

lusha_list_contacts_tables

List Contacts Tables.

lusha_get_company_signals

Company events for up to 100 Lusha company ids: headcount, hiring surges, funding and other news, website traffic, IT spend, intent.

lusha_get_contact_signals

Job changes and promotions for up to 100 Lusha contact ids.

lusha_list_company_signal_types

Get Company Signal Types.

lusha_list_contact_signal_types

Get Contact Signal Types.

lusha_score_company_signals

Score Companies by Signal Activity.

lusha_enrich_prospects

Find new people by plain filters and reveal their emails and phones in one go.

lusha_find_companies

Find new companies by plain filters: countries, size, technologies and keywords.

lusha_find_prospects

Find new people by plain filters: job titles, seniority, departments, countries, company domains and company size.

lusha_prospect_companies

Find new companies matching a target profile: location, size, revenue, industry, technology, intent.

lusha_prospect_contacts

Find new people matching a target profile: job title, seniority, department, location, and company size, industry, technology.

lusha_find_company

Find one company by domain, name or Lusha id.

lusha_find_contact

Find one person by email, LinkedIn URL, Lusha id, or first and last name with a company.

lusha_list_company_filter_values

Get Company Filter Values.

lusha_list_company_filters

Get Company Filter Types (Discovery).

lusha_list_contact_filter_values

Get Contact Filter Values.

lusha_list_contact_filters

Get Contact Filter Types (Discovery).

lusha_search_companies

Look up companies you can name, by domain, name or Lusha id, up to 100 at once.

lusha_search_contacts

Look up people you can name, by email, LinkedIn URL, or name plus company, up to 100 at once.

lusha_enrich_companies

Full company data (industry, size, revenue, funding, technologies) for up to 100 Lusha company ids.

lusha_enrich_contacts

Reveal emails and phones for up to 100 Lusha contact ids from lusha_search_contacts, lusha_prospect_contacts, lusha_find_contact_lookalikes or lusha_find_buying_group.

lusha_get_contacts_enrich_job

Fetch the rest of an enrichment that came back with a job.

lusha_list_target_profiles

List your Target Profiles (ICPs), with the ids that lusha_score_contact_icp_fit and lusha_score_company_icp_fit need.

lusha_score_company_icp_fit

Score Companies by ICP Fit.

lusha_find_company_lookalikes

Find companies similar to ones you already know.

lusha_find_contact_lookalikes

Find people similar to ones you already know.

lusha_get_conversation_transcript

Get Conversation Transcript.

lusha_search_and_enrich_companies

Look up companies you can name and get full company data in one call, up to 100 at once.

lusha_search_and_enrich_contacts

Look up people you can name and reveal their emails and phones in one call, up to 100 at once.

lusha_search_conversations

Search Conversations.

lusha_find_buying_group

Map who buys at up to 25 companies: decision makers, potential champions and end users.

lusha_get_account_usage

Credits used and left, rate limits, plan and renewal dates, and what each action costs.

lusha_list_website_visitors

Get Website Visitors.

lusha_add_companies_table_columns

Add Columns to Companies Table.

lusha_add_companies_table_rows

Add Entities to Companies Table.

lusha_add_contacts_table_columns

Add Columns to Contacts Table.

lusha_create_companies_table

Create Companies Table.

lusha_delete_companies_table

Delete Companies Table.

lusha_delete_contacts_table

Delete Contacts Table.

lusha_get_companies_table

Get Companies Table.

lusha_get_contacts_table

Get Contacts Table.

lusha_list_companies_column_catalog

Get Companies Column Catalog.

lusha_list_companies_table_columns

List Companies Table Columns.

lusha_list_companies_table_rows

Read the rows of a company table.

lusha_list_companies_tables

List Companies Tables.

lusha_list_contacts_column_catalog

Get Contacts Column Catalog.

lusha_list_contacts_table_columns

List Contacts Table Columns.

lusha_list_contacts_table_rows

Read the rows of a contact table.

lusha_remove_companies_table_column

Remove Column from Companies Table.

lusha_remove_companies_table_rows

Remove Entities from Companies Table.

lusha_remove_contacts_table_column

Remove Column from Contacts Table.

lusha_remove_contacts_table_rows

Remove Entities from Contacts Table.

lusha_run_companies_table_column

Run Column on Companies Table.

lusha_run_contacts_table_column

Run Column on Contacts Table.

lusha_update_companies_table

Update Companies Table.

lusha_update_contacts_table

Update Contacts Table.

lusha_create_opt_out_subscription

Be notified when a contact opts out of data processing, for one webhook URL.

lusha_create_webhook_subscriptions

Create Subscription.

lusha_delete_webhook_subscriptions

Delete Subscriptions.

lusha_get_webhook_delivery_stats

Get Audit Log Statistics.

lusha_get_webhook_secret

Show the account's webhook signing secret, used to check that a delivery came from Lusha.

lusha_get_webhook_subscription

Get Subscription by ID.

lusha_list_webhook_delivery_logs

Get Audit Logs.

lusha_list_webhook_subscriptions

List Subscriptions.

lusha_rotate_webhook_secret

Replace the account's webhook signing secret.

lusha_test_webhook_subscription

Test Subscription.

lusha_update_webhook_subscription

Update Subscription.

lusha_list_company_signal_filter_values

Get Company Signal Filter Values.

lusha_list_company_signal_filters

Get Company Signal Filters (Discovery).

lusha_score_contact_signals

Score Contacts by Signal Activity.

lusha_list_company_recommendation_filters

Company Recommendation Filters.

lusha_list_company_recommendations

Your ranked queue of recommended companies from your Target Profiles.

lusha_list_contact_recommendation_filters

Contact Recommendation Filters.

lusha_list_contact_recommendations

Your ranked queue of recommended people from your Target Profiles.

lusha_score_contact_icp_fit

Score Contacts by ICP Fit.

Connect Lusha to Claude, ChatGPT and Claude Code

Credentials off one Lusha screen, then an endpoint your client signs into. Nothing to deploy, and nothing to install.

In Lusha, open API & connectors and click Copy API key. Paste it here. Every plan has a key, including Free, and there is no app to register and nothing to approve. Add the email you sign in with if you want your AI to use Lusha tables without asking for it.

API key••••••••••••3f7a

Your Lusha emailyou@company.com

ConnectionVerified

Drop the PopMCP URL into Claude, ChatGPT, Claude Code, Codex or any other supported client. It signs in through PopMCP with OAuth, so your Lusha credential never leaves the server.

app.popmcp.com/mcp

Claude wants to connectApprove

Ask for something harmless before the agent changes anything. Writes run as soon as it calls them, so confirm it reads the right account first.

How many Lusha credits do I have left, and when do they renew?

lusha_get_account_usageok

Then just ask for the work

“How many Lusha credits do I have left, and when do they renew?”
- get_account_usage
“Find VPs of Sales at US software companies and show me who they are before revealing anything”
- list_contact_filter_values
- prospect_contacts
“Get the work email for Ana Diaz at acme.com”
- search_contacts
- enrich_contacts
“Who is on the buying committee at acme.com, and who is the decision maker?”
- find_buying_group
“Which of these accounts raised money or started hiring fast this quarter?”
- search_companies
- get_company_signals
“Find companies like our best customer and score them against our Target Profile”
- find_company_lookalikes
- list_target_profiles
- score_company_icp_fit

Contact support View docs

Use Lusha from the assistant you already open

One hosted endpoint, registered once per client. The same tools and the same permissions, whichever window the request comes from.

Claude DesktopCustom connector

Add the PopMCP URL under Customize → Connectors and the tools appear in every chat.

Claude WebCustom connector

The same endpoint, registered in the browser. Nothing to install on the machine you are working from.

ChatGPTCustom connector

CodexDesktop & CLI

Wire the endpoint into Codex or the Codex CLI when a task needs live business context, not a fixture.

OpenCodeCoding agent

ZCodeDesktop app

Add PopMCP as an MCP server in Z.ai's desktop app and work the account from the same window.

Contact support View docs

FAQ

Lusha MCP server questions

What teams ask before putting Lusha behind an AI client.

Do I need an OAuth app or a developer account?

No. The form asks for one thing, your Lusha API key. In Lusha, open API & connectors and click Copy API key. Every user has a key on every plan, including Free. An admin or manager can turn a person's API access off under Account Settings, Permissions.

Does the AI spend my Lusha credits?

Yes. Searches, reveals, signals and reading table rows all draw on your account's credits, the same pool the Lusha dashboard uses. lusha_get_account_usage is free and shows what is left and what each action costs. Answers also report how many requests you have left on your plan's rate limit.

Will it pull emails and phones for a big list by accident?

Searches and prospecting answer previews with no emails or phones, so a reveal is always a separate step on people the AI has named. lusha_enrich_prospects does both in one go, but it needs a number from you, at most 25. Reveals are limited to 100 people a call, which is Lusha's own limit.

What does a read-only connection allow?

All searches, reveals, signals and scores still work, and they still spend credits, because reading is what Lusha is for. Read-only blocks creating or changing tables and webhooks, hides the webhook signing secret, and refuses a search that would also save its results to a table.

Why does the AI ask for my email when it uses tables?

Lusha requires the email of a user on the account on every table call made with an API key, and it cannot look up who a key belongs to. Add Your Lusha email under More options when you connect, and the AI never has to ask.

Why do recommendations answer with a permission error?

Lusha gives recommendations only to a key owned by a team member, and an account-wide key gets a 403. Reconnect with a key you generated for yourself. Recommendations also need at least one Target Profile in the ICP Hub.

Is this Lusha's own MCP server?

No. PopMCP talks to Lusha's API directly with your key, so it also covers webhooks, which Lusha's MCP server does not list. CRM export is the other way round: Lusha offers it only through its own MCP server, not its API, so it is not available here.

Do I have to run or host the Lusha MCP server myself?

No. PopMCP hosts it and gives you a Streamable HTTP MCP URL. There is nothing to deploy, no callback URL to register, and no infrastructure to keep running or patch.

Which AI clients can use this MCP server?

Any client that supports a remote Streamable HTTP MCP server: Claude Desktop, Claude Web, Claude Code, ChatGPT custom connectors, Codex and the Codex CLI, OpenCode and Z.ai's ZCode, as well as editors such as Cursor, Windsurf and Zed. Your client signs in to PopMCP with OAuth; the provider credential never leaves the server.

How do I connect Lusha to Claude Code?

Connect Lusha in PopMCP first, then run claude mcp add --transport http popmcp https://app.popmcp.com/mcp in a terminal. Inside Claude Code, run /mcp and sign in to PopMCP in the browser window it opens, ticking Lusha on the consent screen. The Lusha tools are then available in that session, and no Lusha credential is stored on your machine.

Why do only 35 of the 77 tools load by default?

Loading 77 tool definitions into every conversation burns context before the work starts. PopMCP loads a curated 35-tool set covering the everyday workflows and keeps the rest searchable, so your AI pulls a specialist tool only when a task needs it. Every tool stays searchable, and on Scale the owner can load the full catalog for a teammate's connection.

What is the difference between a tool and a trigger?

A tool is something your AI calls, and there are 77 here. A trigger is something PopMCP watches for you: 3 Lusha events that can start work on the PopMCP side. Triggers never enter your AI client's context, and none of them ask you to paste a callback URL into Lusha.

Connect Lusha to your AI in minutes

Launch a hosted MCP endpoint for Lusha, keep tool access under control, and start testing real workflow prompts right away.

Connect your first MCP