--- title: "Lusha MCP server for AI agents - actionlake" description: "Give Claude 72 Lusha actions through one MCP server: companies, contacts, company tables. Your agent never holds the credential. 100,000 calls a month free." canonical: https://actionlake.com/connectors/lusha updated: 2026-10-23 --- Connectors · CRM & sales # Lusha MCP server for AI agents. actionlake is an MCP gateway: one remote MCP server that connects Claude and other MCP clients to Lusha and the rest of your systems. It gives your agent 72 Lusha actions (50 reads, 15 writes and 7 that wait for a confirmation) and holds the Lusha credential itself, so the agent never does. It paces Lusha's limits and records every call. [Connect Lusha free](https://actionlake.com/console?start=sandbox) [See pricing](https://actionlake.com/pricing) 100,000 free calls a month. No card, no email, no password: press Start a free sandbox on the next screen and keep the key it shows you. `claude mcp add --transport http actionlake https://connect.actionlake.com/mcp` the first call ``` do { action: "lusha.audit_logs.list", intent: "check which Lusha account is connected" } # Get Audit Logs · read · 1 upstream call ``` - 72 actions in one signed file - 50 read look, never change - 15 write create and update - 7 wait for a yes destructive, confirmed first Set up ## Connect Lusha in three steps. 1. 01 ### Add actionlake to Claude. Run the command once in Claude Code; its consent page can create a free sandbox: 100,000 calls a month, no card. In the Claude app, add a custom connector with the URL below and paste your key on the consent page. Creating a new sandbox from the Claude app is not yet tested by us. `https://connect.actionlake.com/mcp` 2. 02 ### Connect Lusha. API key. No consent screen: your agent can connect it for you, but the key then passes through your chat. To keep it out of the model's context, paste it in the console instead. actionlake stores what you paste write-only, sealed under your tenant's key. - `api_key` Lusha API key from the API dashboard (dashboard.lusha.com/api/manage-api-keys; admins and managers with API access) ``` account { op: "connections.requirements", service: "lusha" } # free: exactly what to paste, and what is found for you ``` 3. 03 ### Make the first call. Check before a write. Ask in plain words; Claude picks the action. Before anything changes, `check` validates the call and prices it, for free. ``` do { action: "lusha.audit_logs.list" } # get audit logs · read · 1 upstream call check { action: "lusha.subscriptions.test", input: { … } } # free: inputs, permissions, cost and confirmations, nothing sent ``` Lusha at a glance **Sign-in** API key. No consent screen: your agent can connect it for you, but the key then passes through your chat. To keep it out of the model's context, paste it in the console instead. **You provide** `api_key` **Limits we pace to** 25 calls a second, per connection **API covered** Lusha API v3 (OpenAPI 3.0.3)`api.lusha.com` **Built from** Lusha's documentation, read 23 October 2026[docs.lusha.com](https://docs.lusha.com/openapi.json) [docs.lusha.com](https://docs.lusha.com/authentication) **Service file** Version 1.0.0, signed (Ed25519) **Cached reads** 49 of 50 reads, for up to 5 minutes; a write clears what it affects **Shared entities** 2, so ask can line Lusha up with your other systems **Data** Processed and stored in Sydney, Australia. No US region yet Capabilities ## What an AI agent can do in Lusha. 72 actions in 17 areas. Every one carries its effect, so a key can allow the reads and hold the rest. - **50** read look, never change - **15** write create and update - **7** destructive wait for a confirmation 1. ### Companies 15 15 read · 0 write · 0 destructive Search and Enrich Companies · Enrich Companies · Score Companies by ICP Fit · Company Lookalikes 2. ### Contacts 14 14 read · 0 write · 0 destructive Search and Enrich Contacts · Get Buying Group Contacts · Enrich Contacts · Score Contacts by ICP Fit 3. ### Company tables 6 3 read · 2 write · 1 destructive List Companies Tables · Get Companies Column Catalog · Get Companies Table · Create Companies Table 4. ### Contact tables 6 3 read · 2 write · 1 destructive List Contacts Tables · Get Contacts Column Catalog · Get Contacts Table · Create Contacts Table 5. ### Subscriptions 6 2 read · 3 write · 1 destructive List Subscriptions · Get Subscription by ID · Create Subscription · Test Subscription 6. ### Company table columns 4 1 read · 2 write · 1 destructive List Companies Table Columns · Add Columns to Companies Table · Run Column on Companies Table · Remove Column from Companies Table 7. ### Contact table columns 4 1 read · 2 write · 1 destructive List Contacts Table Columns · Add Columns to Contacts Table · Run Column on Contacts Table · Remove Column from Contacts Table 8. ### Company table entities 3 1 read · 1 write · 1 destructive Get Companies Table Entities · Add Entities to Companies Table · Remove Entities from Companies Table **9 more areas · 14 actions** - Contact table entities **3** - Account secret **2** - Audit logs **2** - Conversations **2** - Account **1** - Contact enrich jobs **1** - Icp profiles **1** - Opt out subscriptions **1** - Website visits **1** Top actions ## The Lusha API, shaped for agents. The ids your agent types, what each does, and the one name it shares with other systems. | Action | What it does | Effect | Same name in | | --- | --- | --- | --- | | `lusha.contacts.search_and_enrich` Search and Enrich Contacts | Find contacts and reveal their full data in a single call. | read | this connector | | `lusha.companies.search_and_enrich` Search and Enrich Companies | Find companies and reveal their full data in a single call. | read | this connector | | `lusha.audit_logs.list` Get Audit Logs | Retrieve webhook delivery logs for your account. | read | this connector | | `lusha.contacts.enrich` Enrich Contacts | Reveal full contact data for contacts you've already found via Search Contacts. | read | this connector | | `lusha.companies.enrich` Enrich Companies | Reveal full company data for companies you've already found via Search Companies. | read | this connector | | `lusha.icp_profiles.list` List Target Profiles | Returns the Target Profiles (ICPs) you can see: your own, plus any an admin has shared with the account. | read | this connector | | `lusha.subscriptions.list` List Subscriptions | Returns all webhook subscriptions for your account with pagination support. | read | this connector | | `lusha.company_tables.list` List Companies Tables | List companies tables owned by the given user, plus any tables shared with the account. | read | this connector | | `lusha.subscriptions.test` Test Subscription | Test a webhook subscription by sending a test signal. | write | this connector | | `lusha.subscriptions.create` Create Subscription | Creates one or more webhook subscriptions for real-time signal notifications. | write | this connector | | `lusha.company_tables.create` Create Companies Table | Create a new, empty companies table, optionally seeded with an initial list of company IDs. | write | this connector | | `lusha.subscriptions.delete` Delete Subscriptions | Delete one or more webhook subscriptions. | destructive | this connector | Try it ## Prompts to paste into Claude. Each one names the Lusha actions it will call, so you know what it reads and what it changes before you send it. 1. Read read Find the Lusha contacts with no email address, so we can clean them up. calls `lusha.contacts.search_and_enrich` 2. Write write Test Subscription in Lusha. Show me exactly what you will send before you save it. calls `lusha.subscriptions.test` Governance for Lusha ## Destructive actions wait for a yes. 7 Lusha actions are destructive. These are all of them: - Delete Subscriptions `lusha.subscriptions.delete` - Delete Companies Table `lusha.company_tables.delete` - Delete Contacts Table `lusha.contact_tables.delete` - Remove Column from Companies Table `lusha.company_table_columns.remove` - Remove Column from Contacts Table `lusha.contact_table_columns.remove` - Remove Entities from Companies Table `lusha.company_table_entities.remove` - Remove Entities from Contacts Table `lusha.contact_table_entities.remove` A destructive action runs only with `confirm: true`. Under the `human` policy the agent cannot confirm for itself: the run stops until a named person approves, in the console or from a signed link in an email. The cap on a key is refused before the call is sent, never after. do lusha.subscriptions.delete confirm_policy: **human** Delete Subscriptions? **intent:** the user asked me to delete Subscriptions run suspended · waiting for a named person · key _lusha-agent_ cannot confirm itself In the console, or from an emailed signed link. a key for this connector ``` account { op: "keys.create", name: "lusha-agent", allowed_actions: ["lusha.*"], cap_calls: 2000, confirm_policy: "human_for_writes", approval_rules: [ { match: "lusha.subscriptions.delete", approver: "lead@example.com" }, { match: "lusha.company_tables.delete", approver: "lead@example.com" }, { match: "lusha.contact_tables.delete", approver: "lead@example.com" } ] } ``` Illustrative. Scoped to Lusha only, capped at 2,000 upstream calls, every write confirmed, and the destructive ones approved by a named person. Cost ## What Lusha costs on actionlake. Every Lusha action is one upstream call, the only thing actionlake bills. Searching, `check`, `cost`, `account` and any call Lusha refused with 401, 403, 429 or a 5xx are free. Paid plans start at US$49 a month for 250,000 calls, with overage from US$0.30 down to US$0.18 per 1,000. - 1 upstream call per action all 72 Lusha actions - 72 actions page each page of a long list is one call - 49 reads can be cached a cache hit costs nothing - 100,000 calls a month, free paid plans from US$49 a month for 250,000 [See pricing](https://actionlake.com/pricing) Action index ## Every Lusha action. 72 actions by area: the id your agent calls, what it does, and its effect. **Companies 15** - `lusha.companies.enrich` Enrich Companies read - `lusha.companies.icp_fit_scores` Score Companies by ICP Fit read - `lusha.companies.lookalikes` Company Lookalikes read - `lusha.companies.prospect` Prospecting Companies read - `lusha.companies.prospecting_filter_values` Get Company Filter Values read - `lusha.companies.prospecting_filters` Get Company Filter Types (Discovery) read - `lusha.companies.recommendation_filters` Company Recommendation Filters read - `lusha.companies.recommendations` Company Recommendations read - `lusha.companies.search` Search Companies read - `lusha.companies.search_and_enrich` Search and Enrich Companies read - `lusha.companies.signal_filter_values` Get Company Signal Filter Values read - `lusha.companies.signal_filters` Get Company Signal Filters (Discovery) read - `lusha.companies.signal_scores` Score Companies by Signal Activity read - `lusha.companies.signal_types` Get Company Signal Types read - `lusha.companies.signals` Company Signals read **Contacts 14** - `lusha.contacts.buying_group` Get Buying Group Contacts read - `lusha.contacts.enrich` Enrich Contacts read - `lusha.contacts.icp_fit_scores` Score Contacts by ICP Fit read - `lusha.contacts.lookalikes` Contact Lookalikes read - `lusha.contacts.prospect` Prospecting Contacts read - `lusha.contacts.prospecting_filter_values` Get Contact Filter Values read - `lusha.contacts.prospecting_filters` Get Contact Filter Types (Discovery) read - `lusha.contacts.recommendation_filters` Contact Recommendation Filters read - `lusha.contacts.recommendations` Contact Recommendations read - `lusha.contacts.search` Search Contacts read - `lusha.contacts.search_and_enrich` Search and Enrich Contacts read - `lusha.contacts.signal_scores` Score Contacts by Signal Activity read - `lusha.contacts.signal_types` Get Contact Signal Types read - `lusha.contacts.signals` Contact Signals read **Company tables 6** - `lusha.company_tables.column_catalog` Get Companies Column Catalog read - `lusha.company_tables.create` Create Companies Table write - `lusha.company_tables.delete` Delete Companies Table destructive - `lusha.company_tables.get` Get Companies Table read - `lusha.company_tables.list` List Companies Tables read - `lusha.company_tables.update` Update Companies Table write **Contact tables 6** - `lusha.contact_tables.column_catalog` Get Contacts Column Catalog read - `lusha.contact_tables.create` Create Contacts Table write - `lusha.contact_tables.delete` Delete Contacts Table destructive - `lusha.contact_tables.get` Get Contacts Table read - `lusha.contact_tables.list` List Contacts Tables read - `lusha.contact_tables.update` Update Contacts Table write **Subscriptions 6** - `lusha.subscriptions.create` Create Subscription write - `lusha.subscriptions.delete` Delete Subscriptions destructive - `lusha.subscriptions.get` Get Subscription by ID read - `lusha.subscriptions.list` List Subscriptions read - `lusha.subscriptions.test` Test Subscription write - `lusha.subscriptions.update` Update Subscription write **Company table columns 4** - `lusha.company_table_columns.add` Add Columns to Companies Table write - `lusha.company_table_columns.list` List Companies Table Columns read - `lusha.company_table_columns.remove` Remove Column from Companies Table destructive - `lusha.company_table_columns.run` Run Column on Companies Table write **Contact table columns 4** - `lusha.contact_table_columns.add` Add Columns to Contacts Table write - `lusha.contact_table_columns.list` List Contacts Table Columns read - `lusha.contact_table_columns.remove` Remove Column from Contacts Table destructive - `lusha.contact_table_columns.run` Run Column on Contacts Table write **Company table entities 3** - `lusha.company_table_entities.add` Add Entities to Companies Table write - `lusha.company_table_entities.list` Get Companies Table Entities read - `lusha.company_table_entities.remove` Remove Entities from Companies Table destructive **Contact table entities 3** - `lusha.contact_table_entities.add` Add Entities to Contacts Table write - `lusha.contact_table_entities.list` Get Contacts Table Entities read - `lusha.contact_table_entities.remove` Remove Entities from Contacts Table destructive **Account secret 2** - `lusha.account_secret.get` Get Account Secret read - `lusha.account_secret.regenerate` Regenerate Account Secret write **Audit logs 2** - `lusha.audit_logs.list` Get Audit Logs read - `lusha.audit_logs.stats` Get Audit Log Statistics read **Conversations 2** - `lusha.conversations.search` Search Conversations read - `lusha.conversations.transcript` Get Conversation Transcript read **Account 1** - `lusha.account.usage` Get Account Usage read **Contact enrich jobs 1** - `lusha.contact_enrich_jobs.get` Get Contacts Enrich Job read **Icp profiles 1** - `lusha.icp_profiles.list` List Target Profiles read **Opt out subscriptions 1** - `lusha.opt_out_subscriptions.create` Create Opt-Out Subscription write **Website visits 1** - `lusha.website_visits.search` Get Website Visitors read Questions ## The Lusha MCP server, answered. **Is there a Lusha MCP server for Claude?** Yes. actionlake is an MCP gateway: a remote MCP server that gives Claude, or another MCP client, 72 Lusha actions across companies, contacts, company tables and contact tables, through the same eight tools it uses for every other connector. actionlake is independent; it is not made or endorsed by Lusha. **What do I need to connect Lusha?** Lusha API key from the API dashboard (dashboard.lusha.com/api/manage-api-keys; admins and managers with API access). The free call account { op: "connections.requirements", service: "lusha" } lists exactly what to paste. **Can an AI agent delete or change things in Lusha?** Only if its key allows it, and only with an explicit confirmation. 7 Lusha actions are destructive, including delete Subscriptions, delete Companies Table and delete Contacts Table. Each runs only with confirm: true. Under the human confirm policy, or an approval rule on the key, the run waits until a named person approves it. **Will an AI agent use up my Lusha API limit?** actionlake paces every call to the limits in the Lusha service file: 25 calls a second per connection. Repeated reads are answered from cache (49 Lusha actions can be), which never reaches Lusha. **What does a Lusha action cost?** One upstream call, the only unit actionlake bills. A list that pages bills one call per page (72 Lusha actions page). Cache hits, searches, dry runs and calls Lusha refused with 401, 403, 429 or a 5xx are free. The Free plan includes 100,000 calls a month with no card. Paid plans start at US$49 a month for 250,000 calls, with overage from US$0.30 down to US$0.18 per 1,000. **Which Lusha API does it cover?** The Lusha API v3 (OpenAPI 3.0.3) at api.lusha.com. It is built from Lusha's documentation as read on 23 October 2026. 72 actions in 17 areas, each one in the signed service file (version 1.0.0). **Does actionlake keep my Lusha data, and where?** actionlake processes and stores data in Sydney, Australia; there is no US region yet. Reads may be cached for up to 5 minutes, and a write clears the reads it affects. Each run's request and response is kept, sealed, for your plan's trace window: 1 day on Free, 3 days on Starter, 7 days on Pro, 14 days on Team, 30 days on Business and 30 days on Enterprise. Your Lusha credential is sealed under your tenant's key, never logged and never returned. Your traffic is not used to train models. **Which AI clients can use it?** Claude Code, tested by us end to end, and the Claude app as a custom connector, tested by us with an existing key. Other MCP clients that support remote servers over Streamable HTTP (MCP revisions 2025-06-18 and 2025-11-25) and OAuth dynamic client registration, or a bearer header, should connect the same way; we have not tested them. Or plain REST, under the same action names. ## More connectors like Lusha Joins with, on shared entities - [ConnectWise PSA 2](https://actionlake.com/connectors/connectwise-psa) - [HaloPSA 2](https://actionlake.com/connectors/halopsa) - [Genesys Cloud CX 2](https://actionlake.com/connectors/genesys-cloud-cx) - [Simpro 2](https://actionlake.com/connectors/simpro) - [Acumatica Cloud ERP 2](https://actionlake.com/connectors/acumatica-cloud-erp) - [Exact Online 2](https://actionlake.com/connectors/exact-online) Browse - [All CRM & sales connectors](https://actionlake.com/connectors/category/crm-and-sales) - [All connectors](https://actionlake.com/connectors) - [How actionlake compares](https://actionlake.com/compare) actionlake is independent. It is not made or endorsed by Lusha; the name is the vendor's own. Counts are from the Lusha service file, version 1.0.0. ## Give your agent Lusha today. [Connect Lusha free](https://actionlake.com/console?start=sandbox) [See pricing](https://actionlake.com/pricing) Start free - 100,000 calls/month, no card. No signup. Hard caps on every key. Cached answers are free. --- Source: https://actionlake.com/connectors/lusha More: https://actionlake.com/llms.txt