DocsAI Assistant (MCP)What it can do & security

What it can do & security

Everything an AI assistant connected to Lead Distro AI can read and change, grouped by area, plus the permission model, rate limits, what it can never do (move money), and how to disconnect an assistant or revoke an API key.

Last updated:

Once connected, you ask the assistant in plain English and it uses tools scoped to your organization. What it can do depends on the permissions you granted.

Permission levels

Permissions are set per area, each as None, Read, or Write, the way a restricted key works on a payments dashboard. A new API key starts read only, which is enough for reporting; turn on Write only for the areas the assistant must change. The same permissions apply whether the assistant connects over MCP or a script calls the Actions API.

AreaRead lets itWrite lets it
CampaignsList and inspect campaigns, their fields, filters, and post specsCreate campaigns, change settings, edit fields and filters, set up ping-post
DestinationsList buyers and inspect their delivery and ping setupCreate buyers, attach them to campaigns, set delivery, ping, transforms, and call targets
SourcesList suppliersCreate suppliers, attach them to campaigns, set cost modes
LeadsOpen leads and their routing trail (contact details hidden unless you ask)Post outcomes back, add notes, send $0 test leads and pings
FunnelsList funnels and templatesCreate, edit, and publish funnels, run A/B tests
ReportsPull lead stats, breakdowns, and campaign performanceNo write level
Partner PortalSee who has portal accessTurn on the portal, add members, set portal rules
AutomationsNo read levelCreate automations on lead events
IntegrationsList ad accounts and ad campaignsMap an ad campaign to a source for spend tracking

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.

What you can do

Everything the assistant can do, grouped by area. The Needs column is the permission each capability requires: the area plus Read or Write.

AreaYou can ask it toNeedsExample
Reports & insightsList and inspect campaigns, buyers, and suppliersCampaigns, Destinations, Sources: Read"List my active campaigns."
Reports & insightsPull lead counts, revenue, cost, and profit for any date rangeReports: Read"What was my profit last week?"
Reports & insightsBreak leads down by campaign, buyer, supplier, status, or stateReports: Read"Break down last month's leads by state."
Reports & insightsReview a campaign's full P&L with per-buyer and per-supplier detailReports: Read"How is Auto Accident doing, by buyer?"
Reports & insightsList or open individual leads (contact details stay hidden unless you ask)Leads: Read"Show me yesterday's rejected leads."
Reports & insightsExplain why a lead was routed the way it wasLeads: Read"Why did this lead go to Acme?"
Reports & insightsCheck setup progress, or get the post instructions a supplier needsCampaigns: Read"Give Acme the post spec for Solar."
Campaigns & fieldsCreate a campaign or change its settingsCampaigns: Write"Create a campaign called Auto Accident."
Campaigns & fieldsAdd lead fields, or rewrite the whole field listCampaigns: Write"Add a required phone field."
Campaigns & fieldsSet inbound filters that accept or reject incoming leadsCampaigns: Write"Reject leads from outside California."
Campaigns & fieldsTurn a campaign into a ping-post exchangeCampaigns: Write"Make Solar ping-post with a 20% margin."
DestinationsCreate a buyer or update its detailsDestinations: Write"Add a buyer called Acme."
DestinationsAdd a buyer to a campaign with price, priority, caps, and state filtersDestinations: Write"Add Acme to Solar at $40, 50 a day, CA only."
DestinationsSet delivery (webhook, email, Google Sheets, SMS, GoHighLevel) and which fields to sendDestinations: Write"Deliver to Acme by webhook with name and phone."
DestinationsPause, activate, or change pricing, caps, and billing model (per lead or per conversion)Destinations: Write"Switch Acme to pay only on conversion."
DestinationsConfigure a buyer's real-time bid (ping) in a ping-post campaignDestinations: Write"Set Acme's ping endpoint and bid field."
SourcesCreate a supplier or update its detailsSources: Write"Add a supplier called FB Ads."
SourcesAdd a supplier to a campaign with a cost per lead and capsSources: Write"Add FB Ads to Solar at $12 per lead."
SourcesSet how cost is calculated (flat, variable, ad-account spend, or revenue share)Sources: Write"Pay FB Ads 30% of each lead's revenue."
SourcesPause, resume, or re-cap intake from a supplierSources: Write"Cap FB Ads at 200 leads a day."
AutomationsSet up a rule on lead events that sends a webhook, email, Slack, or Google Sheets rowAutomations: Write"Slack me when a lead is accepted."
Partner PortalTurn on the Partner Portal for a buyerPartner Portal: Write"Enable the portal for Acme."
Partner PortalAdd or invite portal members, or see who already has accessPartner Portal: Write"Invite ops@acme.com to Acme's portal."
Partner PortalSet the portal's return policyPartner Portal: Write"Let Acme request returns within 7 days."
Testing & outcomesSend a $0 test lead to confirm routing and delivery workLeads: Write"Send a test lead through Solar."
Testing & outcomesRun a $0 ping-post dry run to see every buyer's bidLeads: Write"Test the ping-post exchange on Solar."
Testing & outcomesPost a buyer's conversion back, or mark a delivered lead not qualifiedLeads: Write"Mark lead as converted."
LeadProsper importPreview what would be migrated, changing nothingCampaigns: Read"Preview a LeadProsper import."
LeadProsper importRun the import after you review the plan (buyers arrive paused)Campaigns: Write"Go ahead and import it."

What it can never do

No matter how you connect, the assistant cannot move money. It cannot charge a buyer's card, refund a wallet, or send or void an invoice. Those billing actions are deliberately left out. An assistant also cannot do anything outside the one organization it is connected to.

Rate limits

Each connection 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.

Disconnect or revoke access

Browser sign-in (Claude.ai, desktop, or Claude Code): go to Settings, then API Keys, and find the Connected AI assistants card. Click Revoke next to the assistant you want to disconnect. It loses access right away and would have to be authorized again.

API key: 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

Is it safe to let an AI assistant manage my account?
Every connection is scoped to one organization and only does what its permissions allow. Money movement (charging cards, wallet refunds, invoices) is never exposed at all. You can revoke any connection or key instantly, and only admins can create or revoke them. As with any credential, share keys carefully and revoke them if they leak.
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. It also cannot do anything outside the organization it is connected to.
Which AI assistants can connect to Lead Distro AI?
Any client that supports the Model Context Protocol (MCP) over HTTP. For one-click browser sign-in, use Claude.ai, the Claude desktop app, or Claude Code. For Cursor, Windsurf, and other JSON-config clients, add the endpoint https://mcp.leaddistro.ai/mcp and pass an API key as a bearer token. Headless setups like scripts and scheduled jobs also use an API key.
How do I disconnect an assistant?
For browser sign-in, go to Settings, then API Keys, and click Revoke under Connected AI assistants. For an API key, click Revoke on the key. Either one cuts off access.

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