# Connect your AI assistant (/docs/mcp)
## Quickstart [#quickstart]
You need a Happierleads account and an AI assistant that supports MCP connectors.
### 1. Copy your connection URL [#1-copy-your-connection-url]
### 2. Add it to your assistant [#2-add-it-to-your-assistant]
### 3. Check it works [#3-check-it-works]
Start a new chat and ask:
> List my websites.
**Expected:** the assistant shows that it used `list_websites` and replies with your websites and whether each one’s tracking script is verified. If it says it has no Happierleads tools, see [Errors and troubleshooting](/docs/mcp/errors#connection-problems).
## What you can ask [#what-you-can-ask]
You don’t write requests or learn tool names. Describe what you want, and the assistant picks the tools:
| Product | Ask | Your assistant uses |
| --- | --- | --- |
| [Leads](/docs/leads/website-visitors/see-your-leads/mcp) | “Who visited my site this week? Hottest first.” | `get_leads` |
| [Lead details](/docs/leads/lead-details/mcp) | “Give me a sales brief on the last visitor from acme.com.” | `get_lead_ai_summary` |
| [3rd-party intent](/docs/leads/intent-topics/mcp) | “Subscribe me to companies researching CRM software.” | `subscribe_to_intent_topic` |
| [Web Scraping](/docs/leads/web-scraping/mcp) | “Find companies that have a competitor's tracker on their site.” | `update_web_scraping` |
| [AI Scout](/docs/leads/ai-scout/mcp) | “Find founders who were guests on B2B podcasts, 25 a day.” | `create_ai_scout` |
| [Prospector](/docs/leads/prospector/search-prospects/manual-search/mcp) | “Find 25 SaaS founders in the US at companies with 10–200 employees.” | `search_people` |
| [Auto Search](/docs/leads/prospector/search-prospects/auto-search/mcp) | “Add 50 new heads of marketing at fintechs to my leads every day.” | `create_auto_search` |
| [Lists & export](/docs/leads/csv-export/mcp) | “Export this week's hot leads to CSV.” | `export_leads_csv` |
| [Qualify](/docs/qualify/ai-assist/mcp) | “Build a scoring model for B2B SaaS companies with 50+ staff.” | `ai_generate_scoring_model` |
| [Engage](/docs/engage/email-campaigns/mcp) | “How are my email campaigns doing? Which replied?” | `get_campaign_stats`, `get_inbox_emails` |
| [Mailboxes](/docs/engage/mailboxes/warmup/mcp) | “Is my mailbox warmup healthy?” | `get_warmup_health` |
| [Automations & CRM](/docs/automations/automations/mcp) | “Push every hot lead to HubSpot.” | `create_automation` |
| [Websites](/docs/websites/tracking-pixel/mcp) | “Is my tracking script installed correctly?” | `get_website_diagnostics` |
| [Account](/docs/account/billing/mcp) | “How many credits do I have left?” | `get_account` |
Each feature page has an **MCP** tab with the questions to ask for that feature. The full list is under [All tools](/docs/mcp/tools).
## Free tools [#free-tools]
The `free_` tools (company enrichment, decision-makers, people search, companies using a technology, lookalikes, email patterns and intent topics) are free on every Happierleads account, including after your trial ends, so all you need is a [free account](https://admin.happierleads.com/signup?utm_source=docs&utm_medium=mcp). Each account gets **10 calls and 10 verified business emails a day**, reset at 00:00 UTC. For more, use the paid tools such as [`search_people`](/docs/mcp/tools/search-people).
## How it works [#how-it-works]
The **Model Context Protocol (MCP)** is an open standard that lets AI assistants use tools inside other products. When you ask something:
1. Your assistant reads the list of Happierleads tools and their descriptions.
2. It picks the tool that fits and fills in its parameters from your words.
3. Happierleads runs the tool in your account, with your plan, credits and websites, and the assistant summarises the result.
The assistant can also chain tools: find people, reveal their emails, then add them to a campaign. Before you let it act, read [Security and permissions](/docs/mcp/security).
## Every control on this screen [#every-control-on-this-screen]
Every button, field and switch, with what it does.