# Lusha — how to use (mcp.ai)

Connect your Lusha account and use 7 tools for sales and CRM straight from your AI agent. Connect with your own API key. B2B contact enrichment and prospecting platform providing verified email addresses, phone numbers, and company information.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_lusha?ms=1787295780000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `lusha_create_subscription`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/lusha`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/lusha/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/lusha/create/subscription` — Tool to create one or more webhook subscriptions for real-time signal notifications. Use when you want to subscribe to Lusha signals (job changes, company updates, etc.) and receive real-time webhook 
  - body: { name?: string, defaults: object, subscriptions: object[] }
- `POST https://api.mcp.ai/api/lusha/delete/subscriptions` — Delete one or more webhook subscriptions by their IDs. Use this action to remove webhook subscriptions from your Lusha account. The action supports batch deletion of up to 25 subscriptions per request
  - body: { ids: string[] }
- `POST https://api.mcp.ai/api/lusha/get/audit/log/stats` — Retrieve aggregated statistics for audit logs. Returns total count, successful count, failed count, and success rate percentage. Use this to monitor audit log activity and delivery success rates.
  - body: { subscription_id?: string }
- `POST https://api.mcp.ai/api/lusha/get/audit/logs` — Retrieve audit logs for your account including API calls and webhook deliveries. Use when you need to review delivery status, errors, and performance metrics for webhooks and API requests in your Lush
  - body: { limit?: integer, offset?: integer, status?: string, subscriptionId?: string }
- `POST https://api.mcp.ai/api/lusha/get/subscription` — Tool to get details of a specific webhook subscription by ID. Use when you need to retrieve information about an existing webhook subscription including its status, configuration, and entity details.
  - body: { id: string }
- `POST https://api.mcp.ai/api/lusha/list/subscriptions` — List all webhook subscriptions for your account with pagination support. Use when you want to retrieve all configured webhook subscriptions to review their settings, check active status, or manage you
  - body: { limit?: integer, offset?: integer }
- `POST https://api.mcp.ai/api/lusha/update/subscription` — Update an existing webhook subscription configuration. Use this action to modify an existing webhook subscription's settings such as name, webhook URL, active status, and signal types. Optionally, you
  - body: { id: string, url?: string, name?: string, is_active?: boolean, signal_types?: string[], regenerate_secret?: boolean }

## Example prompts
- "What can I do in Lusha?"
- "Show me a summary of my Lusha account"

## More
- Page: https://mcp.ai/lusha
- Agent spec (llms.txt): https://mcp.ai/lusha/llms.txt
- Postman collection: https://mcp.ai/lusha/postman.json