Docs IntegrationsConnect your AI assistant (MCP)

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.

Last updated: June 4, 2026

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/mcp

Fastest way: paste this prompt into Claude Code

Replace YOUR_KEY with the key you created, paste the whole block into Claude Code, and it will install the connector and walk you through the rest.

Install the Lead Distro AI MCP connector for me.

Run this command:
claude mcp add --transport http leaddistro https://mcp.leaddistro.ai/mcp --header "Authorization: Bearer YOUR_KEY"

Then give me step-by-step instructions to restart Claude Code so the new tools load. After that, help me get started: list my campaigns and tell me what I can do, or help me set up my first campaign.

Claude Code (command only)

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?

Any client that supports the Model Context Protocol (MCP) over HTTP. That includes Claude Code, the Claude desktop and web apps, Cursor, Windsurf, and a growing list of others. You connect by adding the endpoint https://mcp.leaddistro.ai/mcp and passing your API key as a bearer token.

Is it safe to let an AI assistant manage my account?

Every key is scoped to one organization and only does what its permissions allow. Money movement (charging cards, wallet refunds, invoices) is never exposed to a key at all. You can revoke any key instantly, and only admins can create or revoke keys. As with any credential, share it carefully and revoke it if it leaks.

What can the assistant not do?

It cannot charge a buyer's card, refund a wallet, or send or void an invoice. Those billing actions are deliberately left out of the connector. A key also cannot do anything outside the organization it was created in.

Do I need to be technical to set this up?

No. Create a key in Settings, then paste one line into your AI client. After that you just chat. The assistant handles the rest, like asking clarifying questions before it creates a campaign.

What happens if I lose my key?

The full key is shown only once when you create it, so it cannot be recovered. If you lose it, revoke it in Settings and create a new one. Update your AI client with the new key.

Lead Ingest API

Complete Lead Distro AI API reference. Ingest leads via REST endpoints with field validation, signed webhooks, authentication, rate limits, and full example requests for every lead distribution endpoint.

If you have any questions, send us an email at support@leaddistro.ai

Call Tracking Overview