Your AI assistant can set up and run the Lead Agent for you by chat. It uses the same settings as Settings → Lead Agent, and the same safety rules.
Step 1: Connect your assistant#
Follow Connect your AI assistant. It takes about 2 minutes. Sign in as the account owner or an admin: only they can change the Lead Agent.
Step 2: Start the setup interview#
Open a new chat and say:
Set up my Lead Agent.Your assistant loads the built-in Lead Agent setup interview. It:
- Reads first. It checks what your account already has (voice agent, text agent, texting line, email domain, AI Memory, calling hours, pipelines and tags) and tells you what's ready and what isn't.
- Asks one question at a time: your business and goal, lead sources, don'ts and do's, leads who already got an offer, qualifying questions, calling hours, channels, limits, your hand-off person, scope, research, what "not interested" should do, field mapping, the off tag, and how the AI is paid for.
- Repeats back what each answer becomes, in one line.
- Checks your voice agent's prompt has
{{call_reason}}and{{agent_rules}}, and shows you the change before adding them. - Checks your text agent has a calendar and that you get a text on every booking.
- Reads the whole setup back and asks "Anything to change?" before saving.
- Tests it on fictional leads, then Watch, then adds your leads (dry run first), then reviews a day of decisions with you.
- Goes live only after you say yes to the exact live preview.
Your OpenRouter key never goes in the chat. If you choose your own key, add it in Settings → Lead Agent → AI billing in the web app. The assistant can only check whether a key is connected and working.
Want the exact words to type for each step? See Set it up from Claude.
There's also a built-in Lead Agent copy skill with writing rules for cash home buyers: short, human, one question per message, never claims to be human, no offer numbers, no promises.
Things to ask#
| You want to | Ask |
|---|---|
| See the setup | "Show me my Lead Agent settings in plain words." |
| Change a rule | "Add a don't: never mention we're investors." |
| See how it's doing | "How is the Lead Agent doing today?" |
| Read its decisions | "Show me the last 20 Lead Agent decisions and why." |
| Check one lead | "What is the Lead Agent doing with Becky Smith?" |
| Pause one lead | "Pause the Lead Agent for Becky, Luke is talking to her." |
| Read the morning report | "Show me yesterday's Lead Agent report with suggestions." |
| Turn it off | "Turn the Lead Agent off." |
Previews first: what needs your yes#
Some actions start real outreach or spend money. For those, your assistant first shows you exactly what will happen and changes nothing. It only acts when you say yes.
Never let your assistant treat "sounds good" about something else as a yes to going live. A good assistant shows you the live preview word for word and asks you directly.
The Lead Agent tools#
| Tool | What it does | Needs your yes |
|---|---|---|
lead_agent_get_config | Reads the current settings and mode | No (read only) |
lead_agent_update_config | Changes settings. Never changes the mode. | Yes for: any AI billing change, raising the daily AI limit, and on a live agent, any change to scope, account limit, per-lead limits, channels or hours. Other edits save at once. |
lead_agent_set_mode | Switches Off, Watch or Live | Yes for Watch (it uses billed AI) and Live. Off never needs it. |
lead_agent_status | Mode, whether it really sends, leads by status, sent today, bookings, contact rate | No (read only) |
lead_agent_decisions | Its decisions, newest first, with reason, draft and next touch | No (read only) |
lead_agent_contact | Everything about one lead: status, next touch, history | No (read only) |
lead_agent_pause_contact | Pauses one lead | No |
lead_agent_resume_contact | Resumes one paused or stopped lead | Yes. Leads who opted out, threatened legal action, said wrong number or not interested can never be resumed. |
lead_agent_history_pull | Reads your GoHighLevel conversations and notes (365 days by default) so past STOPs and wrong numbers are stopped first | Yes |
lead_agent_seed | Adds your existing in-scope leads | Dry run: no. Yes to add them for real. Waits until the history pull is done. |
lead_agent_simulate | Tests your settings on fictional leads; contacts nobody | Yes for a real-AI run (it's billed). A plumbing check with no AI needs none. |
lead_agent_simulation_result | Reads a test's results | No (read only) |
lead_agent_daily_report | The daily learning report, with optional suggestions | No (read only; suggestions use a little AI) |
lead_agent_suggestions | Lists the report's suggested changes | No (read only) |
lead_agent_suggestion_preview | Shows a suggested voice-prompt change, before and after | No (changes nothing) |
lead_agent_suggestion_apply | Applies a previewed prompt change (a revision is kept so it can be restored) | Yes |
lead_agent_suggestion_dismiss | Marks a suggestion as not wanted | No |
lead_agent_copy_setup | Copies this setup to another account you control | Dry run: no. Yes to copy for real. |
lead_agent_ai_key_status | Who pays for the AI and whether your own key works. Never shows the key. | No (read only) |
Your assistant also uses the normal tools for voice agents, text agents, AI Memory, email domain, pipelines, tags and workflows during setup. See What the MCP can do.
What the assistant can never change#
- Opt-outs, Do Not Call and Do Not Disturb.
- That a booked lead stops, and that a full opt-out stops every channel.
- Calling hours wider than 8 AM to 9 PM in the lead's time (8 PM in Florida).
For agencies working inside a client#
When an agency acts inside a client account, these also need the agency's yes, because the client pays for the outreach or AI: Watch, Live, any AI billing change, a real-AI test, adding leads for real, a real copy, resuming a lead, and widening a live agent. A dry-run copy needs none. See Lead Agent for agencies.