Lusha
Connect Lusha to find people and companies, reveal work emails and phones, and spot job changes and buying signals. MCP setup guide for Claude and ChatGPT.
One Lusha API key, copied from API & connectors in your Lusha dashboard and pasted into PopMCP's API key field. Your Lusha email is optional and only used for tables.
- Setup time
- 1 min
- Auth
- API credentials
- API base URL
- https://api.lusha.com
- Rate limits
- Per key, by plan. Free and Starter: 40 a minute and 100 a day. Pro: 50 a minute, 150 an hour, 1,500 a day. Premium: 300 a minute, 1,800 an hour, 18,000 a day. Scale: 300 a minute, 5,000 an hour, 50,000 a day. The account usage call is limited to 5 a minute, and webhook calls to 100 a minute.
Before you begin
- A Lusha account on any plan, including Free, which has a key of its own and a smaller rate limit
- API access still on for you. An admin or manager can turn it off under Account Settings, Permissions
- Credits on the account, because searches and reveals spend them
Get your credentials
Sign in to Lusha
Sign in at dashboard.lusha.com with your own account. A key acts as the person who owns it, so use the login you want your AI to work as.
Copy your API key
Open API & connectors in the left sidebar and click Copy API key at the top right. Every user has a key already, so there is nothing to create.
API & connectors
Copy your key, or manage the keys on this account.
| Key | Owner | Monthly credit limit |
|---|---|---|
| 2f1e****4b3c | you@acme.com | No limit |
Admins and managers can generate more keys here and put a monthly credit limit on each one.
Paste the key into PopMCP
In PopMCP, open the Lusha connector and paste the value into API key. To use Lusha tables without being asked for your email, open More options and fill in Your Lusha email. Click Connect.
Connect in PopMCP
Open your workspace, choose Lusha in the marketplace, and fill in the connect dialog:
| Field | What to enter |
|---|---|
| API keysecret | In Lusha, open API & connectors, then click Copy API key.Encrypted with AES-256-GCM on save and never shown again. |
| Your Lusha emailtext | The email you sign in to Lusha with. Lusha asks for it when your AI works with tables. |
PopMCP verifies the credential against Lusha immediately. On success the connection flips to Verified and its MCP tools are provisioned.
Verify it worked
PopMCP marks the Lusha connector Connected, shows your plan and how many credits you have left. Checking the balance is free. Try asking your AI how many Lusha credits are left.
Troubleshooting
Lusha did not accept this API key
Why: The key was not copied whole, or it was regenerated after you copied it. A malformed key is answered with 400 Invalid API key format.
Fix: Click Copy API key again in API & connectors and paste it without extra text.
Lusha knows this key but will not let it in
Why: The account is inactive, or an admin or manager turned off your API access, which suspends your key.
Fix: Ask an admin to turn your access back on under Account Settings, Permissions. The same key starts working again.
Lusha allows this check 5 times a minute
Why: The usage call PopMCP connects with is limited to 5 calls a minute.
Fix: Wait a minute and click Connect again.
402 on a search or a reveal
Why: The account is out of credits, or the key or user has reached a monthly credit limit.
Fix: Check the balance in Lusha, then add credits or ask an admin to raise the limit.
429 Too Many Requests
Why: Your plan's rate limit was reached. Free and Starter allow 40 requests a minute and 100 a day.
Fix: Wait and try again. If the daily limit is used up, it resets the next day, or a higher plan raises it.
403 on recommendations only
Why: The connected key is account-wide. Lusha gives recommendations only to a key owned by a team member.
Fix: Reconnect with a key you generated for yourself.
A table tool asks for ownerEmail
Why: Lusha requires the email of a user on the account on every table call, and none was given at connect.
Fix: Reconnect and fill in Your Lusha email under More options, or tell your AI which email to use.
Website visitors answers 400
Why: One of the domains is not set up for tracking in Lusha, which fails the whole request, or the date range is longer than 3 months.
Fix: Set the domain up for tracking in the Lusha dashboard and keep the range to 3 months or less.