> **Building with AI coding agents?** Install the authstack plugin with one command. This equips your agent with accurate Scalekit implementation patterns.
>
> **Recommended** (the `-y` flags skip prompts, so the command runs without an interactive terminal):
> ```bash
> npx -y @scalekit-inc/cli setup -y
> ```
>
> Global:
> ```bash
> npm install -g @scalekit-inc/cli
> scalekit setup -y
> ```
>
> Supports Claude Code, Cursor, GitHub Copilot, Codex + skills for other Agent Skills-compatible agents in `~/.agents/skills`.
> Skills: integrate-agentkit, implement-saaskit, add-mcp-oauth, implement-sso, implement-scim.
> [Full setup guide](https://docs.scalekit.com/dev-kit/build-with-ai/)

---

# Connect AI agents to the Smartlead MCP server

The Smartlead MCP connector routes your AI agent's tool calls to Smartlead's own MCP server through Scalekit. Each user signs in to Smartlead once, and Scalekit stores and refreshes their tokens, so your agent never handles credentials. It comes with 185 tools.

**Authentication:** OAuth 2.1/DCR
**Categories:** Marketing, CRM & Sales
**Tools:** 185: 115 read, 12 write, 58 destructive
**Users sign in with:** OAuth
**OAuth app:** Your own Smartlead MCP server app
**Built by:** Vendor MCP
**Try it:** [Playground in the Scalekit dashboard](https://app.scalekit.com/ws/signup?sk_intent=playground&provider=SMARTLEADMCP)

## Setup

1. ### Install the SDK

   **Node.js**

   ```bash
   npm install @scalekit-sdk/node dotenv
   ```

   **Python**

   ```bash
   pip install scalekit-sdk-python python-dotenv
   ```

2. ### Set your credentials

   Add your Scalekit credentials to your `.env` file. Find values in **[app.scalekit.com](https://app.scalekit.com)** > **Developers** > **API Credentials**.

   ```sh title=".env"
   SCALEKIT_ENVIRONMENT_URL=<your-environment-url>
   SCALEKIT_CLIENT_ID=<your-client-id>
   SCALEKIT_CLIENT_SECRET=<your-client-secret>
   ```

3. ### Create the Smartlead MCP connection

   In **AgentKit > Connections**, create a Smartlead MCP connection and copy its redirect URI. The name you give it is the `connection_name` your code passes. See [Configure connections](/agentkit/connections/).

4. ### Register an OAuth app

   Smartlead MCP server connections use your own OAuth app. Register one with Smartlead MCP server and add the redirect URI you copied.

   Then enter the app's Client ID and Client Secret on the Smartlead MCP connection.

5. ### Authorize a user and make your first call

   **Node.js** (`quickstart.mts`)

   ```typescript
   import { ScalekitClient } from '@scalekit-sdk/node'
   import 'dotenv/config'
   import { createInterface } from 'node:readline/promises'

   const scalekit = new ScalekitClient(
     process.env.SCALEKIT_ENVIRONMENT_URL,
     process.env.SCALEKIT_CLIENT_ID,
     process.env.SCALEKIT_CLIENT_SECRET,
   )
   const actions = scalekit.actions

   const connector = 'smartleadmcp'
   const identifier = 'user_123'

   // Generate an authorization link for the user
   const { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })
   console.log('Authorize Smartlead MCP:', link)
   const rl = createInterface({ input: process.stdin, output: process.stdout })
   await rl.question('Press Enter after authorizing...')
   rl.close()

   // Make your first call
   const result = await actions.executeTool({
     connector,
     identifier,
     toolName: 'smartleadmcp_fetch_master_inbox_assigned_me',
     toolInput: {},
   })
   console.log(result)
   ```

   ```bash
   npx tsx quickstart.mts
   ```

   **Python** (`quickstart.py`)

   ```python
   import os
   from scalekit import ScalekitClient
   from dotenv import load_dotenv
   load_dotenv()

   scalekit_client = ScalekitClient(
       env_url=os.getenv("SCALEKIT_ENVIRONMENT_URL"),
       client_id=os.getenv("SCALEKIT_CLIENT_ID"),
       client_secret=os.getenv("SCALEKIT_CLIENT_SECRET"),
   )
   actions = scalekit_client.actions

   connection_name = "smartleadmcp"
   identifier = "user_123"

   # Generate an authorization link for the user
   link_response = actions.get_authorization_link(
       connection_name=connection_name,
       identifier=identifier,
   )
   print("Authorize Smartlead MCP:", link_response.link)
   input("Press Enter after authorizing...")

   # Make your first call
   result = actions.execute_tool(
       tool_input={},
       tool_name="smartleadmcp_fetch_master_inbox_assigned_me",
       connection_name=connection_name,
       identifier=identifier,
   )
   print(result)
   ```

   ```bash
   python quickstart.py
   ```

   Each user signs in once. See [Authorize a user](/agentkit/tools/authorize/) for the full flow and statuses.

## Tools

Pass the exact name to `execute_tool`, with an input like each tool's example. To ask for a tool that's missing, use the [request form](https://scalekitsupport.portal.usepylon.com/forms/request-a-connector-tool).

**Node.js**

```typescript
const result = await actions.executeTool({
  toolName: 'smartleadmcp_analyse_campaign_copy',
  toolInput: {
    campaignId: 1,
  },
  connector: 'smartleadmcp',
  identifier: 'user_123',
})
```

**Python**

```python
result = actions.execute_tool(
    tool_name="smartleadmcp_analyse_campaign_copy",
    tool_input={
        "campaignId": 1,
    },
    connection_name="smartleadmcp",
    identifier="user_123",
)
```

`result.data` is the app's response as JSON, and `result.execution_id` (`executionId` in Node.js) is the ID of the call.

### `smartleadmcp_analyse_campaign_copy`

Analyse campaign copy · Read-only

Analyze the email copy used in a campaign. Provides insights on content quality, spam triggers, and optimization suggestions.

Read only: yes. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `campaignId` (`number`, required): The ID of the campaign to analyze

Example input: `{"campaignId":1}`

### `smartleadmcp_analyse_campaign_mailboxes`

Analyse campaign mailboxes · Read-only

Analyze the mailboxes used in a campaign. Checks mailbox health, sending patterns, and potential issues.

Read only: yes. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `campaignId` (`number`, required): The ID of the campaign
- `limit` (`number`, optional): Maximum number of mailboxes to analyze (1-1000). Default: `500`.
- `offset` (`number`, optional): Number of mailboxes to skip. Default: `0`.

Example input: `{"campaignId":1}`

### `smartleadmcp_bulk_fetch_email_messages`

Bulk fetch email messages · Read-only

Fetch messages from multiple email accounts in one request

Read only: yes. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `requests` (`array`, required): Array of fetch requests (max 10)

Example input: `{"requests":[]}`

### `smartleadmcp_check_campaign_bounce_or_lead_quality`

Check campaign bounce or lead quality · Read-only

Check campaign bounce rates and lead quality issues. Identifies problematic leads and potential data quality problems. NOTE ON BOUNCE FIGURES: `bounced_leads` is a count of unique leads, but `sender_bounce_events` counts bounce EVENTS (one per bounced sequence step) and will read higher than the "Sender Bounced" number on the campaign report in the web UI, which counts unique leads. Do not use this tool as the source for a per-lead sender-bounce count or for dashboards -- use the campaign report figure for that.

Read only: yes. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `campaignId` (`number`, required): The ID of the campaign to check

Example input: `{"campaignId":1}`

### `smartleadmcp_check_mailbox_domain_deliverability`

Check mailbox domain deliverability · Read-only

Check the deliverability status and configuration of a mailbox domain. Includes DNS records, reputation, and sending issues.

Read only: yes. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `domain` (`string`, required): The domain name to check deliverability for

Example input: `{"domain":"<domain>"}`

### `smartleadmcp_check_signature_missing`

Check signature missing · Read-only

Check if email signatures are missing in a campaign. Identifies emails sent without proper signatures.

Read only: yes. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `campaignId` (`number`, required): The ID of the campaign to check for missing signatures

Example input: `{"campaignId":1}`

### `smartleadmcp_check_webhook_status`

Check webhook status · Read-only

Check the status and health of webhooks configured for the account.

Read only: yes. Destructive: no. Idempotent (safe to retry): no.

Inputs: none.

Example input: `{}`

### `smartleadmcp_check_whitelabel_domain_cname`

Check whitelabel domain CNAME · Read-only

Check the CNAME configuration for whitelabel domains. Verifies DNS records are properly configured.

Read only: yes. Destructive: no. Idempotent (safe to retry): no.

Inputs: none.

Example input: `{}`

### `smartleadmcp_debug_email_account`

Debug email account · Read-only

Debug email account issues. Provides detailed diagnostic information about email account configuration, connection status, and potential issues.

Read only: yes. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `emailAccountId` (`number`, required): The ID of the email account to debug

Example input: `{"emailAccountId":1}`

### `smartleadmcp_export_campaign_leads`

Export campaign leads · Read-only

Export all leads from a campaign to a downloadable file

Read only: yes. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `campaign_id` (`number`, required): The ID of the campaign

Example input: `{"campaign_id":1}`

### `smartleadmcp_fetch_email_messages`

Fetch email messages · Read-only

Fetch messages from an email account

Read only: yes. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `account_id` (`number`, required): The email account ID
- `folder` (`string`, optional): Email folder to fetch from (e.g., INBOX, SENT)
- `from` (`string`, optional): Filter messages from this date (ISO format)
- `includeBody` (`boolean`, optional): Include full message body
- `limit` (`number`, optional): Number of messages to fetch (1-500, default 100)
- `to` (`string`, optional): Filter messages to this date (ISO format)

Example input: `{"account_id":1}`

### `smartleadmcp_fetch_master_inbox_archived_emails`

Fetch master inbox archived emails · Read-only

Fetch archived emails from master inbox

Read only: yes. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `fetch_message_history` (`boolean`, optional): Include full message history. Default: `false`.
- `filters` (`object`, optional): No description.
- `limit` (`number`, optional): Number of results (1-20)
- `offset` (`number`, optional): Offset for pagination (min: 0)
- `sortBy` (`string`, optional): Sort order for results. One of: `REPLY_TIME_DESC`, `SENT_TIME_DESC`.

Example input: `{}`

### `smartleadmcp_fetch_master_inbox_assigned_me`

Fetch master inbox assigned me · Read-only

Fetch emails assigned to me from master inbox

Read only: yes. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `fetch_message_history` (`boolean`, optional): Include full message history. Default: `false`.
- `filters` (`object`, optional): No description.
- `limit` (`number`, optional): Number of results (1-20)
- `offset` (`number`, optional): Offset for pagination (min: 0)
- `sortBy` (`string`, optional): Sort order for results. One of: `REPLY_TIME_DESC`, `SENT_TIME_DESC`.

Example input: `{}`

### `smartleadmcp_fetch_master_inbox_custom_view_emails`

Fetch master inbox custom view emails · Read-only

Fetch emails from a custom view in master inbox

Read only: yes. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `fetch_message_history` (`boolean`, optional): Include full message history. Default: `false`.
- `filters` (`object`, optional): No description.
- `limit` (`number`, optional): Number of results (1-20)
- `offset` (`number`, optional): Offset for pagination (min: 0)
- `sortBy` (`string`, optional): Sort order for results. One of: `REPLY_TIME_DESC`, `SENT_TIME_DESC`.

Example input: `{}`

### `smartleadmcp_fetch_master_inbox_important_emails`

Fetch master inbox important emails · Read-only

Fetch important emails from master inbox

Read only: yes. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `fetch_message_history` (`boolean`, optional): Include full message history. Default: `false`.
- `filters` (`object`, optional): No description.
- `limit` (`number`, optional): Number of results (1-20)
- `offset` (`number`, optional): Offset for pagination (min: 0)
- `sortBy` (`string`, optional): Sort order for results. One of: `REPLY_TIME_DESC`, `SENT_TIME_DESC`.

Example input: `{}`

### `smartleadmcp_fetch_master_inbox_reminders_emails`

Fetch master inbox reminders emails · Read-only

Fetch emails with reminders from master inbox

Read only: yes. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `filters` (`object`, optional): No description.
- `limit` (`number`, optional): Number of results (1-20)
- `offset` (`number`, optional): Offset for pagination (min: 0)
- `sortBy` (`string`, optional): Sort order for results. One of: `REMINDER_TIME_DESC`, `REMINDER_TIME_ASC`.

Example input: `{}`

### `smartleadmcp_fetch_master_inbox_replies`

Fetch master inbox replies · Read-only

Fetch email replies from master inbox with advanced filtering

Read only: yes. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `fetch_message_history` (`boolean`, optional): Include full message history. Default: `false`.
- `filters` (`object`, optional): No description.
- `limit` (`number`, optional): Number of results (1-20)
- `offset` (`number`, optional): Offset for pagination (min: 0)
- `sortBy` (`string`, optional): Sort order for results. One of: `REPLY_TIME_DESC`, `SENT_TIME_DESC`.

Example input: `{}`

### `smartleadmcp_fetch_master_inbox_scheduled_emails`

Fetch master inbox scheduled emails · Read-only

Fetch scheduled emails from master inbox

Read only: yes. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `fetch_message_history` (`boolean`, optional): Include full message history. Default: `false`.
- `filters` (`object`, optional): No description.
- `limit` (`number`, optional): Number of results (1-20)
- `offset` (`number`, optional): Offset for pagination (min: 0)
- `sortBy` (`string`, optional): Sort order for results. One of: `SCHEDULED_TIME_DESC`, `SCHEDULED_TIME_ASC`.

Example input: `{}`

### `smartleadmcp_fetch_master_inbox_sent_emails`

Fetch master inbox sent emails · Read-only

Fetch sent emails from master inbox with advanced filtering

Read only: yes. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `filters` (`object`, optional): No description.
- `limit` (`number`, optional): Number of results (1-20)
- `offset` (`number`, optional): Offset for pagination (min: 0)
- `sortBy` (`string`, optional): Sort order for results. One of: `REPLY_TIME_DESC`, `SENT_TIME_DESC`.

Example input: `{}`

### `smartleadmcp_fetch_master_inbox_snoozed_emails`

Fetch master inbox snoozed emails · Read-only

Fetch snoozed emails from master inbox

Read only: yes. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `fetch_message_history` (`boolean`, optional): Include full message history. Default: `false`.
- `filters` (`object`, optional): No description.
- `limit` (`number`, optional): Number of results (1-20)
- `offset` (`number`, optional): Offset for pagination (min: 0)
- `sortBy` (`string`, optional): Sort order for results. One of: `REPLY_TIME_DESC`, `SENT_TIME_DESC`.

Example input: `{}`

### `smartleadmcp_fetch_master_inbox_unread_replies`

Fetch master inbox unread replies · Read-only

Fetch unread email replies from master inbox

Read only: yes. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `fetch_message_history` (`boolean`, optional): Include full message history. Default: `false`.
- `filters` (`object`, optional): No description.
- `limit` (`number`, optional): Number of results (1-20)
- `offset` (`number`, optional): Offset for pagination (min: 0)
- `sortBy` (`string`, optional): Sort order for results. One of: `REPLY_TIME_DESC`, `SENT_TIME_DESC`.

Example input: `{}`

### `smartleadmcp_fetch_master_inbox_untracked_replies`

Fetch master inbox untracked replies · Read-only

Fetch untracked email replies that were not captured by campaigns

Read only: yes. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `fetchAttachments` (`boolean`, optional): Include attachments in response. Default: `false`.
- `fetchBody` (`boolean`, optional): Include full email body. Default: `false`.
- `from_email` (`string`, optional): Filter by sender email
- `limit` (`number`, optional): Number of results (1-100). Default: `20`.
- `offset` (`number`, optional): Offset for pagination. Default: `0`.
- `subject_line` (`string`, optional): Filter by subject line
- `to_email` (`string`, optional): Filter by recipient email

Example input: `{}`

### `smartleadmcp_get_all_clients`

Get all clients · Read-only

Get list of all clients

Read only: yes. Destructive: no. Idempotent (safe to retry): no.

Inputs: none.

Example input: `{}`

### `smartleadmcp_get_all_leads`

Get all leads · Read-only

Get all leads with advanced filtering options. IMPORTANT: the following filters require campaignId to also be set: status, emailStatus, emailAccountId, emailCampaignSeqId, campaignTagId, teamMemberId, replyDateFrom, replyDateTo. To filter by status across all campaigns, you must list campaigns first and call this per campaignId.

Read only: yes. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `campaignId` (`number`, optional): Filter by campaign ID. Required when using status, emailStatus, emailAccountId, emailCampaignSeqId, campaignTagId, teamMemberId, replyDateFrom or replyDateTo.
- `campaignTagId` (`number`, optional): Filter by campaign tag ID (REQUIRES campaignId).
- `clientId` (`number`, optional): Filter by client ID
- `emailAccountId` (`number`, optional): Filter by email account ID (REQUIRES campaignId).
- `emailCampaignSeqId` (`number`, optional): Filter by email sequence ID (REQUIRES campaignId).
- `emailStatus` (`string`, optional): Filter by email status (REQUIRES campaignId). One of: `is_opened`, `is_clicked`, `is_bounced`, `is_replied`, `is_unsubscribed`, `is_spam`, `is_accepted`, `not_replied`.
- `importedDate` (`string`, optional): Filter by imported date (ISO format)
- `lastSeenLeadId` (`number`, optional): For pagination, ID of last seen lead
- `leadCategoryIds` (`string`, optional): Comma-separated list of lead category IDs
- `leadEmail` (`string`, optional): Filter by lead email
- `leadType` (`string`, optional): Filter by lead type. One of: `active`, `yet_to_use`, `previously_active`, `archived`.
- `limit` (`number`, optional): Number of results to return (1-100, default 50)
- `listId` (`number`, optional): Filter by list ID
- `replyDateFrom` (`string`, optional): Filter replies from this date (ISO format) (REQUIRES campaignId).
- `replyDateTo` (`string`, optional): Filter replies to this date (ISO format) (REQUIRES campaignId).
- `status` (`string`, optional): Filter by lead status (REQUIRES campaignId). One of: `STARTED`, `INPROGRESS`, `STOPPED`, `PAUSED`, `BLOCKED`, `COMPLETED`.
- `teamMemberId` (`number`, optional): Filter by team member ID (REQUIRES campaignId).
- `unCategorized` (`number`, optional): Set to 1 to get uncategorized leads

Example input: `{}`

### `smartleadmcp_get_analytics_campaign_list`

Get analytics campaign list · Read-only

Get list of campaigns for analytics with optional client filtering

Read only: yes. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `client_ids` (`string`, optional): Comma-separated list of client IDs to filter by

Example input: `{}`

### `smartleadmcp_get_analytics_client_list`

Get analytics client list · Read-only

Get list of clients for analytics reporting

Read only: yes. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `client_ids` (`string`, optional): Comma-separated list of client IDs to filter by

Example input: `{}`

### `smartleadmcp_get_campaign_analytics`

Get campaign analytics · Read-only

Get comprehensive analytics for a campaign

Read only: yes. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `campaign_id` (`number`, required): The ID of the campaign

Example input: `{"campaign_id":1}`

### `smartleadmcp_get_campaign_analytics_by_date`

Get campaign analytics by date · Read-only

Get campaign analytics for a specific date range

Read only: yes. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `campaign_id` (`number`, required): The ID of the campaign
- `end_date` (`string`, required): End date in ISO format (YYYY-MM-DD)
- `start_date` (`string`, required): Start date in ISO format (YYYY-MM-DD)

Example input: `{"campaign_id":1,"end_date":"<end_date>","start_date":"<start_date>"}`

### `smartleadmcp_get_campaign_by_id`

Get campaign by ID · Read-only

Get a specific campaign by its ID

Read only: yes. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `id` (`number`, required): The ID of the campaign

Example input: `{"id":1}`

### `smartleadmcp_get_campaign_diagnostics`

Get campaign diagnostics · Read-only

Get comprehensive diagnostic information for a campaign. Includes sending status, configuration issues, and performance metrics.

Read only: yes. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `campaignId` (`number`, required): The ID of the campaign to diagnose

Example input: `{"campaignId":1}`

### `smartleadmcp_get_campaign_email_accounts`

Get campaign email accounts · Read-only

Get email accounts associated with a campaign

Read only: yes. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `campaign_id` (`number`, required): The ID of the campaign

Example input: `{"campaign_id":1}`

### `smartleadmcp_get_campaign_follow_up_reply_rate`

Get campaign follow up reply rate · Read-only

Get reply rates for each follow-up sequence to optimize email sequences

Read only: yes. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `end_date` (`string`, required): End date in ISO format (YYYY-MM-DD)
- `start_date` (`string`, required): Start date in ISO format (YYYY-MM-DD)
- `campaign_ids` (`string`, optional): Comma-separated list of campaign IDs to filter by
- `client_ids` (`string`, optional): Comma-separated list of client IDs to filter by
- `timezone` (`string`, optional): Timezone for date calculations (e.g., "America/New_York")

Example input: `{"end_date":"<end_date>","start_date":"<start_date>"}`

### `smartleadmcp_get_campaign_lead_message_history`

Get campaign lead message history · Read-only

Get complete message history for a specific lead in a campaign

Read only: yes. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `campaign_id` (`number`, required): The ID of the campaign
- `lead_id` (`number`, required): The ID of the lead
- `event_time_gt` (`string`, optional): Filter events after this time
- `show_plain_text_response` (`boolean`, optional): Show plain text version of emails

Example input: `{"campaign_id":1,"lead_id":1}`

### `smartleadmcp_get_campaign_lead_overview`

Get campaign lead overview · Read-only

Get overview of all campaigns a lead is part of

Read only: yes. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `leadId` (`number`, required): The lead ID

Example input: `{"leadId":1}`

### `smartleadmcp_get_campaign_lead_statistics`

Get campaign lead statistics · Read-only

Get lead-level statistics showing individual lead engagement metrics

Read only: yes. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `campaign_id` (`number`, required): The ID of the campaign
- `event_time_gt` (`string`, optional): Filter leads with events after this time
- `limit` (`number`, optional): Limit for pagination (max 100)
- `offset` (`number`, optional): Offset for pagination

Example input: `{"campaign_id":1}`

### `smartleadmcp_get_campaign_lead_to_reply_time`

Get campaign lead to reply time · Read-only

Get metrics on time taken from first email sent to receiving a reply

Read only: yes. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `end_date` (`string`, required): End date in ISO format (YYYY-MM-DD)
- `start_date` (`string`, required): Start date in ISO format (YYYY-MM-DD)
- `campaign_ids` (`string`, optional): Comma-separated list of campaign IDs to filter by
- `client_ids` (`string`, optional): Comma-separated list of client IDs to filter by
- `timezone` (`string`, optional): Timezone for date calculations (e.g., "America/New_York")

Example input: `{"end_date":"<end_date>","start_date":"<start_date>"}`

### `smartleadmcp_get_campaign_leads`

Get campaign leads · Read-only

List leads in a campaign as compact rows (lead_id, campaign_lead_map_id, email, name, company, status, lead_category_id, is_unsubscribed, created_at), with the total lead count. Paginated: 50 per page by default (max 100). For full lead records including custom_fields, use export_campaign_leads.

Read only: yes. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `campaign_id` (`number`, required): The ID of the campaign
- `emailStatus` (`string`, optional): Filter by email engagement. One of: `is_opened`, `is_clicked`, `is_bounced`, `is_replied`, `is_unsubscribed`, `is_accepted`, `not_replied`, `is_sender_bounced`.
- `lead_category_id` (`integer`, optional): Filter by lead category ID (see get_lead_categories)
- `limit` (`integer`, optional): Page size (1-100, default 50). Default: `50`.
- `offset` (`integer`, optional): Number of leads to skip (default 0). Default: `0`.
- `status` (`string`, optional): Filter by lead status in this campaign. One of: `STARTED`, `INPROGRESS`, `COMPLETED`, `PAUSED`, `STOPPED`.

Example input: `{"campaign_id":1}`

### `smartleadmcp_get_campaign_leads_before_first_reply`

Get campaign leads before first reply · Read-only

Get metrics on how many leads are contacted before receiving the first reply

Read only: yes. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `end_date` (`string`, required): End date in ISO format (YYYY-MM-DD)
- `start_date` (`string`, required): Start date in ISO format (YYYY-MM-DD)
- `campaign_ids` (`string`, optional): Comma-separated list of campaign IDs to filter by
- `client_ids` (`string`, optional): Comma-separated list of client IDs to filter by
- `timezone` (`string`, optional): Timezone for date calculations (e.g., "America/New_York")

Example input: `{"end_date":"<end_date>","start_date":"<start_date>"}`

### `smartleadmcp_get_campaign_leads_history`

Get campaign leads history · Read-only

Get message history for multiple leads in a campaign

Read only: yes. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `campaign_id` (`number`, required): The ID of the campaign
- `event_time_gt` (`string`, optional): Filter events after this time
- `lead_ids` (`array`, optional): Array of lead IDs to get history for

Example input: `{"campaign_id":1}`

### `smartleadmcp_get_campaign_mailbox_statistics`

Get campaign mailbox statistics · Read-only

Get mailbox-level performance statistics for a campaign

Read only: yes. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `campaign_id` (`number`, required): The ID of the campaign
- `client_id` (`number`, optional): Optional client ID filter
- `end_date` (`string`, optional): End date for statistics
- `limit` (`number`, optional): Limit for pagination (max 20)
- `offset` (`number`, optional): Offset for pagination
- `start_date` (`string`, optional): Start date for statistics
- `time_zone` (`string`, optional): Timezone for date calculations

Example input: `{"campaign_id":1}`

### `smartleadmcp_get_campaign_overall_stats`

Get campaign overall stats · Read-only

Get campaign-wise performance metrics and statistics

Read only: yes. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `end_date` (`string`, required): End date in ISO format (YYYY-MM-DD)
- `start_date` (`string`, required): Start date in ISO format (YYYY-MM-DD)
- `campaign_ids` (`string`, optional): Comma-separated list of campaign IDs to filter by
- `client_ids` (`string`, optional): Comma-separated list of client IDs to filter by
- `full_data` (`string`, optional): Whether to return full detailed data
- `limit` (`string`, optional): Number of results to return
- `offset` (`string`, optional): Number of results to skip for pagination
- `timezone` (`string`, optional): Timezone for date calculations (e.g., "America/New_York")

Example input: `{"end_date":"<end_date>","start_date":"<start_date>"}`

### `smartleadmcp_get_campaign_response_stats`

Get campaign response stats · Read-only

Get detailed response statistics including categorization and sentiment analysis

Read only: yes. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `end_date` (`string`, required): End date in ISO format (YYYY-MM-DD)
- `start_date` (`string`, required): Start date in ISO format (YYYY-MM-DD)
- `campaign_ids` (`string`, optional): Comma-separated list of campaign IDs to filter by
- `client_ids` (`string`, optional): Comma-separated list of client IDs to filter by
- `full_data` (`string`, optional): Whether to return full detailed data
- `timezone` (`string`, optional): Timezone for date calculations (e.g., "America/New_York")

Example input: `{"end_date":"<end_date>","start_date":"<start_date>"}`

### `smartleadmcp_get_campaign_sending_volume_audit`

Get campaign sending volume audit · Read-only

Audit the sending volume for a campaign. Shows email sending patterns, volumes per day, and identifies potential issues.

Read only: yes. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `campaignId` (`number`, required): The ID of the campaign to audit

Example input: `{"campaignId":1}`

### `smartleadmcp_get_campaign_sequence_analytics`

Get campaign sequence analytics · Read-only

Get sequence-level analytics for a campaign

Read only: yes. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `campaign_id` (`number`, required): The ID of the campaign
- `end_date` (`string`, required): End date in ISO format (YYYY-MM-DD)
- `start_date` (`string`, required): Start date in ISO format (YYYY-MM-DD)
- `time_zone` (`string`, optional): Timezone for date calculations (e.g., "America/New_York")

Example input: `{"campaign_id":1,"end_date":"<end_date>","start_date":"<start_date>"}`

### `smartleadmcp_get_campaign_sequences`

Get campaign sequences · Read-only

Get email sequences for a campaign

Read only: yes. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `campaign_id` (`number`, required): The ID of the campaign

Example input: `{"campaign_id":1}`

### `smartleadmcp_get_campaign_stats`

Get campaign stats · Read-only

Get detailed statistics for a campaign including email performance metrics by sequence

Read only: yes. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `campaign_id` (`number`, required): The ID of the campaign
- `email_sequence_number` (`number`, optional): Filter by specific email sequence number (1-20)
- `email_status` (`string`, optional): Filter by email status. One of: `opened`, `clicked`, `replied`, `unsubscribed`, `bounced`.
- `limit` (`number`, optional): Limit for pagination (max 1000)
- `offset` (`number`, optional): Offset for pagination
- `sent_time_end_date` (`string`, optional): End date for filtering by sent time
- `sent_time_start_date` (`string`, optional): Start date for filtering by sent time

Example input: `{"campaign_id":1}`

### `smartleadmcp_get_campaign_status_stats`

Get campaign status stats · Read-only

Get statistics on campaign statuses (active, paused, completed, etc)

Read only: yes. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `client_ids` (`string`, optional): Comma-separated list of client IDs to filter by

Example input: `{}`

### `smartleadmcp_get_campaign_top_level_analytics_by_date`

Get campaign top level analytics by date · Read-only

Get top-level campaign analytics for a specific date range

Read only: yes. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `campaign_id` (`number`, required): The ID of the campaign
- `end_date` (`string`, required): End date in ISO format (YYYY-MM-DD)
- `start_date` (`string`, required): Start date in ISO format (YYYY-MM-DD)

Example input: `{"campaign_id":1,"end_date":"<end_date>","start_date":"<start_date>"}`

### `smartleadmcp_get_campaign_variant_statistics`

Get campaign variant statistics · Read-only

Get A/B test variant performance statistics for a campaign

Read only: yes. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `campaign_id` (`number`, required): The ID of the campaign
- `client_id` (`number`, optional): Optional client ID filter

Example input: `{"campaign_id":1}`

### `smartleadmcp_get_campaign_webhook_summary`

Get campaign webhook summary · Read-only

Get webhook execution summary and statistics for a campaign

Read only: yes. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `campaign_id` (`number`, required): The ID of the campaign
- `fromTime` (`string`, optional): Start date in ISO format
- `toTime` (`string`, optional): End date in ISO format

Example input: `{"campaign_id":1}`

### `smartleadmcp_get_campaign_webhooks`

Get campaign webhooks · Read-only

Get all webhooks configured for a campaign

Read only: yes. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `campaign_id` (`number`, required): The ID of the campaign

Example input: `{"campaign_id":1}`

### `smartleadmcp_get_campaigns`

Get campaigns · Read-only

List campaigns, newest first, as compact rows (id, name, status, client_id, parent_campaign_id, created_at). Paginated: returns 50 per page by default (max 100). Use name to find a campaign instead of paging through all of them. Use get_campaign_by_id for full settings and schedule.

Read only: yes. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `client_id` (`number`, optional): Filter campaigns by client ID
- `include_tags` (`boolean`, optional): Include campaign tags in the response. Default: `false`.
- `limit` (`integer`, optional): Page size (1-100, default 50). Default: `50`.
- `name` (`string`, optional): Filter by campaign name (case-insensitive partial match)
- `offset` (`integer`, optional): Number of campaigns to skip (default 0). Default: `0`.
- `status` (`string`, optional): Filter by campaign status. One of: `ACTIVE`, `PAUSED`, `DRAFTED`, `COMPLETED`, `STOPPED`, `ARCHIVED`.

Example input: `{}`

### `smartleadmcp_get_campaigns_by_lead_id`

Get campaigns by lead ID · Read-only

Get all campaigns associated with a specific lead

Read only: yes. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `lead_id` (`number`, required): The ID of the lead

Example input: `{"lead_id":1}`

### `smartleadmcp_get_client_month_wise_count`

Get client month wise count · Read-only

Get month-wise count of clients for trend analysis

Read only: yes. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `client_ids` (`string`, optional): Comma-separated list of client IDs to filter by

Example input: `{}`

### `smartleadmcp_get_client_overall_stats`

Get client overall stats · Read-only

Get client-wise performance metrics and statistics

Read only: yes. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `end_date` (`string`, required): End date in ISO format (YYYY-MM-DD)
- `start_date` (`string`, required): Start date in ISO format (YYYY-MM-DD)
- `client_ids` (`string`, optional): Comma-separated list of client IDs to filter by
- `filter` (`string`, optional): Additional filter criteria
- `full_data` (`string`, optional): Whether to return full detailed data
- `limit` (`string`, optional): Number of results to return
- `offset` (`string`, optional): Number of results to skip for pagination
- `timezone` (`string`, optional): Timezone for date calculations (e.g., "America/New_York")

Example input: `{"end_date":"<end_date>","start_date":"<start_date>"}`

### `smartleadmcp_get_day_wise_overall_stats`

Get day wise overall stats · Read-only

Get day-by-day breakdown of overall campaign statistics

Read only: yes. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `end_date` (`string`, required): End date in ISO format (YYYY-MM-DD)
- `start_date` (`string`, required): Start date in ISO format (YYYY-MM-DD)
- `campaign_ids` (`string`, optional): Comma-separated list of campaign IDs to filter by
- `client_ids` (`string`, optional): Comma-separated list of client IDs to filter by
- `timezone` (`string`, optional): Timezone for date calculations (e.g., "America/New_York")

Example input: `{"end_date":"<end_date>","start_date":"<start_date>"}`

### `smartleadmcp_get_day_wise_overall_stats_by_sent_time`

Get day wise overall stats by sent time · Read-only

Get day-wise statistics based on email sent time for time-based analysis

Read only: yes. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `end_date` (`string`, required): End date in ISO format (YYYY-MM-DD)
- `start_date` (`string`, required): Start date in ISO format (YYYY-MM-DD)
- `timezone` (`string`, required): Timezone for date calculations (e.g., "America/New_York")
- `campaign_ids` (`string`, optional): Comma-separated list of campaign IDs to filter by
- `client_ids` (`string`, optional): Comma-separated list of client IDs to filter by

Example input: `{"end_date":"<end_date>","start_date":"<start_date>","timezone":"America/New_York"}`

### `smartleadmcp_get_day_wise_positive_reply_stats`

Get day wise positive reply stats · Read-only

Get day-by-day breakdown of positive reply statistics and sentiment analysis

Read only: yes. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `end_date` (`string`, required): End date in ISO format (YYYY-MM-DD)
- `start_date` (`string`, required): Start date in ISO format (YYYY-MM-DD)
- `campaign_ids` (`string`, optional): Comma-separated list of campaign IDs to filter by
- `client_ids` (`string`, optional): Comma-separated list of client IDs to filter by
- `timezone` (`string`, optional): Timezone for date calculations (e.g., "America/New_York")

Example input: `{"end_date":"<end_date>","start_date":"<start_date>"}`

### `smartleadmcp_get_day_wise_positive_reply_stats_by_sent_time`

Get day wise positive reply stats by sent time · Read-only

Get day-wise positive reply statistics based on email sent time

Read only: yes. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `end_date` (`string`, required): End date in ISO format (YYYY-MM-DD)
- `start_date` (`string`, required): Start date in ISO format (YYYY-MM-DD)
- `timezone` (`string`, required): Timezone for date calculations (e.g., "America/New_York")
- `campaign_ids` (`string`, optional): Comma-separated list of campaign IDs to filter by
- `client_ids` (`string`, optional): Comma-separated list of client IDs to filter by

Example input: `{"end_date":"<end_date>","start_date":"<start_date>","timezone":"America/New_York"}`

### `smartleadmcp_get_domain_block_list`

Get domain block list · Read-only

Get list of blocked domains with filtering options

Read only: yes. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `filter_client_id` (`number`, optional): Filter by client ID
- `filter_email_or_domain` (`string`, optional): Filter by email or domain
- `filter_email_with_domain` (`string`, optional): Filter by email with domain
- `limit` (`number`, optional): Limit for pagination (1-1000)
- `offset` (`number`, optional): Offset for pagination (min: 0)

Example input: `{}`

### `smartleadmcp_get_email_account_by_id`

Get email account by ID · Read-only

Get all the details of a specific email account by ID

Read only: yes. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `id` (`number`, required): The ID of the email account to get details of
- `fetch_campaigns` (`boolean`, optional): Whether to fetch the campaigns associated with this email account (default: false)

Example input: `{"id":1}`

### `smartleadmcp_get_email_accounts`

Get email accounts · Read-only

Get all email accounts with optional filtering

Read only: yes. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `client_id` (`number`, optional): Filter by client ID
- `limit` (`number`, optional): Limit for pagination (1-100)
- `offset` (`number`, optional): Offset for pagination (min: 0)
- `username` (`string`, optional): Filter by username/email

Example input: `{}`

### `smartleadmcp_get_email_warmup_stats`

Get email warmup stats · Read-only

Get warmup statistics for an email account

Read only: yes. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `email_account_id` (`number`, required): The ID of the email account

Example input: `{"email_account_id":1}`

### `smartleadmcp_get_global_leads`

Get global leads · Read-only

Get global leads with filtering options

Read only: yes. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `created_at_gt` (`string`, optional): Filter leads created after this date/time
- `email` (`string`, optional): Filter by email address
- `limit` (`number`, optional): Limit for pagination (1-500)
- `offset` (`number`, optional): Offset for pagination (min: 0)

Example input: `{}`

### `smartleadmcp_get_lead_by_email`

Get lead by email · Read-only

Get lead information by email address

Read only: yes. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `email` (`string`, required): Email address of the lead

Example input: `{"email":"<email>"}`

### `smartleadmcp_get_lead_categories`

Get lead categories · Read-only

Get all available lead categories

Read only: yes. Destructive: no. Idempotent (safe to retry): no.

Inputs: none.

Example input: `{}`

### `smartleadmcp_get_lead_category_wise_response`

Get lead category wise response · Read-only

Get lead response statistics broken down by category for response analysis

Read only: yes. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `end_date` (`string`, required): End date in ISO format (YYYY-MM-DD)
- `start_date` (`string`, required): Start date in ISO format (YYYY-MM-DD)
- `campaign_ids` (`string`, optional): Comma-separated list of campaign IDs to filter by
- `client_ids` (`string`, optional): Comma-separated list of client IDs to filter by
- `timezone` (`string`, optional): Timezone for date calculations (e.g., "America/New_York")

Example input: `{"end_date":"<end_date>","start_date":"<start_date>"}`

### `smartleadmcp_get_lead_overall_stats`

Get lead overall stats · Read-only

Get comprehensive lead statistics including status distribution and engagement metrics

Read only: yes. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `end_date` (`string`, required): End date in ISO format (YYYY-MM-DD)
- `start_date` (`string`, required): Start date in ISO format (YYYY-MM-DD)
- `campaign_ids` (`string`, optional): Comma-separated list of campaign IDs to filter by
- `client_ids` (`string`, optional): Comma-separated list of client IDs to filter by
- `timezone` (`string`, optional): Timezone for date calculations (e.g., "America/New_York")

Example input: `{"end_date":"<end_date>","start_date":"<start_date>"}`

### `smartleadmcp_get_lead_sequence_details`

Get lead sequence details · Read-only

Get detailed sequence information for a specific lead in a campaign

Read only: yes. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `leadMapId` (`number`, required): The lead map ID
- `campaignId` (`number`, optional): Optional campaign ID for context

Example input: `{"leadMapId":1}`

### `smartleadmcp_get_mailbox_domain_wise_health_metrics`

Get mailbox domain wise health metrics · Read-only

Get email health metrics grouped by domain for monitoring domain reputation

Read only: yes. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `end_date` (`string`, required): End date in ISO format (YYYY-MM-DD)
- `start_date` (`string`, required): Start date in ISO format (YYYY-MM-DD)
- `campaign_ids` (`string`, optional): Comma-separated list of campaign IDs to filter by
- `client_ids` (`string`, optional): Comma-separated list of client IDs to filter by
- `full_data` (`string`, optional): Whether to return full detailed data
- `limit` (`string`, optional): Number of results to return
- `offset` (`string`, optional): Number of results to skip for pagination
- `timezone` (`string`, optional): Timezone for date calculations (e.g., "America/New_York")

Example input: `{"end_date":"<end_date>","start_date":"<start_date>"}`

### `smartleadmcp_get_mailbox_name_wise_health_metrics`

Get mailbox name wise health metrics · Read-only

Get email health metrics grouped by mailbox name for monitoring deliverability

Read only: yes. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `end_date` (`string`, required): End date in ISO format (YYYY-MM-DD)
- `start_date` (`string`, required): Start date in ISO format (YYYY-MM-DD)
- `campaign_ids` (`string`, optional): Comma-separated list of campaign IDs to filter by
- `client_ids` (`string`, optional): Comma-separated list of client IDs to filter by
- `full_data` (`string`, optional): Whether to return full detailed data
- `limit` (`string`, optional): Number of results to return
- `offset` (`string`, optional): Number of results to skip for pagination
- `timezone` (`string`, optional): Timezone for date calculations (e.g., "America/New_York")

Example input: `{"end_date":"<end_date>","start_date":"<start_date>"}`

### `smartleadmcp_get_mailbox_overall_stats`

Get mailbox overall stats · Read-only

Get overall mailbox statistics including health scores and capacity

Read only: yes. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `client_ids` (`string`, optional): Comma-separated list of client IDs to filter by

Example input: `{}`

### `smartleadmcp_get_mailbox_provider_wise_performance`

Get mailbox provider wise performance · Read-only

Get email performance metrics grouped by email provider (Gmail, Outlook, etc)

Read only: yes. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `end_date` (`string`, required): End date in ISO format (YYYY-MM-DD)
- `start_date` (`string`, required): Start date in ISO format (YYYY-MM-DD)
- `campaign_ids` (`string`, optional): Comma-separated list of campaign IDs to filter by
- `client_ids` (`string`, optional): Comma-separated list of client IDs to filter by
- `full_data` (`string`, optional): Whether to return full detailed data
- `timezone` (`string`, optional): Timezone for date calculations (e.g., "America/New_York")

Example input: `{"end_date":"<end_date>","start_date":"<start_date>"}`

### `smartleadmcp_get_master_inbox_by_id`

Get master inbox by ID · Read-only

Get detailed information about a specific master inbox email by ID

Read only: yes. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `id` (`number`, required): The master inbox item ID

Example input: `{"id":1}`

### `smartleadmcp_get_overall_stats_v2`

Get overall stats V2 · Read-only

Get comprehensive overall statistics for campaigns with advanced filtering options

Read only: yes. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `end_date` (`string`, required): End date in ISO format (YYYY-MM-DD)
- `start_date` (`string`, required): Start date in ISO format (YYYY-MM-DD)
- `campaign_ids` (`string`, optional): Comma-separated list of campaign IDs to filter by
- `client_ids` (`string`, optional): Comma-separated list of client IDs to filter by
- `full_data` (`string`, optional): Whether to return full detailed data
- `is_agency` (`string`, optional): Filter for agency accounts
- `timezone` (`string`, optional): Timezone for date calculations (e.g., "America/New_York")

Example input: `{"end_date":"<end_date>","start_date":"<start_date>"}`

### `smartleadmcp_get_team_board_overall_stats`

Get team board overall stats · Read-only

Get team member performance statistics for team management and optimization

Read only: yes. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `end_date` (`string`, required): End date in ISO format (YYYY-MM-DD)
- `start_date` (`string`, required): Start date in ISO format (YYYY-MM-DD)
- `campaign_ids` (`string`, optional): Comma-separated list of campaign IDs to filter by
- `client_ids` (`string`, optional): Comma-separated list of client IDs to filter by
- `full_data` (`string`, optional): Whether to return full detailed data
- `timezone` (`string`, optional): Timezone for date calculations (e.g., "America/New_York")

Example input: `{"end_date":"<end_date>","start_date":"<start_date>"}`

### `smartleadmcp_investigate_lead`

Investigate lead · Read-only

Investigate a specific lead to understand their journey, interactions, and any issues.

Read only: yes. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `leadId` (`number`, required): The ID of the lead to investigate

Example input: `{"leadId":1}`

### `smartleadmcp_sd_get_email_headers`

Smart Delivery: Get email headers · Read-only

Headers of the copy received at the seed inbox (SPF/DKIM/DMARC results, spam verdict headers, routing).

Read only: yes. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `assignment_id` (`integer`, required): Email assignment ID (from sd_list_run_emails)
- `run_id` (`string`, required): Run ID (UUID, from sd_get_test or sd_get_test_history)

Example input: `{"assignment_id":1,"run_id":"<run_id>"}`

### `smartleadmcp_sd_get_email_trace`

Smart Delivery: Get email trace · Read-only

Timeline of one test email: sent, delivered, found (or missing / bounced), with the provider responses.

Read only: yes. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `assignment_id` (`integer`, required): Email assignment ID (from sd_list_run_emails)
- `run_id` (`string`, required): Run ID (UUID, from sd_get_test or sd_get_test_history)

Example input: `{"assignment_id":1,"run_id":"<run_id>"}`

### `smartleadmcp_sd_get_limits`

Smart Delivery: Get limits · Read-only

Smart Delivery plan limits: run credits left this billing period, max sender mailboxes per test, seeds per sender per provider. Check before creating a test. If credits look stale (e.g. after a plan change), use sd_refresh_limits.

Read only: yes. Destructive: no. Idempotent (safe to retry): no.

Inputs: none.

Example input: `{}`

### `smartleadmcp_sd_get_report_summary`

Smart Delivery: Get report summary · Read-only

Account-wide Smart Delivery placement totals (inbox / spam / missing ...) across all tests over a date range (max 400 days).

Read only: yes. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `from` (`string`, optional): Start day, YYYY-MM-DD (UTC). Default: 29 days before to
- `to` (`string`, optional): End day, YYYY-MM-DD (UTC), inclusive. Default: today

Example input: `{}`

### `smartleadmcp_sd_get_run`

Smart Delivery: Get run · Read-only

Get one Smart Delivery run: status, timing, skipped senders, and email counts by placement and send status. Heavy for large runs (the API returns every email to count them); for live counts sd_get_run_placement is lighter. Per-email rows: sd_list_run_emails. Results: sd_get_run_report.

Read only: yes. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `run_id` (`string`, required): Run ID (UUID, from sd_get_test or sd_get_test_history)

Example input: `{"run_id":"<run_id>"}`

### `smartleadmcp_sd_get_run_placement`

Smart Delivery: Get run placement · Read-only

Live placement of a run while it collects (inbox / spam / missing ... so far). For a finished run use sd_get_run_report.

Read only: yes. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `run_id` (`string`, required): Run ID (UUID, from sd_get_test or sd_get_test_history)

Example input: `{"run_id":"<run_id>"}`

### `smartleadmcp_sd_get_run_report`

Smart Delivery: Get run report · Read-only

Report of a finished run: score, band, headline, recommendations, placement counts, time to inbox, by provider and by sender. {ready:false} while the run is still collecting. include_diagnostics adds DNS, blacklist listings, content and SpamAssassin checks.

Read only: yes. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `run_id` (`string`, required): Run ID (UUID, from sd_get_test or sd_get_test_history)
- `include_diagnostics` (`boolean`, optional): Add DNS, blacklist, content and spam checks. Default: `false`.

Example input: `{"run_id":"<run_id>"}`

### `smartleadmcp_sd_get_test`

Smart Delivery: Get test · Read-only

Get a Smart Delivery test: settings, schedule, providers, sender mailboxes and its latest 10 runs (newest first). Use sd_get_run_report for a run's results and sd_get_test_history for older runs.

Read only: yes. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `test_id` (`string`, required): Test ID (UUID, from sd_list_tests)

Example input: `{"test_id":"<test_id>"}`

### `smartleadmcp_sd_get_test_history`

Smart Delivery: Get test history · Read-only

Run reports of one test over a date range (oldest first within a page; the cursor steps back to older runs). Good for trends.

Read only: yes. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `test_id` (`string`, required): Test ID (UUID, from sd_list_tests)
- `cursor` (`string`, optional): nextCursor from the previous page; omit for the first page
- `from` (`string`, optional): Start day, YYYY-MM-DD (UTC). Default: 29 days before to
- `limit` (`integer`, optional): Runs per page (1-100, default 20). Default: `20`.
- `to` (`string`, optional): End day, YYYY-MM-DD (UTC), inclusive. Default: today

Example input: `{"test_id":"<test_id>"}`

### `smartleadmcp_sd_list_folders`

Smart Delivery: List folders · Read-only

List Smart Delivery test folders.

Read only: yes. Destructive: no. Idempotent (safe to retry): no.

Inputs: none.

Example input: `{}`

### `smartleadmcp_sd_list_providers`

Smart Delivery: List providers · Read-only

List the inbox providers a test can measure placement at (Gmail, Outlook, ...). Use their ids as provider_ids in sd_create_test.

Read only: yes. Destructive: no. Idempotent (safe to retry): no.

Inputs: none.

Example input: `{}`

### `smartleadmcp_sd_list_run_emails`

Smart Delivery: List run emails · Read-only

Per-email results of a run (sender, provider, placement, send status, error). Cursor-paginated. Filter by placement (e.g. SPAM), provider or sender instead of paging through everything.

Read only: yes. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `run_id` (`string`, required): Run ID (UUID, from sd_get_test or sd_get_test_history)
- `cursor` (`string`, optional): nextCursor from the previous page; omit for the first page
- `limit` (`integer`, optional): Page size (1-200, default 25). Default: `25`.
- `placement` (`string`, optional): No description. One of: `INBOX`, `TAB`, `SPAM`, `MISSING`, `UNREADABLE`, `NOT_SENT`, `UNCONFIRMED`, `PENDING`, `BOUNCED`.
- `provider` (`string`, optional): Provider code (sd_list_providers)
- `sender_id` (`integer`, optional): Sender email account id

Example input: `{"run_id":"<run_id>"}`

### `smartleadmcp_sd_list_run_seeds`

Smart Delivery: List run seeds · Read-only

Seed inboxes a run sent to (provider and sending mailbox for each).

Read only: yes. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `run_id` (`string`, required): Run ID (UUID, from sd_get_test or sd_get_test_history)

Example input: `{"run_id":"<run_id>"}`

### `smartleadmcp_sd_list_tests`

Smart Delivery: List tests · Read-only

List Smart Delivery placement tests, newest first, each with its latest report score. Cursor-paginated. Filter by status, type or folder rather than paging through everything.

Read only: yes. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `cursor` (`string`, optional): nextCursor from the previous page; omit for the first page
- `folder_id` (`integer`, optional): Folder ID (from sd_list_folders)
- `limit` (`integer`, optional): Page size (1-100, default 20). Default: `20`.
- `status` (`string`, optional): No description. One of: `ACTIVE`, `PAUSED`, `COMPLETED`, `STOPPED`.
- `type` (`string`, optional): MANUAL = one run; AUTO = scheduled runs. One of: `MANUAL`, `AUTO`.

Example input: `{}`

### `smartleadmcp_sp_export_contacts`

Smart Prospect: Export contacts · Read-only

Export Smart Prospect contacts as CSV for a given filter ID with optional filtering

Read only: yes. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `filter_id` (`string`, required): Filter ID to export contacts for
- `catch_all_status` (`string`, optional): Filter by catch-all sub-status
- `chunk_size` (`string`, optional): Records per chunk (default 5000)
- `limit` (`string`, optional): Max records to export (all if not provided)
- `search` (`string`, optional): Filter by name
- `verification_status` (`string`, optional): Filter by verification status. One of: `valid`, `catch_all`, `invalid`.

Example input: `{"filter_id":"<filter_id>"}`

### `smartleadmcp_sp_get_all_contacts`

Smart Prospect: Get all contacts · Read-only

Retrieve all contacts for a filter ID in email_leads format suitable for campaign import. Provide either filter_id or lead_ids

Read only: yes. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `catch_all_status` (`string`, optional): Filter by catch-all sub-status
- `filter_id` (`number`, optional): Filter ID to get all contacts for
- `lead_ids` (`array`, optional): Array of adapt_ids to retrieve
- `verification_status` (`string`, optional): Filter by email verification status. One of: `valid`, `catch_all`, `invalid`.

Example input: `{}`

### `smartleadmcp_sp_get_cities`

Smart Prospect: Get cities · Read-only

List all active cities for Smart Prospect search filters with pagination, search, and optional state/country filtering

Read only: yes. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `country` (`string`, optional): Filter by country name(s), comma-separated. Requires state parameter
- `limit` (`string`, optional): Number of records (1-100, default "10")
- `offset` (`string`, optional): Records to skip (default "0")
- `search` (`string`, optional): Filter city names starting with this value
- `state` (`string`, optional): Filter by state name(s), comma-separated (e.g., "california,texas")

Example input: `{}`

### `smartleadmcp_sp_get_company_autocomplete`

Smart Prospect: Get company autocomplete · Read-only

Search company names from Elasticsearch for autocomplete in Smart Prospect

Read only: yes. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `search` (`string`, required): Company name to search for
- `limit` (`string`, optional): Number of results (default "100")
- `offset` (`string`, optional): Records to skip (default "0")

Example input: `{"search":"<search>"}`

### `smartleadmcp_sp_get_contacts`

Smart Prospect: Get contacts · Read-only

Retrieve previously fetched Smart Prospect contacts by filter ID or adapt IDs, with optional filtering by verification status and pagination

Read only: yes. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `catch_all_status` (`string`, optional): Filter by catch-all sub-status. One of: `catch_all_verified`, `catch_all_soft_bounced`, `catch_all_hard_bounced`, `catch_all_unknown`, `catch_all_bounced`.
- `filter_id` (`number`, optional): Filter ID to get contacts for
- `id` (`array`, optional): Array of adapt_ids (max 200)
- `limit` (`number`, optional): Records to return (1-1000)
- `offset` (`number`, optional): Records to skip (min 0)
- `search` (`string`, optional): Filter by first_name, last_name, or full_name
- `verification_status` (`string`, optional): Filter by email verification status. One of: `valid`, `catch_all`, `invalid`.

Example input: `{}`

### `smartleadmcp_sp_get_countries`

Smart Prospect: Get countries · Read-only

List all active countries for Smart Prospect search filters with pagination and search

Read only: yes. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `limit` (`string`, optional): Number of records (1-100, default "10")
- `offset` (`string`, optional): Records to skip (default "0")
- `search` (`string`, optional): Filter country names starting with this value

Example input: `{}`

### `smartleadmcp_sp_get_departments`

Smart Prospect: Get departments · Read-only

List all active departments for Smart Prospect search filters with pagination and search

Read only: yes. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `limit` (`string`, optional): Number of records (1-100, default "10")
- `offset` (`string`, optional): Records to skip (default "0")
- `search` (`string`, optional): Filter department names starting with this value

Example input: `{}`

### `smartleadmcp_sp_get_domain_autocomplete`

Smart Prospect: Get domain autocomplete · Read-only

Search domain names from Elasticsearch for autocomplete in Smart Prospect

Read only: yes. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `search` (`string`, required): Domain name to search for
- `limit` (`string`, optional): Number of results (default "100")
- `offset` (`string`, optional): Records to skip (default "0")

Example input: `{"search":"<search>"}`

### `smartleadmcp_sp_get_fetched_leads`

Smart Prospect: Get fetched leads · Read-only

Retrieve the user's fetched lead records (searches where contacts were actually fetched/revealed)

Read only: yes. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `limit` (`string`, optional): Records per page (default "10")
- `offset` (`string`, optional): Records to skip (default "0")

Example input: `{}`

### `smartleadmcp_sp_get_head_counts`

Smart Prospect: Get head counts · Read-only

List all active employee headcount ranges for Smart Prospect search filters

Read only: yes. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `limit` (`string`, optional): Number of records (1-100, default "10")
- `offset` (`string`, optional): Records to skip (default "0")
- `search` (`string`, optional): Filter head count ranges starting with this value

Example input: `{}`

### `smartleadmcp_sp_get_industries`

Smart Prospect: Get industries · Read-only

List all active industries for Smart Prospect search filters with pagination, search, and optional sub-industry inclusion

Read only: yes. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `limit` (`string`, optional): Number of records (1-100, default "10")
- `offset` (`string`, optional): Records to skip (default "0")
- `search` (`string`, optional): Filter industry names starting with this value
- `withSubIndustry` (`string`, optional): Set to "true" to include sub-industries for each industry

Example input: `{}`

### `smartleadmcp_sp_get_job_title_autocomplete`

Smart Prospect: Get job title autocomplete · Read-only

Search job titles from Elasticsearch for autocomplete in Smart Prospect

Read only: yes. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `search` (`string`, required): Job title to search for
- `limit` (`string`, optional): Number of results (default "100")
- `offset` (`string`, optional): Records to skip (default "0")

Example input: `{"search":"<search>"}`

### `smartleadmcp_sp_get_keywords_autocomplete`

Smart Prospect: Get keywords autocomplete · Read-only

Search company keywords from Elasticsearch for autocomplete in Smart Prospect

Read only: yes. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `search` (`string`, required): Keyword to search for
- `limit` (`string`, optional): Number of results (default "100")
- `offset` (`string`, optional): Records to skip (default "0")

Example input: `{"search":"<search>"}`

### `smartleadmcp_sp_get_levels`

Smart Prospect: Get levels · Read-only

List all active seniority levels for Smart Prospect search filters (e.g., C-Level, VP, Director)

Read only: yes. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `limit` (`string`, optional): Number of records (1-100, default "10")
- `offset` (`string`, optional): Records to skip (default "0")
- `search` (`string`, optional): Filter level names starting with this value

Example input: `{}`

### `smartleadmcp_sp_get_pending_count`

Smart Prospect: Get pending count · Read-only

Get the number of contacts still pending email discovery for a Smart Prospect filter

Read only: yes. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `filter_id` (`string`, required): Filter ID to check pending count for

Example input: `{"filter_id":"<filter_id>"}`

### `smartleadmcp_sp_get_recent_searches`

Smart Prospect: Get recent searches · Read-only

Retrieve the user's recent (unsaved) Smart Prospect searches with pagination

Read only: yes. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `limit` (`string`, optional): Records per page (default "10")
- `offset` (`string`, optional): Records to skip (default "0")

Example input: `{}`

### `smartleadmcp_sp_get_reply_analytics`

Smart Prospect: Get reply analytics · Read-only

Get Smart Prospect reply analytics comparing current month vs previous month

Read only: yes. Destructive: no. Idempotent (safe to retry): no.

Inputs: none.

Example input: `{}`

### `smartleadmcp_sp_get_revenue_ranges`

Smart Prospect: Get revenue ranges · Read-only

Get all active revenue range options for Smart Prospect search filters

Read only: yes. Destructive: no. Idempotent (safe to retry): no.

Inputs: none.

Example input: `{}`

### `smartleadmcp_sp_get_saved_searches`

Smart Prospect: Get saved searches · Read-only

Retrieve the user's saved Smart Prospect searches with pagination

Read only: yes. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `limit` (`string`, optional): Records per page (default "10")
- `offset` (`string`, optional): Records to skip (default "0")

Example input: `{}`

### `smartleadmcp_sp_get_search_analytics`

Smart Prospect: Get search analytics · Read-only

Get Smart Prospect search and credit usage analytics including leads found, emails fetched, available credits, and daily limits

Read only: yes. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `filter_id` (`string`, optional): Optional filter ID to get filter-specific analytics

Example input: `{}`

### `smartleadmcp_sp_get_states`

Smart Prospect: Get states · Read-only

List all active states for Smart Prospect search filters with pagination, search, and optional country filtering

Read only: yes. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `country` (`string`, optional): Filter by country name(s), comma-separated (e.g., "india,usa,canada")
- `limit` (`string`, optional): Number of records (1-100, default "10")
- `offset` (`string`, optional): Records to skip (default "0")
- `search` (`string`, optional): Filter state names starting with this value

Example input: `{}`

### `smartleadmcp_sp_get_sub_industries`

Smart Prospect: Get sub industries · Read-only

List all active sub-industries for Smart Prospect search filters with pagination, search, and optional industry filtering

Read only: yes. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `industry_id` (`string`, optional): Filter by parent industry ID or comma-separated IDs (e.g., "1,2,3")
- `limit` (`string`, optional): Number of records (1-100, default "10")
- `offset` (`string`, optional): Records to skip (default "0")
- `search` (`string`, optional): Filter sub-industry names starting with this value

Example input: `{}`

### `smartleadmcp_sp_get_technologies`

Smart Prospect: Get technologies · Read-only

List all active technologies for Smart Prospect search filters with pagination and search

Read only: yes. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `limit` (`string`, optional): Number of records (1-100, default "10")
- `offset` (`string`, optional): Records to skip (default "0")
- `search` (`string`, optional): Filter technology names starting with this value

Example input: `{}`

### `smartleadmcp_sp_search_contacts`

Smart Prospect: Search contacts · Read-only

Search the Smart Prospect contact database using multiple filter criteria. Returns matching contacts from Elasticsearch. Does NOT deduct credits - this is a search/preview operation

Read only: yes. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `limit` (`number`, required): Results per page (1-500)
- `city` (`array`, optional): City filters (max 2000)
- `companyDomain` (`array`, optional): Company domain filters (max 2000)
- `companyDomainExactMatch` (`boolean`, optional): Exact match for company domain filter
- `companyExactMatch` (`boolean`, optional): Exact match for company filter
- `companyHeadCount` (`array`, optional): Employee range filters (max 2000)
- `companyIndustry` (`array`, optional): Industry filters (max 2000)
- `companyKeyword` (`array`, optional): Company keyword filters (max 2000)
- `companyName` (`array`, optional): Company name filters (max 2000)
- `companyRevenue` (`array`, optional): Revenue range filters (max 2000)
- `companySubIndustry` (`array`, optional): Sub-industry filters (max 2000)
- `country` (`array`, optional): Country filters (max 2000)
- `department` (`array`, optional): Department filters (max 2000)
- `dontDisplayOwnedContact` (`boolean`, optional): Exclude contacts already fetched by user
- `excludeCompany` (`array`, optional): Exclude companies (max 2000)
- `excludeCompanyDomain` (`array`, optional): Exclude company domains (max 2000)
- `excludeTitle` (`array`, optional): Exclude contacts with these titles (max 2000)
- `firstName` (`array`, optional): First name filters (max 2000)
- `includeCompany` (`array`, optional): Include companies (max 2000)
- `includeCompanyDomain` (`array`, optional): Include company domains (max 2000)
- `includeTitle` (`array`, optional): Include contacts with these titles (max 2000)
- `lastName` (`array`, optional): Last name filters (max 2000)
- `level` (`array`, optional): Seniority level filters (max 2000)
- `linkedin_url` (`array`, optional): Search by LinkedIn URL (max 100)
- `name` (`array`, optional): Full name filters (max 2000)
- `person_lookalike_id` (`array`, optional): Find similar people by adapt IDs (max 100)
- `scroll_id` (`string`, optional): Cursor for pagination from previous response
- `state` (`array`, optional): State filters (max 2000)
- `title` (`array`, optional): Job title filters (max 2000)
- `titleExactMatch` (`boolean`, optional): Exact match for title filter

Example input: `{"limit":1}`

### `smartleadmcp_add_domain_block_list`

Add domain block list · Write

Add domains to the block list to prevent sending emails to those domains

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `domains` (`array`, required): Array of domains to block
- `client_id` (`number`, optional): Optional client ID for client-specific block list

Example input: `{"domains":[]}`

### `smartleadmcp_add_email_accounts_to_campaign`

Add email accounts to campaign · Write

Add email accounts to a campaign for sending

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `campaign_id` (`number`, required): The ID of the campaign
- `email_account_ids` (`array`, required): Array of email account IDs to add
- `auto_adjust_warmup` (`boolean`, optional): Auto-adjust warmup settings

Example input: `{"campaign_id":1,"email_account_ids":[]}`

### `smartleadmcp_add_tags_to_email_accounts`

Add tags to email accounts · Write

Add tags to multiple email accounts

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `email_account_ids` (`array`, required): Array of email account IDs (max 25)
- `tag_ids` (`array`, required): Array of tag IDs to add

Example input: `{"email_account_ids":[],"tag_ids":[]}`

### `smartleadmcp_create_campaign`

Create campaign · Write

Create a new campaign (status DRAFTED). It sends nothing until it has all of the following, in order: save_campaign_sequences, add_email_accounts_to_campaign, add_leads_to_campaign, update_campaign_schedule (optionally update_campaign_settings), then update_campaign_status with START.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `name` (`string`, required): Campaign name
- `client_id` (`integer`, optional): Client ID (can be null for no client association)

Example input: `{"name":"<name>"}`

### `smartleadmcp_create_master_inbox_lead_note`

Create master inbox lead note · Write

Create a note for a lead in master inbox

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `email_lead_map_id` (`number`, required): The email lead map ID
- `note_message` (`string`, required): Note content

Example input: `{"email_lead_map_id":1,"note_message":"<note_message>"}`

### `smartleadmcp_create_master_inbox_lead_task`

Create master inbox lead task · Write

Create a task for a lead in master inbox

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `email_lead_map_id` (`number`, required): The email lead map ID
- `name` (`string`, required): Task name
- `description` (`string`, optional): Task description
- `due_date` (`string`, optional): Due date in ISO format
- `priority` (`string`, optional): Task priority. One of: `LOW`, `MEDIUM`, `HIGH`. Default: `MEDIUM`.

Example input: `{"email_lead_map_id":1,"name":"<name>"}`

### `smartleadmcp_push_leads_from_campaign_to_list`

Push leads from campaign to list · Write

Push specific leads from a campaign to a list

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `campaignId` (`number`, required): The source campaign ID
- `listId` (`number`, required): The target list ID
- `leadMapIds` (`array`, optional): Array of lead map IDs to push (max 100)

Example input: `{"campaignId":1,"listId":1}`

### `smartleadmcp_push_leads_to_list`

Push leads to list · Write

Push leads from all leads view to a list

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `leadIds` (`array`, required): Array of lead IDs to push (max 100)
- `listId` (`number`, required): The target list ID

Example input: `{"leadIds":[],"listId":1}`

### `smartleadmcp_sd_create_folder`

Smart Delivery: Create folder · Write

Create a folder to group Smart Delivery tests.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `name` (`string`, required): No description.

Example input: `{"name":"<name>"}`

### `smartleadmcp_sd_refresh_limits`

Smart Delivery: Refresh limits · Write

Re-read Smart Delivery plan credits from Smartlead and return the updated limits. Allowed at most once a minute; only use when sd_get_limits looks out of date.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs: none.

Example input: `{}`

### `smartleadmcp_set_master_inbox_reminder`

Set master inbox reminder · Write

Set a reminder for a lead in master inbox

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `email_lead_map_id` (`number`, required): The email lead map ID
- `email_stats_id` (`string`, required): The email stats ID
- `message` (`string`, required): Reminder message
- `reminder_time` (`string`, required): Reminder time in ISO format

Example input: `{"email_lead_map_id":1,"email_stats_id":"<email_stats_id>","message":"<message>","reminder_time":"<reminder_time>"}`

### `smartleadmcp_sp_save_search`

Smart Prospect: Save search · Write

Save a set of Smart Prospect search filters as a named saved search

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `search_string` (`string`, required): Name for the saved search (min 1 char)
- `city` (`array`, optional): City filters
- `companyDomain` (`array`, optional): Company domain filters
- `companyHeadCount` (`array`, optional): Employee range filters
- `companyIndustry` (`array`, optional): Industry filters
- `companyName` (`array`, optional): Company name filters
- `country` (`array`, optional): Country filters
- `department` (`array`, optional): Department filters
- `level` (`array`, optional): Seniority level filters
- `limit` (`number`, optional): Results limit for the search
- `state` (`array`, optional): State filters
- `title` (`array`, optional): Job title filters

Example input: `{"search_string":"<search_string>"}`

### `smartleadmcp_add_leads_to_campaign`

Add leads to campaign · Destructive

Add leads to a campaign. The SmartLead API expects the request body shape `{ lead_list: [...], settings: {...} }`. Pass leads via the `lead_list` parameter (array of lead objects). Each lead requires a non-empty string `email`. Only these top-level lead fields are accepted by the API: email, first_name, last_name, phone_number, company_name, website, location, linkedin_profile, company_url, custom_fields. Any other field (e.g. job_title, industry, seniority, linkedin_url) MUST be placed inside the `custom_fields` object. Max 1000 leads per call and max 200 keys inside `custom_fields`. Optional `settings` object supports these booleans: ignore_global_block_list, ignore_unsubscribe_list, ignore_community_bounce_list, ignore_duplicate_leads_in_other_campaign. Note: the legacy `leads` parameter is still accepted and mapped to `lead_list` for backward compatibility, but `lead_list` is preferred. The result starts with "Uploaded X of Y" followed by the reasons any leads were skipped; uploading 0 leads is returned as an error.

Read only: no. Destructive: yes. Idempotent (safe to retry): no.

Inputs:

- `campaign_id` (`number`, required): The ID of the campaign
- `lead_list` (`array`, optional): Array of lead objects to add to the campaign (max 1000). This is the preferred parameter name matching the SmartLead API contract.
- `leads` (`array`, optional): DEPRECATED — use `lead_list` instead. Accepted as a backward-compatibility alias and mapped to `lead_list`.
- `settings` (`object`, optional): Optional import settings forwarded to the SmartLead API as-is. Supported keys: ignore_global_block_list, ignore_unsubscribe_list, ignore_community_bounce_list, ignore_duplicate_leads_in_other_campaign (all optional booleans).

Example input: `{"campaign_id":1}`

### `smartleadmcp_block_master_inbox_domains`

Block master inbox domains · Destructive

Block domains from receiving emails

Read only: no. Destructive: yes. Idempotent (safe to retry): no.

Inputs:

- `domains` (`array`, required): Array of domains to block
- `source` (`string`, optional): Source of the block request. Default: `manual`.

Example input: `{"domains":[]}`

### `smartleadmcp_bulk_delete_email_accounts`

Bulk delete email accounts · Destructive

Bulk delete multiple SMTP email accounts

Read only: no. Destructive: yes. Idempotent (safe to retry): no.

Inputs:

- `emailAccountIds` (`array`, required): Array of email account IDs to delete

Example input: `{"emailAccountIds":[]}`

### `smartleadmcp_change_master_inbox_read_status`

Change master inbox read status · Destructive

Change the read status of a lead in master inbox

Read only: no. Destructive: yes. Idempotent (safe to retry): no.

Inputs:

- `email_lead_map_id` (`number`, required): The email lead map ID
- `read_status` (`boolean`, required): True to mark as read, false to mark as unread

Example input: `{"email_lead_map_id":1,"read_status":true}`

### `smartleadmcp_delete_campaign`

Delete campaign · Destructive

Delete a campaign permanently

Read only: no. Destructive: yes. Idempotent (safe to retry): no.

Inputs:

- `campaign_id` (`number`, required): The ID of the campaign to delete

Example input: `{"campaign_id":1}`

### `smartleadmcp_delete_campaign_lead`

Delete campaign lead · Destructive

Delete a lead from a campaign

Read only: no. Destructive: yes. Idempotent (safe to retry): no.

Inputs:

- `campaign_id` (`number`, required): The ID of the campaign
- `lead_id` (`number`, required): The ID of the lead to delete

Example input: `{"campaign_id":1,"lead_id":1}`

### `smartleadmcp_delete_campaign_webhook`

Delete campaign webhook · Destructive

Delete a webhook from a campaign

Read only: no. Destructive: yes. Idempotent (safe to retry): no.

Inputs:

- `campaign_id` (`number`, required): The ID of the campaign
- `id` (`number`, optional): The webhook ID to delete

Example input: `{"campaign_id":1}`

### `smartleadmcp_delete_email_account`

Delete email account · Destructive

Delete a single email account

Read only: no. Destructive: yes. Idempotent (safe to retry): no.

Inputs:

- `account_id` (`number`, required): The email account ID to delete

Example input: `{"account_id":1}`

### `smartleadmcp_delete_email_accounts_from_campaign`

Delete email accounts from campaign · Destructive

Remove email accounts from a campaign

Read only: no. Destructive: yes. Idempotent (safe to retry): no.

Inputs:

- `campaign_id` (`number`, required): The ID of the campaign
- `email_account_ids` (`array`, required): Array of email account IDs to remove

Example input: `{"campaign_id":1,"email_account_ids":[]}`

### `smartleadmcp_disconnect_google_account`

Disconnect google account · Destructive

Disconnect a Gmail OAuth account

Read only: no. Destructive: yes. Idempotent (safe to retry): no.

Inputs:

- `emailAccountId` (`number`, required): The Gmail account ID to disconnect

Example input: `{"emailAccountId":1}`

### `smartleadmcp_disconnect_microsoft_account`

Disconnect microsoft account · Destructive

Disconnect an Outlook/Microsoft OAuth account

Read only: no. Destructive: yes. Idempotent (safe to retry): no.

Inputs:

- `emailAccountId` (`number`, required): The Outlook account ID to disconnect

Example input: `{"emailAccountId":1}`

### `smartleadmcp_forward_campaign_email`

Forward campaign email · Destructive

Forward an email from a campaign to other recipients

Read only: no. Destructive: yes. Idempotent (safe to retry): no.

Inputs:

- `campaign_id` (`number`, required): The ID of the campaign
- `message_id` (`string`, required): The message ID to forward
- `stats_id` (`string`, required): The email statistics ID
- `to_emails` (`string`, required): Comma-separated list of recipient emails

Example input: `{"campaign_id":1,"message_id":"<message_id>","stats_id":"<stats_id>","to_emails":"<to_emails>"}`

### `smartleadmcp_mark_lead_as_complete`

Mark lead as complete · Destructive

Manually mark a lead as complete in a campaign

Read only: no. Destructive: yes. Idempotent (safe to retry): no.

Inputs:

- `campaign_id` (`number`, required): The ID of the campaign
- `lead_map_id` (`number`, required): The lead map ID

Example input: `{"campaign_id":1,"lead_map_id":1}`

### `smartleadmcp_mark_master_inbox_lead_as_unread`

Mark master inbox lead as unread · Destructive

Mark a lead as unread in master inbox (deprecated - use change_master_inbox_read_status)

Read only: no. Destructive: yes. Idempotent (safe to retry): no.

Inputs:

- `email_lead_map_id` (`number`, required): The email lead map ID

Example input: `{"email_lead_map_id":1}`

### `smartleadmcp_move_leads_between_lists`

Move leads between lists · Destructive

Copy or move leads between lists

Read only: no. Destructive: yes. Idempotent (safe to retry): no.

Inputs:

- `action` (`string`, required): Whether to copy or move the leads. One of: `copy`, `move`.
- `toListId` (`number`, required): The target list ID
- `fromListId` (`number`, optional): Source list ID (provide either fromListId or leadIds)
- `leadIds` (`array`, optional): Array of lead IDs (provide either fromListId or leadIds, max 10000)

Example input: `{"action":"copy","toListId":1}`

### `smartleadmcp_pause_lead`

Pause lead · Destructive

Pause a lead in a campaign

Read only: no. Destructive: yes. Idempotent (safe to retry): no.

Inputs:

- `campaign_id` (`number`, required): The ID of the campaign
- `lead_id` (`number`, required): The ID of the lead

Example input: `{"campaign_id":1,"lead_id":1}`

### `smartleadmcp_process_single_failed_email_account`

Process single failed email account · Destructive

Process and reconnect a single failed email account

Read only: no. Destructive: yes. Idempotent (safe to retry): no.

Inputs:

- `emailAccountId` (`number`, required): The email account ID to process

Example input: `{"emailAccountId":1}`

### `smartleadmcp_push_leads_to_campaign`

Push leads to campaign · Destructive

Copy or move EXISTING leads (from a lead list or by lead ID) into a campaign. Runs in the background and returns no counts. To add new leads by email address, use add_leads_to_campaign instead.

Read only: no. Destructive: yes. Idempotent (safe to retry): no.

Inputs:

- `action` (`string`, required): Whether to copy or move the leads. One of: `copy`, `move`.
- `campaignId` (`number`, required): The target campaign ID
- `csvSettings` (`object`, optional): Optional CSV import settings
- `leadIds` (`array`, optional): Array of lead IDs (provide either listId or leadIds, max 100)
- `listId` (`number`, optional): Source list ID (provide either listId or leadIds)

Example input: `{"action":"copy","campaignId":1}`

### `smartleadmcp_push_to_master_inbox_subsequence`

Push to master inbox subsequence · Destructive

Push a lead to a subsequence campaign

Read only: no. Destructive: yes. Idempotent (safe to retry): no.

Inputs:

- `email_lead_map_id` (`number`, required): The email lead map ID
- `sub_sequence_id` (`number`, required): The subsequence ID
- `stop_lead_on_parent_campaign_reply` (`boolean`, optional): Stop lead if they reply to parent campaign. Default: `false`.
- `sub_sequence_delay_time` (`number`, optional): Delay time in minutes before starting subsequence. Default: `0`.

Example input: `{"email_lead_map_id":1,"sub_sequence_id":1}`

### `smartleadmcp_reconnect_failed_email_accounts`

Reconnect failed email accounts · Destructive

Bulk reconnect all failed email accounts

Read only: no. Destructive: yes. Idempotent (safe to retry): no.

Inputs: none.

Example input: `{}`

### `smartleadmcp_remove_tags_from_email_accounts`

Remove tags from email accounts · Destructive

Remove tags from multiple email accounts

Read only: no. Destructive: yes. Idempotent (safe to retry): no.

Inputs:

- `email_account_ids` (`array`, required): Array of email account IDs
- `tag_ids` (`array`, required): Array of tag IDs to remove

Example input: `{"email_account_ids":[],"tag_ids":[]}`

### `smartleadmcp_resume_lead`

Resume lead · Destructive

Resume a paused lead in a campaign

Read only: no. Destructive: yes. Idempotent (safe to retry): no.

Inputs:

- `campaign_id` (`number`, required): The ID of the campaign
- `lead_id` (`number`, required): The ID of the lead

Example input: `{"campaign_id":1,"lead_id":1}`

### `smartleadmcp_resume_lead_with_delay`

Resume lead with delay · Destructive

Resume a paused lead with an optional delay in days

Read only: no. Destructive: yes. Idempotent (safe to retry): no.

Inputs:

- `campaign_id` (`number`, required): The ID of the campaign
- `lead_id` (`number`, required): The ID of the lead
- `resume_lead_with_delay_days` (`number`, optional): Number of days to wait before resuming

Example input: `{"campaign_id":1,"lead_id":1}`

### `smartleadmcp_resume_master_inbox_lead`

Resume master inbox lead · Destructive

Resume a paused lead in a campaign

Read only: no. Destructive: yes. Idempotent (safe to retry): no.

Inputs:

- `campaign_id` (`number`, required): The campaign ID
- `email_lead_map_id` (`number`, required): The email lead map ID
- `resume_delay_days` (`number`, optional): Number of days to delay before resuming

Example input: `{"campaign_id":1,"email_lead_map_id":1}`

### `smartleadmcp_retrigger_campaign_webhooks`

Retrigger campaign webhooks · Destructive

Retrigger failed webhook events for a campaign

Read only: no. Destructive: yes. Idempotent (safe to retry): no.

Inputs:

- `campaign_id` (`number`, required): The ID of the campaign
- `fromTime` (`string`, optional): Start date in ISO format
- `toTime` (`string`, optional): End date in ISO format

Example input: `{"campaign_id":1}`

### `smartleadmcp_save_campaign_sequences`

Save campaign sequences · Destructive

FULL REPLACE of a campaign's email steps: the steps you send become the complete sequence, and any existing step whose id is not included is DELETED. To add or edit a step, first call get_campaign_sequences, then send ALL steps (existing ones with their id, new ones without); steps can be passed back exactly as returned. Each step needs seq_number and seq_delay_details.delay_in_days. Content goes EITHER in top-level subject/email_body OR in seq_variants[] (for A/B tests). Bodies are HTML; personalise with merge tags like {{first_name}}, {{company_name}} or a custom_fields key such as {{job_title}} (unbalanced braces are rejected). The first email's subject must not start with "Re:", "Fw:" or "Fwd:".

Read only: no. Destructive: yes. Idempotent (safe to retry): no.

Inputs:

- `campaign_id` (`number`, required): The ID of the campaign
- `sequences` (`array`, required): Array of email sequences (at least 1).

Example input: `{"campaign_id":1,"sequences":[]}`

### `smartleadmcp_save_campaign_webhook`

Save campaign webhook · Destructive

Create or update a webhook for a campaign

Read only: no. Destructive: yes. Idempotent (safe to retry): no.

Inputs:

- `campaign_id` (`number`, required): The ID of the campaign
- `event_types` (`array`, required): Event types to trigger webhook
- `name` (`string`, required): Webhook name
- `webhook_url` (`string`, required): Webhook URL
- `categories` (`array`, optional): Categories to filter events
- `id` (`number`, optional): Webhook ID (for updates)

Example input: `{"campaign_id":1,"event_types":[],"name":"<name>","webhook_url":"<webhook_url>"}`

### `smartleadmcp_sd_create_test`

Smart Delivery: Create test · Destructive

Create a Smart Delivery inbox placement test. SENDS REAL EMAILS from the chosen mailboxes to seed inboxes and USES RUN CREDITS (MANUAL: one run now; AUTO: one credit per scheduled run). Confirm the details with the user before calling. Before: sd_get_limits (credits, max senders), sd_list_providers (provider_ids), get_campaign_sequences (sequence_id, variant_id) and get_campaign_email_accounts (email_account_ids must be attached to the campaign).

Read only: no. Destructive: yes. Idempotent (safe to retry): no.

Inputs:

- `campaign_id` (`integer`, required): SmartLead campaign whose email is tested
- `email_account_ids` (`array`, required): Sender mailboxes attached to the campaign (max per test: sd_get_limits)
- `name` (`string`, required): No description.
- `provider_ids` (`array`, required): No description.
- `sequence_id` (`integer`, required): Sequence step id (get_campaign_sequences)
- `type` (`string`, required): MANUAL = one run now; AUTO = runs on a schedule. One of: `MANUAL`, `AUTO`.
- `description` (`string`, optional): No description.
- `ends_at` (`string`, optional): AUTO only, optional: no runs after this (ends_at or max_runs, not both). MANUAL: omit.
- `folder_id` (`integer`, optional): Folder ID (from sd_list_folders)
- `max_runs` (`integer`, optional): AUTO only, optional: stop after this many runs. MANUAL: omit.
- `schedule` (`object`, optional): AUTO: required (when runs happen; each run sends real emails and uses one run credit). MANUAL: omit.
- `send_all_at_once` (`boolean`, optional): Send every test email immediately (or give send_gap)
- `send_gap` (`object`, optional): Spacing between test emails (min 5 minutes, max 30 days). Use instead of send_all_at_once: true.
- `starts_at` (`string`, optional): AUTO: required. First run not before this ISO time (must be in the future). MANUAL: omit.
- `variant_id` (`integer`, optional): A/B variant id of that step. Omit for a step without variants (required when the step has variants).

Example input: `{"campaign_id":1,"email_account_ids":[],"name":"<name>","provider_ids":[],"sequence_id":1,"type":"MANUAL"}`

### `smartleadmcp_sd_delete_folder`

Smart Delivery: Delete folder · Destructive

Delete a Smart Delivery folder.

Read only: no. Destructive: yes. Idempotent (safe to retry): no.

Inputs:

- `folder_id` (`integer`, required): Folder ID (from sd_list_folders)

Example input: `{"folder_id":1}`

### `smartleadmcp_sd_delete_test`

Smart Delivery: Delete test · Destructive

Delete a test: it disappears from lists and its schedule stops. Refused while a run is in progress.

Read only: no. Destructive: yes. Idempotent (safe to retry): no.

Inputs:

- `test_id` (`string`, required): Test ID (UUID, from sd_list_tests)

Example input: `{"test_id":"<test_id>"}`

### `smartleadmcp_sd_pause_test`

Smart Delivery: Pause test · Destructive

Pause an ACTIVE AUTO test: no further scheduled runs until resumed.

Read only: no. Destructive: yes. Idempotent (safe to retry): no.

Inputs:

- `test_id` (`string`, required): Test ID (UUID, from sd_list_tests)

Example input: `{"test_id":"<test_id>"}`

### `smartleadmcp_sd_rename_folder`

Smart Delivery: Rename folder · Destructive

Rename a Smart Delivery folder.

Read only: no. Destructive: yes. Idempotent (safe to retry): no.

Inputs:

- `folder_id` (`integer`, required): Folder ID (from sd_list_folders)
- `name` (`string`, required): No description.

Example input: `{"folder_id":1,"name":"<name>"}`

### `smartleadmcp_sd_resume_test`

Smart Delivery: Resume test · Destructive

Resume a PAUSED AUTO test. Its scheduled runs SEND REAL EMAILS and USE RUN CREDITS again. Confirm with the user before calling.

Read only: no. Destructive: yes. Idempotent (safe to retry): no.

Inputs:

- `test_id` (`string`, required): Test ID (UUID, from sd_list_tests)

Example input: `{"test_id":"<test_id>"}`

### `smartleadmcp_sd_stop_test`

Smart Delivery: Stop test · Destructive

Stop a test for good: no further runs. It cannot be resumed.

Read only: no. Destructive: yes. Idempotent (safe to retry): no.

Inputs:

- `test_id` (`string`, required): Test ID (UUID, from sd_list_tests)

Example input: `{"test_id":"<test_id>"}`

### `smartleadmcp_sd_update_test`

Smart Delivery: Update test · Destructive

Update a Smart Delivery test: name, description, folder (null = no folder), AUTO schedule or email spacing. Senders, providers and the tested email cannot be changed; create a new test instead.

Read only: no. Destructive: yes. Idempotent (safe to retry): no.

Inputs:

- `test_id` (`string`, required): Test ID (UUID, from sd_list_tests)
- `description` (`string`, optional): No description.
- `folder_id` (`integer`, optional): Folder ID, or null to remove from its folder
- `name` (`string`, optional): No description.
- `schedule` (`object`, optional): AUTO: required (when runs happen; each run sends real emails and uses one run credit). MANUAL: omit.
- `send_all_at_once` (`boolean`, optional): No description.
- `send_gap` (`object`, optional): Spacing between test emails (min 5 minutes, max 30 days). Use instead of send_all_at_once: true.

Example input: `{"test_id":"<test_id>"}`

### `smartleadmcp_send_campaign_email_thread`

Send campaign email thread · Destructive

Send a reply email in an existing email thread

Read only: no. Destructive: yes. Idempotent (safe to retry): no.

Inputs:

- `campaign_id` (`number`, required): The ID of the campaign
- `email_body` (`string`, required): The email body content
- `email_stats_id` (`string`, required): The email statistics ID
- `add_signature` (`boolean`, optional): Whether to add email signature
- `attachments` (`array`, optional): Email attachments
- `bcc` (`string`, optional): BCC recipients
- `cc` (`string`, optional): CC recipients
- `reply_email_body` (`string`, optional): Body of the email being replied to
- `reply_email_time` (`string`, optional): Time of the email being replied to
- `reply_message_id` (`string`, optional): Message ID being replied to
- `schedule_condition` (`string`, optional): Scheduling condition
- `scheduled_time` (`string`, optional): When to send the email
- `seq_type` (`string`, optional): Sequence type
- `to_email` (`string`, optional): Recipient email address
- `to_first_name` (`string`, optional): Recipient first name
- `to_last_name` (`string`, optional): Recipient last name

Example input: `{"campaign_id":1,"email_body":"<email_body>","email_stats_id":"<email_stats_id>"}`

### `smartleadmcp_sp_fetch_contacts`

Smart Prospect: Fetch contacts · Destructive

Fetch/reveal email addresses for contacts from a Smart Prospect search. DEDUCTS CREDITS. Provide filter_id with either specific adapt IDs or a limit number

Read only: no. Destructive: yes. Idempotent (safe to retry): no.

Inputs:

- `filter_id` (`number`, required): Filter ID from search results (required)
- `id` (`array`, optional): Array of specific adapt_ids to fetch
- `limit` (`number`, optional): Number of contacts to fetch (1-10000; some users up to 30000)
- `visual_limit` (`number`, optional): Page size for visual display (1-1000, default 10)
- `visual_offset` (`number`, optional): Offset for visual display (default 0)

Example input: `{"filter_id":1}`

### `smartleadmcp_sp_find_emails`

Smart Prospect: Find emails · Destructive

Find email addresses for up to 10 contacts by first name, last name, and company domain. DEDUCTS CREDITS for each newly discovered email (not cached within 30 days)

Read only: no. Destructive: yes. Idempotent (safe to retry): no.

Inputs:

- `contacts` (`array`, required): Array of contacts to find emails for (max 10)

Example input: `{"contacts":[]}`

### `smartleadmcp_sp_review_contacts`

Smart Prospect: Review contacts · Destructive

Trigger a review/recount of Smart Prospect contacts and metrics for a filter. Recalculates verification statuses and catch-all statuses

Read only: no. Destructive: yes. Idempotent (safe to retry): no.

Inputs:

- `filter_id` (`string`, required): Filter ID to review

Example input: `{"filter_id":"<filter_id>"}`

### `smartleadmcp_sp_update_email_metrics`

Smart Prospect: Update email metrics · Destructive

Update metrics and record the verification result for a specific email address within a Smart Prospect filter

Read only: no. Destructive: yes. Idempotent (safe to retry): no.

Inputs:

- `adapt_id` (`string`, required): Adapt ID of the contact
- `email_id` (`string`, required): Email address (max 255 chars)
- `email_source` (`string`, required): Source of verification (e.g., "anymail", "leadmagic", "hunter")
- `filter_id` (`number`, required): Filter ID
- `status` (`string`, required): Verification status. One of: `valid`, `invalid`, `catch_all`, `risky`, `blacklisted`, `not_found`, `valid_catch_all`, `unknown`.

Example input: `{"adapt_id":"<adapt_id>","email_id":"<email_id>","email_source":"anymail","filter_id":1,"status":"valid"}`

### `smartleadmcp_sp_update_fetched_lead`

Smart Prospect: Update fetched lead · Destructive

Update the name of a fetched lead record in Smart Prospect

Read only: no. Destructive: yes. Idempotent (safe to retry): no.

Inputs:

- `id` (`string`, required): Fetched lead record ID
- `search_string` (`string`, required): New name (1-255 chars)

Example input: `{"id":"<id>","search_string":"<search_string>"}`

### `smartleadmcp_sp_update_metrics`

Smart Prospect: Update metrics · Destructive

Batch update fetch_details metrics for a Smart Prospect filter record. Allows incrementing or decrementing specific metric keys

Read only: no. Destructive: yes. Idempotent (safe to retry): no.

Inputs:

- `filter_id` (`number`, required): Filter ID
- `list` (`array`, required): Array of metric updates (1-50 items)

Example input: `{"filter_id":1,"list":[]}`

### `smartleadmcp_sp_update_saved_search`

Smart Prospect: Update saved search · Destructive

Update the name of a saved Smart Prospect search

Read only: no. Destructive: yes. Idempotent (safe to retry): no.

Inputs:

- `id` (`string`, required): Saved search ID
- `search_string` (`string`, required): New name for the saved search (1-255 chars)

Example input: `{"id":"<id>","search_string":"<search_string>"}`

### `smartleadmcp_unsubscribe_lead`

Unsubscribe lead · Destructive

Unsubscribe a lead from a campaign

Read only: no. Destructive: yes. Idempotent (safe to retry): no.

Inputs:

- `campaign_id` (`number`, required): The ID of the campaign
- `lead_id` (`number`, required): The ID of the lead to unsubscribe

Example input: `{"campaign_id":1,"lead_id":1}`

### `smartleadmcp_unsubscribe_lead_globally`

Unsubscribe lead globally · Destructive

Unsubscribe a lead from all campaigns across the entire account

Read only: no. Destructive: yes. Idempotent (safe to retry): no.

Inputs:

- `lead_id` (`number`, required): The ID of the lead to unsubscribe

Example input: `{"lead_id":1}`

### `smartleadmcp_update_campaign_lead`

Update campaign lead · Destructive

Update lead information in a campaign

Read only: no. Destructive: yes. Idempotent (safe to retry): no.

Inputs:

- `campaign_id` (`number`, required): The ID of the campaign
- `email` (`string`, required): Lead email address
- `lead_id` (`number`, required): The ID of the lead to update
- `company_name` (`string`, optional): Lead company name
- `company_url` (`string`, optional): Lead company URL
- `custom_fields` (`object`, optional): Custom field values (max 200)
- `first_name` (`string`, optional): Lead first name
- `last_name` (`string`, optional): Lead last name
- `linkedin_profile` (`string`, optional): Lead LinkedIn profile URL
- `location` (`string`, optional): Lead location
- `phone_number` (`string`, optional): Lead phone number
- `website` (`string`, optional): Lead website

Example input: `{"campaign_id":1,"email":"<email>","lead_id":1}`

### `smartleadmcp_update_campaign_schedule`

Update campaign schedule · Destructive

Set when a campaign sends: timezone, days, hours, spacing and daily new-lead cap. Required before update_campaign_status START. Replaces the whole schedule, so send every required field.

Read only: no. Destructive: yes. Idempotent (safe to retry): no.

Inputs:

- `campaign_id` (`number`, required): The ID of the campaign
- `days_of_the_week` (`array`, required): Sending days as numbers: 0=Sunday, 1=Monday ... 6=Saturday. Weekdays = [1,2,3,4,5].
- `end_hour` (`string`, required): Daily end time, 24-hour HH:mm, e.g. "18:00". Must be later than start_hour.
- `max_new_leads_per_day` (`number`, required): Maximum new leads to start per day
- `min_time_btw_emails` (`number`, required): Minimum minutes between emails sent by the campaign (at least 3)
- `start_hour` (`string`, required): Daily start time, 24-hour HH:mm in the campaign timezone, e.g. "09:00" (not "9:00 AM").
- `timezone` (`string`, required): IANA timezone name, e.g. "America/New_York", "Europe/London", "Asia/Kolkata". Prefer region names over abbreviations like "EST", which ignore daylight saving.
- `schedule_start_time` (`string`, optional): Optional ISO 8601 date-time to start sending from, e.g. "2026-11-02T09:00:00". Without an offset it is read as local time in `timezone`; with "Z" or "+05:30" the offset is used.

Example input: `{"campaign_id":1,"days_of_the_week":[],"end_hour":"18:00","max_new_leads_per_day":1,"min_time_btw_emails":1,"start_hour":"09:00","timezone":"America/New_York"}`

### `smartleadmcp_update_campaign_settings`

Update campaign settings · Destructive

Update campaign settings: tracking, stop rules, plain text, unsubscribe text, AI ESP matching and auto-pause. Only the fields you send are changed.

Read only: no. Destructive: yes. Idempotent (safe to retry): no.

Inputs:

- `campaign_id` (`number`, required): The ID of the campaign
- `add_unsubscribe_tag` (`boolean`, optional): Add unsubscribe tag to emails
- `ai_categorisation_options` (`array`, optional): AI categorization option IDs
- `auto_pause_domain_leads_on_reply` (`boolean`, optional): Auto-pause all leads from domain on reply
- `bounce_autopause_threshold` (`string`, optional): Number of bounces after which the campaign auto-pauses, as a whole-number string, e.g. "5". Only applied while the campaign is not ACTIVE or PAUSED; otherwise it is ignored and listed in ignored_fields.
- `client_id` (`number`, optional): Client ID
- `domain_level_rate_limit` (`boolean`, optional): Enable domain-level rate limiting across mailboxes on the same domain
- `enable_ai_esp_matching` (`boolean`, optional): Enable AI ESP matching
- `follow_up_percentage` (`number`, optional): Percentage of leads to follow up
- `force_plain_text` (`boolean`, optional): Force plain text for all emails
- `ignore_ss_mailbox_sending_limit` (`boolean`, optional): Ignore mailbox sending limits
- `name` (`string`, optional): Campaign name
- `out_of_office_detection_settings` (`object`, optional): Out-of-office detection settings
- `send_as_plain_text` (`boolean`, optional): Send emails as plain text
- `stop_lead_settings` (`string`, optional): Stop sending follow-ups to a lead when they reply, click a link, or open an email. One of: `REPLY_TO_AN_EMAIL`, `CLICK_ON_A_LINK`, `OPEN_AN_EMAIL`.
- `track_settings` (`array`, optional): What NOT to track. Tracking is on unless listed here: e.g. ["DONT_TRACK_EMAIL_OPEN"] turns off open tracking; [] tracks everything. The short forms (DONT_EMAIL_OPEN etc.) are the stored values returned by get_campaign_by_id and are also accepted.
- `unsubscribe_text` (`string`, optional): Unsubscribe link text

Example input: `{"campaign_id":1}`

### `smartleadmcp_update_campaign_status`

Update campaign status · Destructive

Update the status of a campaign. Use START to resume/unpause or launch a campaign. PAUSED temporarily halts sending. STOPPED ends sending (restartable with START). ACTIVE and COMPLETED are read-only states returned by get_campaigns — they are not valid inputs here. Do not confuse START (campaign resume) with STARTED (a lead status).

Read only: no. Destructive: yes. Idempotent (safe to retry): no.

Inputs:

- `id` (`number`, required): Campaign ID
- `status` (`string`, required): Mutation status: START (resume/unpause), PAUSED, or STOPPED. One of: `START`, `PAUSED`, `STOPPED`.

Example input: `{"id":1,"status":"START"}`

### `smartleadmcp_update_campaign_team_member`

Update campaign team member · Destructive

Assign or remove a team member from a campaign

Read only: no. Destructive: yes. Idempotent (safe to retry): no.

Inputs:

- `campaign_id` (`number`, required): The ID of the campaign
- `teamMemberId` (`number`, required): Team member ID (null to remove)

Example input: `{"campaign_id":1,"teamMemberId":1}`

### `smartleadmcp_update_email_account_details`

Update email account details · Destructive

Update specific details of an email account

Read only: no. Destructive: yes. Idempotent (safe to retry): no.

Inputs:

- `account_id` (`number`, required): The email account ID
- `bcc` (`string`, optional): BCC email address for all sent emails
- `client_id` (`number`, optional): Client ID for white-label
- `custom_tracking_url` (`string`, optional): Custom domain for tracking
- `from_name` (`string`, optional): Display name for the sender
- `max_email_per_day` (`number`, optional): Maximum emails to send per day
- `signature` (`string`, optional): Email signature HTML
- `time_to_wait_in_mins` (`number`, optional): Time to wait between emails (in minutes)

Example input: `{"account_id":1}`

### `smartleadmcp_update_email_account_tag`

Update email account tag · Destructive

Create or update an email account tag

Read only: no. Destructive: yes. Idempotent (safe to retry): no.

Inputs:

- `color` (`string`, required): Tag color in hex format (e.g., #FFFFFF)
- `id` (`number`, required): Tag ID
- `name` (`string`, required): Tag name

Example input: `{"color":"<color>","id":1,"name":"<name>"}`

### `smartleadmcp_update_email_warmup_details`

Update email warmup details · Destructive

Update warmup settings for an email account

Read only: no. Destructive: yes. Idempotent (safe to retry): no.

Inputs:

- `account_id` (`number`, required): The email account ID
- `warmup_enabled` (`boolean`, required): Enable or disable warmup
- `auto_adjust_warmup` (`boolean`, optional): Auto-adjust warmup based on performance
- `daily_rampup` (`number`, optional): Daily increase in warmup emails (5-20)
- `is_rampup_enabled` (`boolean`, optional): Enable gradual ramp-up
- `reply_rate_percentage` (`number`, optional): Reply rate percentage (20-100)
- `total_warmup_per_day` (`number`, optional): Total warmup emails per day (1-50)
- `warmup_key_id` (`string`, optional): Warmup key ID

Example input: `{"account_id":1,"warmup_enabled":true}`

### `smartleadmcp_update_lead_category`

Update lead category · Destructive

Update lead category and optionally pause the lead

Read only: no. Destructive: yes. Idempotent (safe to retry): no.

Inputs:

- `campaign_id` (`number`, required): The ID of the campaign
- `lead_id` (`number`, required): The ID of the lead
- `category_id` (`number`, optional): The new category ID (null to remove category)
- `pause_lead` (`boolean`, optional): Whether to pause the lead. Default: `false`.

Example input: `{"campaign_id":1,"lead_id":1}`

### `smartleadmcp_update_lead_email_account`

Update lead email account · Destructive

Update the email account assigned to a lead

Read only: no. Destructive: yes. Idempotent (safe to retry): no.

Inputs:

- `email_account_id` (`number`, required): The new email account ID
- `email_campaign_id` (`number`, required): The campaign ID
- `email_lead_id` (`number`, required): The lead ID

Example input: `{"email_account_id":1,"email_campaign_id":1,"email_lead_id":1}`

### `smartleadmcp_update_master_inbox_lead_category`

Update master inbox lead category · Destructive

Update the category of a lead in master inbox

Read only: no. Destructive: yes. Idempotent (safe to retry): no.

Inputs:

- `email_lead_map_id` (`number`, required): The email lead map ID
- `category_id` (`number`, optional): The new category ID (null to unassign)

Example input: `{"email_lead_map_id":1}`

### `smartleadmcp_update_master_inbox_lead_revenue`

Update master inbox lead revenue · Destructive

Update the revenue value of a lead in master inbox

Read only: no. Destructive: yes. Idempotent (safe to retry): no.

Inputs:

- `email_lead_map_id` (`number`, required): The email lead map ID
- `revenue` (`number`, required): The revenue amount

Example input: `{"email_lead_map_id":1,"revenue":1}`

### `smartleadmcp_update_master_inbox_lead_team_member`

Update master inbox lead team member · Destructive

Assign a team member to a lead in master inbox

Read only: no. Destructive: yes. Idempotent (safe to retry): no.

Inputs:

- `email_lead_map_id` (`number`, required): The email lead map ID
- `team_member_id` (`number`, required): The team member ID to assign

Example input: `{"email_lead_map_id":1,"team_member_id":1}`

## Related

Other Marketing connectors ([all 190](/agentkit/connectors/?category=marketing)):

- [HubSpot](/agentkit/connectors/hubspot/): Scalekit connector, OAuth, 457 tools
- [Mailchimp](/agentkit/connectors/mailchimp/): Scalekit connector, OAuth, 73 tools
- [Twitter / X](/agentkit/connectors/twitteroauth/): Scalekit connector, OAuth, 92 tools


---

## More Scalekit documentation

| Resource | What it contains | When to use it |
|----------|-----------------|----------------|
| [/llms.txt](/llms.txt) | Structured index with routing hints per product area | Start here — find which documentation set covers your topic before loading full content |
| [/llms-full.txt](/llms-full.txt) | Complete documentation for all Scalekit products in one file | Use when you need exhaustive context across multiple products or when the topic spans several areas |
| [sitemap-0.xml](https://docs.scalekit.com/sitemap-0.xml) | Full URL list of every documentation page | Use to discover specific page URLs you can fetch for targeted, page-level answers |
