# SmartLead MCP > SmartLead connects your AI agent directly to cold email campaign infrastructure. You manage lead lists, track performance metrics, and control sending accounts—all without ever opening a dashboard. Use tools like `add_lead` or `get_campaign_analytics` to scale outreach, monitor deliverability, and run high-volume campaigns via natural language prompts. ## Overview - **Category:** marketing-automation - **Price:** Free - **Tags:** cold-email, email-marketing, lead-generation, email-deliverability, campaign-management ## Description You don't have to click through dashboards; you connect **SmartLead** to your AI agent and run your entire cold email campaign infrastructure straight from prompts. You manage lead lists, track performance metrics, and control sending accounts at massive scale—all without ever opening a dashboard. ### Campaign Flow Control When you need an overview of what's running, use `list_campaigns` to pull up a full list of every campaign set up in SmartLead. If you want the specifics on one particular sequence, run `get_campaign` to retrieve all the current setup and details for that named campaign. You can instantly halt an outreach effort using `pause_campaign`, which stops any running campaign immediately so you don't send another email by accident. When you're ready to go again, just use `resume_campaign`; it reactivates the paused campaign and gets the scheduled sequence rolling again. ### Lead Management and Prep Work If you have new prospects ready for outreach, run `add_lead` to drop them into your SmartLead system. This tool adds those new leads so they're queued up and ready for use in future campaigns. You can also get a comprehensive inventory of every lead managed by the account across all sequences using `list_leads`. To ensure you have all the data points, you can check out general details on your existing campaign setup with `get_campaign` before running any new leads through it. ### Auditing Sending Accounts and Deliverability Your sending accounts gotta be healthy. Use `list_email_accounts` to pull a list of every connected email account. This shows you the current warm-up status and scoring for each one, letting you audit your deliverability before you send anything high volume. ### Performance Auditing When it comes time to check the results, forget digging through menus. Use `get_campaign_analytics` to pull deep performance data on any specific campaign. This gives you metrics like open rates, click counts, and replies—the raw conversion data you need to make decisions. You can also get a summary of all campaigns' general setup details via `list_campaigns` before diving into the numbers. *** **SmartLead** lets you handle entire outreach funnels using natural language prompts instead of clicking buttons. It handles multi-mailbox rotation automatically when it runs an outreach sequence, so you don't gotta worry about which account sends what. You can combine these tools into a single workflow: First, run `list_email_accounts` to verify your sending accounts are warm enough; then, use `add_lead` to queue up the next batch of prospects; check the campaign details using `get_campaign`; and finally, kick it off. If you need an immediate stop, you know to hit `pause_campaign`. When all that's done, you pull the final numbers with `get_campaign_analytics`. ## Tools ### add_lead Adds new prospects (leads) into your SmartLead system for future campaign use. ### get_campaign Retrieves the current setup and details for a specific, named campaign. ### get_campaign_analytics Pulls detailed performance data (opens, clicks, replies) for any given campaign. ### list_campaigns Retrieves a list of all campaigns you currently have set up in SmartLead. ### list_email_accounts Shows a list of all connected email sending accounts, including their warm-up status and scores. ### list_leads Retrieves an overall list of leads managed by your account across all campaigns. ### pause_campaign Stops a running campaign immediately, preventing any further emails from being sent out. ### resume_campaign Reactivates a paused campaign and resumes the scheduled outreach sequence. ## Prompt Examples **Prompt:** ``` What's the status of my 'Enterprise Q2' campaign? ``` **Response:** ``` Campaign 'Enterprise Q2': 2,400 leads enrolled. Open rate: 54%, Reply rate: 7%, Bounce rate: 2.1%. Using 15 sending accounts with smart rotation. 168 positive replies received. ``` **Prompt:** ``` Check warm-up progress on my sending accounts. ``` **Response:** ``` 15 sending accounts total. 12 fully warmed (score 90+, ready for campaigns). 3 in progress (scores 55, 62, 78 — estimated 1-2 weeks to full warm-up). ``` **Prompt:** ``` Upload 500 new leads to the 'SaaS Founders' campaign. ``` **Response:** ``` 500 leads uploaded to 'SaaS Founders'. 487 accepted, 8 duplicates skipped, 5 invalid emails rejected. Campaign will automatically distribute new leads across your 12 active sending accounts. ``` ## Capabilities ### Manage Campaign Status List, create, pause, or resume entire email campaigns using dedicated tools. ### Add and Validate Leads Upload new leads to the system and queue them for campaign distribution via `add_lead`. ### Track Performance Metrics Pull deep analytics on any running campaign, including open rate, click count, and conversion data, using `get_campaign_analytics`. ### Audit Sending Accounts List all connected email accounts to check warm-up scores and monitor deliverability status via `list_email_accounts`. ### Retrieve Lead Lists Get a list of existing leads or specific campaign details using `list_leads` or `get_campaign`. ### Control Campaign Flow Temporarily halt or restart campaigns instantly via the `pause_campaign` and `resume_campaign` tools. ## Use Cases ### Scaling a Client Campaign An agency needs to launch a new campaign for three different clients. Instead of logging into three separate dashboards, the agent runs `list_campaigns` first to confirm all accounts are active. Then, it uses `add_lead` in batches and triggers the sequence across all necessary mailboxes. ### Checking Account Health Before Launch An SDR team is about to kick off a major campaign. They first run `list_email_accounts`. If they see accounts with low warm-up scores, they can pause the launch and wait for those specific accounts to reach 90+ score. ### Deep Dive Performance Review A marketing manager needs to know why last month's campaign underperformed. They use `get_campaign_analytics` to pull the metrics, comparing open rate against click rate and identifying a sharp drop in conversions. ### Handling Campaign Interruptions A major sales event forces the team to stop emailing for 48 hours. The agent calls `pause_campaign`. When the event is over, they simply call `resume_campaign` without losing any campaign settings or lead distribution history. ## Benefits - Track opens, clicks, and replies instantly using `get_campaign_analytics`. You get real-time performance data without navigating complex reporting dashboards. - Scale outreach safely. The system handles multi-mailbox rotation automatically when you run a campaign, which is critical for large agencies running dozens of client accounts. - Maintain deliverability control. Use `list_email_accounts` to check warm-up scores and know exactly which sending accounts are ready for high volume traffic. - Control the workflow instantly. If something goes wrong or you need a break, call `pause_campaign`. When it's good to go, use `resume_campaign`—no manual intervention needed. - Centralize lead data. Instead of hunting through tabs, run `list_leads` to get one consolidated view of every prospect in your system. ## How It Works The bottom line is: your AI client runs the necessary API calls directly against SmartLead's backend without needing a web interface. 1. Subscribe to the SmartLead integration on Vinkius. Get your API key from your SmartLead dashboard (Settings → API). 2. Ask your AI agent to perform a task: 'Check the analytics for my Q3 campaign,' or 'Add these 100 new leads.' 3. The agent executes the correct tool (`get_campaign_analytics` or `add_lead`), receives structured data, and reports the result back to you. ## Frequently Asked Questions **How do I check my account warm-up status using list_email_accounts?** Run `list_email_accounts`. This tool lists every connected sending mailbox and provides its current warm-up score. You can quickly see which accounts are fully warmed (90+) and which ones need time. **What is the best way to track performance analytics using get_campaign_analytics?** You must provide the exact campaign name to `get_campaign_analytics`. This returns a structured readout of opens, clicks, and replies. It's better than looking at any single dashboard graph. **Can I bulk add leads using add_lead?** Yes. Use the `add_lead` tool to upload large batches of prospects. The system handles validation, automatically skipping duplicates or bad email formats for you. **If a campaign is running and I need to stop it immediately, which tool do I use?** You must call `pause_campaign`. This stops the sequence instantly. If you want to restart later, use `resume_campaign`. **What if I need a list of all my campaigns? Do I use get_campaign or list_campaigns?** Use `list_campaigns`. This gives you an index of every campaign name. Then, if you want deep details on one specific one, run `get_campaign`. **If I want to filter my prospects, how do I use list_leads?** You pass specific filters directly into the call. You can restrict results by status—say, only showing 'bounced' or 'duplicate' leads. This lets your agent pull exactly what needs manual review without having to process all your existing records. **After pausing a campaign, how do I resume it using resume_campaign?** Simply calling `resume_campaign(campaign_id)` restarts the queue immediately. The agent checks the last known operational state and resumes sending from where it left off. You don't need to reconfigure any settings. **What details should I check when using get_campaign before launching a new run?** You must verify two things: the active sending account pool and the rotation limits. The tool returns this data, guaranteeing your agent knows exactly which mailboxes are available and if they're ready to send at volume. **How do I get my SmartLead API key?** Log in to your SmartLead account at **app.smartlead.ai**. Click **Settings** in the left sidebar. Navigate to the **API** section. Your API key is displayed on this page — click **Copy**. Paste it into the configuration field below. **Can I manage hundreds of sending accounts?** Yes. SmartLead is built for scale. Your AI agent can manage mailbox rotation, warm-up status, and daily sending limits across all accounts from a single conversation. **How does mailbox rotation work?** SmartLead automatically distributes outgoing emails across your connected mailboxes, keeping each under safe daily sending limits. Your AI agent monitors this rotation and alerts you if any account approaches its limit. **Is SmartLead good for agencies?** Yes. SmartLead is built specifically for cold email agencies with white-label capabilities, client management, and unlimited mailbox connections — all accessible through your AI agent.