Connect your AI assistant (MCP)
Connect Claude, Cursor, Windsurf, or any MCP-compatible AI assistant to Lead Distro AI. Set up campaigns, update field mappings, add buyers, and pull reports by chatting in plain English. Uses the Model Context Protocol (MCP) over a secure, org-scoped API key.
Connect your AI assistant (MCP)
Lead Distro AI ships a remote MCP (Model Context Protocol) server. Connect an AI assistant like Claude, Cursor, or Windsurf and you can run your account by chatting: create a campaign, update a field mapping, add a buyer, or ask how a campaign performed last week. The assistant uses the same tools the in-app assistant does, scoped to your organization.
One-click browser sign-in (OAuth) is on the way. Today you connect with an API key, which works in every MCP client and in headless setups like scripts and scheduled jobs.
Step 1: Create an API key
- Open Settings, then API Keys (you need to be an admin).
- Click Create key, give it a name (for example, "Claude desktop"), and choose its permissions.
- Copy the key right away. It is shown only once. If you lose it, revoke it and create a new one.
Treat the key like a password. Anyone who has it can act on your organization. Billing actions (charging cards, refunds, invoices) are never available to a key.
Step 2: Add the connector
Point your AI client at the Lead Distro AI MCP endpoint and pass your key as a bearer token. The endpoint is:
https://mcp.leaddistro.ai/mcpClaude Code
claude mcp add --transport http leaddistro \
https://mcp.leaddistro.ai/mcp \
--header "Authorization: Bearer YOUR_KEY"Cursor, Windsurf, and other JSON-config clients
Add Lead Distro AI to your client's MCP server config:
{
"mcpServers": {
"leaddistro": {
"url": "https://mcp.leaddistro.ai/mcp",
"headers": {
"Authorization": "Bearer YOUR_KEY"
}
}
}
}What you can do
Once connected, ask the assistant in plain English. A key only sees the actions its permissions allow.
| Permission | What the assistant can do | Examples |
|---|---|---|
| Read & reporting | Look up campaigns, buyers, suppliers, lead stats, and profit reports. | "How did the Solar campaign do last week?" "List my active campaigns." |
| Manage campaigns & fields | Create and update campaigns, edit field mappings and inbound filters, add and configure buyers and suppliers, and set up automations. | "Create a campaign called Auto Accident, add a required phone field, and add Acme as a buyer at $40." |
Write actions run immediately when you ask for them. There is no separate approval step like the in-app assistant has, so review what you are asking for before you send it.
Rate limits
Each key is limited to 120 tool calls per minute, with a tighter cap of 30 write actions per minute. If you hit a limit, the assistant gets a clear message telling it how many seconds to wait, then it can continue. The limits are generous for normal use and exist to stop a runaway loop.
Revoking access
Go to Settings, then API Keys, and click Revoke on any key. The key stops working within a minute. Revoke a key the moment a teammate leaves or you suspect it has leaked, then create a new one.
Frequently Asked Questions
Which AI assistants can connect to Lead Distro AI?
Is it safe to let an AI assistant manage my account?
What can the assistant not do?
Do I need to be technical to set this up?
What happens if I lose my key?
If you have any questions, send us an email at support@leaddistro.ai