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.
- Tools
- 185
- What they doRead · write · destructive
- 115 · 12 · 58115 read12 write58 destructive
- Users sign in with
- OAuth
- OAuth app
- Your own Smartlead MCP server app
Setup
Install the SDK
Terminal window npm install @scalekit-sdk/node dotenvTerminal window pip install scalekit-sdk-python python-dotenvSet your credentials
Add your Scalekit credentials to your
.envfile. Find values in app.scalekit.com > Developers > API Credentials..env SCALEKIT_ENVIRONMENT_URL=<your-environment-url>SCALEKIT_CLIENT_ID=<your-client-id>SCALEKIT_CLIENT_SECRET=<your-client-secret>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_nameyour code passes. See Configure connections.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.
Authorize a user and make your first call
quickstart.mts 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.actionsconst connector = 'smartleadmcp'const identifier = 'user_123'// Generate an authorization link for the userconst { 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 callconst result = await actions.executeTool({connector,identifier,toolName: 'smartleadmcp_fetch_master_inbox_assigned_me',toolInput: {},})console.log(result)Terminal window npx tsx quickstart.mtsquickstart.py import osfrom scalekit import ScalekitClientfrom dotenv import load_dotenvload_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.actionsconnection_name = "smartleadmcp"identifier = "user_123"# Generate an authorization link for the userlink_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 callresult = actions.execute_tool(tool_input={},tool_name="smartleadmcp_fetch_master_inbox_assigned_me",connection_name=connection_name,identifier=identifier,)print(result)Terminal window python quickstart.pyEach user signs in once. See Authorize a user for the full flow and statuses.
Tools
Pass the exact name toexecute_toolsmartleadmcp_analyse_campaign_copyAnalyze the email copy used in a campaign.Read-onlyAnalyse campaign copy
Analyze the email copy used in a campaign. Provides insights on content quality, spam triggers, and optimization suggestions.
Inputs
campaignIdnumberrequired- The ID of the campaign to analyze
smartleadmcp_analyse_campaign_mailboxesAnalyze the mailboxes used in a campaign.Read-onlyAnalyse campaign mailboxes
Analyze the mailboxes used in a campaign. Checks mailbox health, sending patterns, and potential issues.
Inputs
campaignIdnumberrequired- The ID of the campaign
limitnumber- Maximum number of mailboxes to analyze (1-1000)default
500 offsetnumber- Number of mailboxes to skipdefault
0
smartleadmcp_bulk_fetch_email_messagesFetch messages from multiple email accounts in one requestRead-onlyBulk fetch email messages
Fetch messages from multiple email accounts in one request
Inputs
requestsarrayrequired- Array of fetch requests (max 10)
smartleadmcp_check_campaign_bounce_or_lead_qualityCheck campaign bounce rates and lead quality issues.Read-onlyCheck campaign bounce or lead quality
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.
Inputs
campaignIdnumberrequired- The ID of the campaign to check
smartleadmcp_check_mailbox_domain_deliverabilityCheck the deliverability status and configuration of a mailbox domain.Read-onlyCheck mailbox domain deliverability
Check the deliverability status and configuration of a mailbox domain. Includes DNS records, reputation, and sending issues.
Inputs
domainstringrequired- The domain name to check deliverability for
smartleadmcp_check_signature_missingCheck if email signatures are missing in a campaign.Read-onlyCheck signature missing
Check if email signatures are missing in a campaign. Identifies emails sent without proper signatures.
Inputs
campaignIdnumberrequired- The ID of the campaign to check for missing signatures
smartleadmcp_check_webhook_statusCheck the status and health of webhooks configured for the account.Read-onlyCheck webhook status
Check the status and health of webhooks configured for the account.
Inputs
This tool takes no inputs.
smartleadmcp_check_whitelabel_domain_cnameCheck the CNAME configuration for whitelabel domains.Read-onlyCheck whitelabel domain CNAME
Check the CNAME configuration for whitelabel domains. Verifies DNS records are properly configured.
Inputs
This tool takes no inputs.
smartleadmcp_debug_email_accountDebug email account issues.Read-onlyDebug email account
Debug email account issues. Provides detailed diagnostic information about email account configuration, connection status, and potential issues.
Inputs
emailAccountIdnumberrequired- The ID of the email account to debug
smartleadmcp_export_campaign_leadsExport all leads from a campaign to a downloadable fileRead-onlyExport campaign leads
Export all leads from a campaign to a downloadable file
Inputs
campaign_idnumberrequired- The ID of the campaign
smartleadmcp_fetch_email_messagesFetch messages from an email accountRead-onlyFetch email messages
Fetch messages from an email account
Inputs
account_idnumberrequired- The email account ID
folderstring- Email folder to fetch from (e.g., INBOX, SENT)
fromstring- Filter messages from this date (ISO format)
includeBodyboolean- Include full message body
limitnumber- Number of messages to fetch (1-500, default 100)
tostring- Filter messages to this date (ISO format)
smartleadmcp_fetch_master_inbox_archived_emailsFetch archived emails from master inboxRead-onlyFetch master inbox archived emails
Fetch archived emails from master inbox
Inputs
fetch_message_historyboolean- Include full message historydefault
false filtersobject- No description.
limitnumber- Number of results (1-20)
offsetnumber- Offset for pagination (min: 0)
sortBystring- Sort order for resultsone of
REPLY_TIME_DESCSENT_TIME_DESC
smartleadmcp_fetch_master_inbox_assigned_meFetch emails assigned to me from master inboxRead-onlyFetch master inbox assigned me
Fetch emails assigned to me from master inbox
Inputs
fetch_message_historyboolean- Include full message historydefault
false filtersobject- No description.
limitnumber- Number of results (1-20)
offsetnumber- Offset for pagination (min: 0)
sortBystring- Sort order for resultsone of
REPLY_TIME_DESCSENT_TIME_DESC
smartleadmcp_fetch_master_inbox_custom_view_emailsFetch emails from a custom view in master inboxRead-onlyFetch master inbox custom view emails
Fetch emails from a custom view in master inbox
Inputs
fetch_message_historyboolean- Include full message historydefault
false filtersobject- No description.
limitnumber- Number of results (1-20)
offsetnumber- Offset for pagination (min: 0)
sortBystring- Sort order for resultsone of
REPLY_TIME_DESCSENT_TIME_DESC
smartleadmcp_fetch_master_inbox_important_emailsFetch important emails from master inboxRead-onlyFetch master inbox important emails
Fetch important emails from master inbox
Inputs
fetch_message_historyboolean- Include full message historydefault
false filtersobject- No description.
limitnumber- Number of results (1-20)
offsetnumber- Offset for pagination (min: 0)
sortBystring- Sort order for resultsone of
REPLY_TIME_DESCSENT_TIME_DESC
smartleadmcp_fetch_master_inbox_reminders_emailsFetch emails with reminders from master inboxRead-onlyFetch master inbox reminders emails
Fetch emails with reminders from master inbox
Inputs
filtersobject- No description.
limitnumber- Number of results (1-20)
offsetnumber- Offset for pagination (min: 0)
sortBystring- Sort order for resultsone of
REMINDER_TIME_DESCREMINDER_TIME_ASC
smartleadmcp_fetch_master_inbox_repliesFetch email replies from master inbox with advanced filteringRead-onlyFetch master inbox replies
Fetch email replies from master inbox with advanced filtering
Inputs
fetch_message_historyboolean- Include full message historydefault
false filtersobject- No description.
limitnumber- Number of results (1-20)
offsetnumber- Offset for pagination (min: 0)
sortBystring- Sort order for resultsone of
REPLY_TIME_DESCSENT_TIME_DESC
smartleadmcp_fetch_master_inbox_scheduled_emailsFetch scheduled emails from master inboxRead-onlyFetch master inbox scheduled emails
Fetch scheduled emails from master inbox
Inputs
fetch_message_historyboolean- Include full message historydefault
false filtersobject- No description.
limitnumber- Number of results (1-20)
offsetnumber- Offset for pagination (min: 0)
sortBystring- Sort order for resultsone of
SCHEDULED_TIME_DESCSCHEDULED_TIME_ASC
smartleadmcp_fetch_master_inbox_sent_emailsFetch sent emails from master inbox with advanced filteringRead-onlyFetch master inbox sent emails
Fetch sent emails from master inbox with advanced filtering
Inputs
filtersobject- No description.
limitnumber- Number of results (1-20)
offsetnumber- Offset for pagination (min: 0)
sortBystring- Sort order for resultsone of
REPLY_TIME_DESCSENT_TIME_DESC
smartleadmcp_fetch_master_inbox_snoozed_emailsFetch snoozed emails from master inboxRead-onlyFetch master inbox snoozed emails
Fetch snoozed emails from master inbox
Inputs
fetch_message_historyboolean- Include full message historydefault
false filtersobject- No description.
limitnumber- Number of results (1-20)
offsetnumber- Offset for pagination (min: 0)
sortBystring- Sort order for resultsone of
REPLY_TIME_DESCSENT_TIME_DESC
smartleadmcp_fetch_master_inbox_unread_repliesFetch unread email replies from master inboxRead-onlyFetch master inbox unread replies
Fetch unread email replies from master inbox
Inputs
fetch_message_historyboolean- Include full message historydefault
false filtersobject- No description.
limitnumber- Number of results (1-20)
offsetnumber- Offset for pagination (min: 0)
sortBystring- Sort order for resultsone of
REPLY_TIME_DESCSENT_TIME_DESC
smartleadmcp_fetch_master_inbox_untracked_repliesFetch untracked email replies that were not captured by campaignsRead-onlyFetch master inbox untracked replies
Fetch untracked email replies that were not captured by campaigns
Inputs
fetchAttachmentsboolean- Include attachments in responsedefault
false fetchBodyboolean- Include full email bodydefault
false from_emailstring- Filter by sender email
limitnumber- Number of results (1-100)default
20 offsetnumber- Offset for paginationdefault
0 subject_linestring- Filter by subject line
to_emailstring- Filter by recipient email
smartleadmcp_get_all_clientsGet list of all clientsRead-onlyGet all clients
Get list of all clients
Inputs
This tool takes no inputs.
smartleadmcp_get_all_leadsGet all leads with advanced filtering options.Read-onlyGet all leads
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.
Inputs
campaignIdnumber- Filter by campaign ID. Required when using status, emailStatus, emailAccountId, emailCampaignSeqId, campaignTagId, teamMemberId, replyDateFrom or replyDateTo.
campaignTagIdnumber- Filter by campaign tag ID (REQUIRES campaignId).
clientIdnumber- Filter by client ID
emailAccountIdnumber- Filter by email account ID (REQUIRES campaignId).
emailCampaignSeqIdnumber- Filter by email sequence ID (REQUIRES campaignId).
emailStatusstring- Filter by email status (REQUIRES campaignId).one of
is_openedis_clickedis_bouncedis_repliedis_unsubscribedis_spamis_acceptednot_replied importedDatestring- Filter by imported date (ISO format)
lastSeenLeadIdnumber- For pagination, ID of last seen lead
leadCategoryIdsstring- Comma-separated list of lead category IDs
leadEmailstring- Filter by lead email
leadTypestring- Filter by lead typeone of
activeyet_to_usepreviously_activearchived limitnumber- Number of results to return (1-100, default 50)
listIdnumber- Filter by list ID
replyDateFromstring- Filter replies from this date (ISO format) (REQUIRES campaignId).
replyDateTostring- Filter replies to this date (ISO format) (REQUIRES campaignId).
statusstring- Filter by lead status (REQUIRES campaignId).one of
STARTEDINPROGRESSSTOPPEDPAUSEDBLOCKEDCOMPLETED teamMemberIdnumber- Filter by team member ID (REQUIRES campaignId).
unCategorizednumber- Set to 1 to get uncategorized leads
smartleadmcp_get_analytics_campaign_listGet list of campaigns for analytics with optional client filteringRead-onlyGet analytics campaign list
Get list of campaigns for analytics with optional client filtering
Inputs
client_idsstring- Comma-separated list of client IDs to filter by
smartleadmcp_get_analytics_client_listGet list of clients for analytics reportingRead-onlyGet analytics client list
Get list of clients for analytics reporting
Inputs
client_idsstring- Comma-separated list of client IDs to filter by
smartleadmcp_get_campaign_analyticsGet comprehensive analytics for a campaignRead-onlyGet campaign analytics
Get comprehensive analytics for a campaign
Inputs
campaign_idnumberrequired- The ID of the campaign
smartleadmcp_get_campaign_analytics_by_dateGet campaign analytics for a specific date rangeRead-onlyGet campaign analytics by date
Get campaign analytics for a specific date range
Inputs
campaign_idnumberrequired- The ID of the campaign
end_datestringrequired- End date in ISO format (YYYY-MM-DD)
start_datestringrequired- Start date in ISO format (YYYY-MM-DD)
smartleadmcp_get_campaign_by_idGet a specific campaign by its IDRead-onlyGet campaign by ID
Get a specific campaign by its ID
Inputs
idnumberrequired- The ID of the campaign
smartleadmcp_get_campaign_diagnosticsGet comprehensive diagnostic information for a campaign.Read-onlyGet campaign diagnostics
Get comprehensive diagnostic information for a campaign. Includes sending status, configuration issues, and performance metrics.
Inputs
campaignIdnumberrequired- The ID of the campaign to diagnose
smartleadmcp_get_campaign_email_accountsGet email accounts associated with a campaignRead-onlyGet campaign email accounts
Get email accounts associated with a campaign
Inputs
campaign_idnumberrequired- The ID of the campaign
smartleadmcp_get_campaign_follow_up_reply_rateGet reply rates for each follow-up sequence to optimize email sequencesRead-onlyGet campaign follow up reply rate
Get reply rates for each follow-up sequence to optimize email sequences
Inputs
end_datestringrequired- End date in ISO format (YYYY-MM-DD)
start_datestringrequired- Start date in ISO format (YYYY-MM-DD)
campaign_idsstring- Comma-separated list of campaign IDs to filter by
client_idsstring- Comma-separated list of client IDs to filter by
timezonestring- Timezone for date calculations (e.g., "America/New_York")
smartleadmcp_get_campaign_lead_message_historyGet complete message history for a specific lead in a campaignRead-onlyGet campaign lead message history
Get complete message history for a specific lead in a campaign
Inputs
campaign_idnumberrequired- The ID of the campaign
lead_idnumberrequired- The ID of the lead
event_time_gtstring- Filter events after this time
show_plain_text_responseboolean- Show plain text version of emails
smartleadmcp_get_campaign_lead_overviewGet overview of all campaigns a lead is part ofRead-onlyGet campaign lead overview
Get overview of all campaigns a lead is part of
Inputs
leadIdnumberrequired- The lead ID
smartleadmcp_get_campaign_lead_statisticsGet lead-level statistics showing individual lead engagement metricsRead-onlyGet campaign lead statistics
Get lead-level statistics showing individual lead engagement metrics
Inputs
campaign_idnumberrequired- The ID of the campaign
event_time_gtstring- Filter leads with events after this time
limitnumber- Limit for pagination (max 100)
offsetnumber- Offset for pagination
smartleadmcp_get_campaign_lead_to_reply_timeGet metrics on time taken from first email sent to receiving a replyRead-onlyGet campaign lead to reply time
Get metrics on time taken from first email sent to receiving a reply
Inputs
end_datestringrequired- End date in ISO format (YYYY-MM-DD)
start_datestringrequired- Start date in ISO format (YYYY-MM-DD)
campaign_idsstring- Comma-separated list of campaign IDs to filter by
client_idsstring- Comma-separated list of client IDs to filter by
timezonestring- Timezone for date calculations (e.g., "America/New_York")
smartleadmcp_get_campaign_leadsList 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.Read-onlyGet campaign leads
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.
Inputs
campaign_idnumberrequired- The ID of the campaign
emailStatusstring- Filter by email engagementone of
is_openedis_clickedis_bouncedis_repliedis_unsubscribedis_acceptednot_repliedis_sender_bounced lead_category_idinteger- Filter by lead category ID (see get_lead_categories)
limitinteger- Page size (1-100, default 50)default
50 offsetinteger- Number of leads to skip (default 0)default
0 statusstring- Filter by lead status in this campaignone of
STARTEDINPROGRESSCOMPLETEDPAUSEDSTOPPED
smartleadmcp_get_campaign_leads_before_first_replyGet metrics on how many leads are contacted before receiving the first replyRead-onlyGet campaign leads before first reply
Get metrics on how many leads are contacted before receiving the first reply
Inputs
end_datestringrequired- End date in ISO format (YYYY-MM-DD)
start_datestringrequired- Start date in ISO format (YYYY-MM-DD)
campaign_idsstring- Comma-separated list of campaign IDs to filter by
client_idsstring- Comma-separated list of client IDs to filter by
timezonestring- Timezone for date calculations (e.g., "America/New_York")
smartleadmcp_get_campaign_leads_historyGet message history for multiple leads in a campaignRead-onlyGet campaign leads history
Get message history for multiple leads in a campaign
Inputs
campaign_idnumberrequired- The ID of the campaign
event_time_gtstring- Filter events after this time
lead_idsarray- Array of lead IDs to get history for
smartleadmcp_get_campaign_mailbox_statisticsGet mailbox-level performance statistics for a campaignRead-onlyGet campaign mailbox statistics
Get mailbox-level performance statistics for a campaign
Inputs
campaign_idnumberrequired- The ID of the campaign
client_idnumber- Optional client ID filter
end_datestring- End date for statistics
limitnumber- Limit for pagination (max 20)
offsetnumber- Offset for pagination
start_datestring- Start date for statistics
time_zonestring- Timezone for date calculations
smartleadmcp_get_campaign_overall_statsGet campaign-wise performance metrics and statisticsRead-onlyGet campaign overall stats
Get campaign-wise performance metrics and statistics
Inputs
end_datestringrequired- End date in ISO format (YYYY-MM-DD)
start_datestringrequired- Start date in ISO format (YYYY-MM-DD)
campaign_idsstring- Comma-separated list of campaign IDs to filter by
client_idsstring- Comma-separated list of client IDs to filter by
full_datastring- Whether to return full detailed data
limitstring- Number of results to return
offsetstring- Number of results to skip for pagination
timezonestring- Timezone for date calculations (e.g., "America/New_York")
smartleadmcp_get_campaign_response_statsGet detailed response statistics including categorization and sentiment analysisRead-onlyGet campaign response stats
Get detailed response statistics including categorization and sentiment analysis
Inputs
end_datestringrequired- End date in ISO format (YYYY-MM-DD)
start_datestringrequired- Start date in ISO format (YYYY-MM-DD)
campaign_idsstring- Comma-separated list of campaign IDs to filter by
client_idsstring- Comma-separated list of client IDs to filter by
full_datastring- Whether to return full detailed data
timezonestring- Timezone for date calculations (e.g., "America/New_York")
smartleadmcp_get_campaign_sending_volume_auditAudit the sending volume for a campaign.Read-onlyGet campaign sending volume audit
Audit the sending volume for a campaign. Shows email sending patterns, volumes per day, and identifies potential issues.
Inputs
campaignIdnumberrequired- The ID of the campaign to audit
smartleadmcp_get_campaign_sequence_analyticsGet sequence-level analytics for a campaignRead-onlyGet campaign sequence analytics
Get sequence-level analytics for a campaign
Inputs
campaign_idnumberrequired- The ID of the campaign
end_datestringrequired- End date in ISO format (YYYY-MM-DD)
start_datestringrequired- Start date in ISO format (YYYY-MM-DD)
time_zonestring- Timezone for date calculations (e.g., "America/New_York")
smartleadmcp_get_campaign_sequencesGet email sequences for a campaignRead-onlyGet campaign sequences
Get email sequences for a campaign
Inputs
campaign_idnumberrequired- The ID of the campaign
smartleadmcp_get_campaign_statsGet detailed statistics for a campaign including email performance metrics by sequenceRead-onlyGet campaign stats
Get detailed statistics for a campaign including email performance metrics by sequence
Inputs
campaign_idnumberrequired- The ID of the campaign
email_sequence_numbernumber- Filter by specific email sequence number (1-20)
email_statusstring- Filter by email statusone of
openedclickedrepliedunsubscribedbounced limitnumber- Limit for pagination (max 1000)
offsetnumber- Offset for pagination
sent_time_end_datestring- End date for filtering by sent time
sent_time_start_datestring- Start date for filtering by sent time
smartleadmcp_get_campaign_status_statsGet statistics on campaign statuses (active, paused, completed, etc)Read-onlyGet campaign status stats
Get statistics on campaign statuses (active, paused, completed, etc)
Inputs
client_idsstring- Comma-separated list of client IDs to filter by
smartleadmcp_get_campaign_top_level_analytics_by_dateGet top-level campaign analytics for a specific date rangeRead-onlyGet campaign top level analytics by date
Get top-level campaign analytics for a specific date range
Inputs
campaign_idnumberrequired- The ID of the campaign
end_datestringrequired- End date in ISO format (YYYY-MM-DD)
start_datestringrequired- Start date in ISO format (YYYY-MM-DD)
smartleadmcp_get_campaign_variant_statisticsGet A/B test variant performance statistics for a campaignRead-onlyGet campaign variant statistics
Get A/B test variant performance statistics for a campaign
Inputs
campaign_idnumberrequired- The ID of the campaign
client_idnumber- Optional client ID filter
smartleadmcp_get_campaign_webhook_summaryGet webhook execution summary and statistics for a campaignRead-onlyGet campaign webhook summary
Get webhook execution summary and statistics for a campaign
Inputs
campaign_idnumberrequired- The ID of the campaign
fromTimestring- Start date in ISO format
toTimestring- End date in ISO format
smartleadmcp_get_campaign_webhooksGet all webhooks configured for a campaignRead-onlyGet campaign webhooks
Get all webhooks configured for a campaign
Inputs
campaign_idnumberrequired- The ID of the campaign
smartleadmcp_get_campaignsList campaigns, newest first, as compact rows (id, name, status, client_id, parent_campaign_id, created_at).Read-onlyGet campaigns
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.
Inputs
client_idnumber- Filter campaigns by client ID
include_tagsboolean- Include campaign tags in the responsedefault
false limitinteger- Page size (1-100, default 50)default
50 namestring- Filter by campaign name (case-insensitive partial match)
offsetinteger- Number of campaigns to skip (default 0)default
0 statusstring- Filter by campaign statusone of
ACTIVEPAUSEDDRAFTEDCOMPLETEDSTOPPEDARCHIVED
smartleadmcp_get_campaigns_by_lead_idGet all campaigns associated with a specific leadRead-onlyGet campaigns by lead ID
Get all campaigns associated with a specific lead
Inputs
lead_idnumberrequired- The ID of the lead
smartleadmcp_get_client_month_wise_countGet month-wise count of clients for trend analysisRead-onlyGet client month wise count
Get month-wise count of clients for trend analysis
Inputs
client_idsstring- Comma-separated list of client IDs to filter by
smartleadmcp_get_client_overall_statsGet client-wise performance metrics and statisticsRead-onlyGet client overall stats
Get client-wise performance metrics and statistics
Inputs
end_datestringrequired- End date in ISO format (YYYY-MM-DD)
start_datestringrequired- Start date in ISO format (YYYY-MM-DD)
client_idsstring- Comma-separated list of client IDs to filter by
filterstring- Additional filter criteria
full_datastring- Whether to return full detailed data
limitstring- Number of results to return
offsetstring- Number of results to skip for pagination
timezonestring- Timezone for date calculations (e.g., "America/New_York")
smartleadmcp_get_day_wise_overall_statsGet day-by-day breakdown of overall campaign statisticsRead-onlyGet day wise overall stats
Get day-by-day breakdown of overall campaign statistics
Inputs
end_datestringrequired- End date in ISO format (YYYY-MM-DD)
start_datestringrequired- Start date in ISO format (YYYY-MM-DD)
campaign_idsstring- Comma-separated list of campaign IDs to filter by
client_idsstring- Comma-separated list of client IDs to filter by
timezonestring- Timezone for date calculations (e.g., "America/New_York")
smartleadmcp_get_day_wise_overall_stats_by_sent_timeGet day-wise statistics based on email sent time for time-based analysisRead-onlyGet day wise overall stats by sent time
Get day-wise statistics based on email sent time for time-based analysis
Inputs
end_datestringrequired- End date in ISO format (YYYY-MM-DD)
start_datestringrequired- Start date in ISO format (YYYY-MM-DD)
timezonestringrequired- Timezone for date calculations (e.g., "America/New_York")
campaign_idsstring- Comma-separated list of campaign IDs to filter by
client_idsstring- Comma-separated list of client IDs to filter by
smartleadmcp_get_day_wise_positive_reply_statsGet day-by-day breakdown of positive reply statistics and sentiment analysisRead-onlyGet day wise positive reply stats
Get day-by-day breakdown of positive reply statistics and sentiment analysis
Inputs
end_datestringrequired- End date in ISO format (YYYY-MM-DD)
start_datestringrequired- Start date in ISO format (YYYY-MM-DD)
campaign_idsstring- Comma-separated list of campaign IDs to filter by
client_idsstring- Comma-separated list of client IDs to filter by
timezonestring- Timezone for date calculations (e.g., "America/New_York")
smartleadmcp_get_day_wise_positive_reply_stats_by_sent_timeGet day-wise positive reply statistics based on email sent timeRead-onlyGet day wise positive reply stats by sent time
Get day-wise positive reply statistics based on email sent time
Inputs
end_datestringrequired- End date in ISO format (YYYY-MM-DD)
start_datestringrequired- Start date in ISO format (YYYY-MM-DD)
timezonestringrequired- Timezone for date calculations (e.g., "America/New_York")
campaign_idsstring- Comma-separated list of campaign IDs to filter by
client_idsstring- Comma-separated list of client IDs to filter by
smartleadmcp_get_domain_block_listGet list of blocked domains with filtering optionsRead-onlyGet domain block list
Get list of blocked domains with filtering options
Inputs
filter_client_idnumber- Filter by client ID
filter_email_or_domainstring- Filter by email or domain
filter_email_with_domainstring- Filter by email with domain
limitnumber- Limit for pagination (1-1000)
offsetnumber- Offset for pagination (min: 0)
smartleadmcp_get_email_account_by_idGet all the details of a specific email account by IDRead-onlyGet email account by ID
Get all the details of a specific email account by ID
Inputs
idnumberrequired- The ID of the email account to get details of
fetch_campaignsboolean- Whether to fetch the campaigns associated with this email account (default: false)
smartleadmcp_get_email_accountsGet all email accounts with optional filteringRead-onlyGet email accounts
Get all email accounts with optional filtering
Inputs
client_idnumber- Filter by client ID
limitnumber- Limit for pagination (1-100)
offsetnumber- Offset for pagination (min: 0)
usernamestring- Filter by username/email
smartleadmcp_get_email_warmup_statsGet warmup statistics for an email accountRead-onlyGet email warmup stats
Get warmup statistics for an email account
Inputs
email_account_idnumberrequired- The ID of the email account
smartleadmcp_get_global_leadsGet global leads with filtering optionsRead-onlyGet global leads
Get global leads with filtering options
Inputs
created_at_gtstring- Filter leads created after this date/time
emailstring- Filter by email address
limitnumber- Limit for pagination (1-500)
offsetnumber- Offset for pagination (min: 0)
smartleadmcp_get_lead_by_emailGet lead information by email addressRead-onlyGet lead by email
Get lead information by email address
Inputs
emailstringrequired- Email address of the lead
smartleadmcp_get_lead_categoriesGet all available lead categoriesRead-onlyGet lead categories
Get all available lead categories
Inputs
This tool takes no inputs.
smartleadmcp_get_lead_category_wise_responseGet lead response statistics broken down by category for response analysisRead-onlyGet lead category wise response
Get lead response statistics broken down by category for response analysis
Inputs
end_datestringrequired- End date in ISO format (YYYY-MM-DD)
start_datestringrequired- Start date in ISO format (YYYY-MM-DD)
campaign_idsstring- Comma-separated list of campaign IDs to filter by
client_idsstring- Comma-separated list of client IDs to filter by
timezonestring- Timezone for date calculations (e.g., "America/New_York")
smartleadmcp_get_lead_overall_statsGet comprehensive lead statistics including status distribution and engagement metricsRead-onlyGet lead overall stats
Get comprehensive lead statistics including status distribution and engagement metrics
Inputs
end_datestringrequired- End date in ISO format (YYYY-MM-DD)
start_datestringrequired- Start date in ISO format (YYYY-MM-DD)
campaign_idsstring- Comma-separated list of campaign IDs to filter by
client_idsstring- Comma-separated list of client IDs to filter by
timezonestring- Timezone for date calculations (e.g., "America/New_York")
smartleadmcp_get_lead_sequence_detailsGet detailed sequence information for a specific lead in a campaignRead-onlyGet lead sequence details
Get detailed sequence information for a specific lead in a campaign
Inputs
leadMapIdnumberrequired- The lead map ID
campaignIdnumber- Optional campaign ID for context
smartleadmcp_get_mailbox_domain_wise_health_metricsGet email health metrics grouped by domain for monitoring domain reputationRead-onlyGet mailbox domain wise health metrics
Get email health metrics grouped by domain for monitoring domain reputation
Inputs
end_datestringrequired- End date in ISO format (YYYY-MM-DD)
start_datestringrequired- Start date in ISO format (YYYY-MM-DD)
campaign_idsstring- Comma-separated list of campaign IDs to filter by
client_idsstring- Comma-separated list of client IDs to filter by
full_datastring- Whether to return full detailed data
limitstring- Number of results to return
offsetstring- Number of results to skip for pagination
timezonestring- Timezone for date calculations (e.g., "America/New_York")
smartleadmcp_get_mailbox_name_wise_health_metricsGet email health metrics grouped by mailbox name for monitoring deliverabilityRead-onlyGet mailbox name wise health metrics
Get email health metrics grouped by mailbox name for monitoring deliverability
Inputs
end_datestringrequired- End date in ISO format (YYYY-MM-DD)
start_datestringrequired- Start date in ISO format (YYYY-MM-DD)
campaign_idsstring- Comma-separated list of campaign IDs to filter by
client_idsstring- Comma-separated list of client IDs to filter by
full_datastring- Whether to return full detailed data
limitstring- Number of results to return
offsetstring- Number of results to skip for pagination
timezonestring- Timezone for date calculations (e.g., "America/New_York")
smartleadmcp_get_mailbox_overall_statsGet overall mailbox statistics including health scores and capacityRead-onlyGet mailbox overall stats
Get overall mailbox statistics including health scores and capacity
Inputs
client_idsstring- Comma-separated list of client IDs to filter by
smartleadmcp_get_mailbox_provider_wise_performanceGet email performance metrics grouped by email provider (Gmail, Outlook, etc)Read-onlyGet mailbox provider wise performance
Get email performance metrics grouped by email provider (Gmail, Outlook, etc)
Inputs
end_datestringrequired- End date in ISO format (YYYY-MM-DD)
start_datestringrequired- Start date in ISO format (YYYY-MM-DD)
campaign_idsstring- Comma-separated list of campaign IDs to filter by
client_idsstring- Comma-separated list of client IDs to filter by
full_datastring- Whether to return full detailed data
timezonestring- Timezone for date calculations (e.g., "America/New_York")
smartleadmcp_get_master_inbox_by_idGet detailed information about a specific master inbox email by IDRead-onlyGet master inbox by ID
Get detailed information about a specific master inbox email by ID
Inputs
idnumberrequired- The master inbox item ID
smartleadmcp_get_overall_stats_v2Get comprehensive overall statistics for campaigns with advanced filtering optionsRead-onlyGet overall stats V2
Get comprehensive overall statistics for campaigns with advanced filtering options
Inputs
end_datestringrequired- End date in ISO format (YYYY-MM-DD)
start_datestringrequired- Start date in ISO format (YYYY-MM-DD)
campaign_idsstring- Comma-separated list of campaign IDs to filter by
client_idsstring- Comma-separated list of client IDs to filter by
full_datastring- Whether to return full detailed data
is_agencystring- Filter for agency accounts
timezonestring- Timezone for date calculations (e.g., "America/New_York")
smartleadmcp_get_team_board_overall_statsGet team member performance statistics for team management and optimizationRead-onlyGet team board overall stats
Get team member performance statistics for team management and optimization
Inputs
end_datestringrequired- End date in ISO format (YYYY-MM-DD)
start_datestringrequired- Start date in ISO format (YYYY-MM-DD)
campaign_idsstring- Comma-separated list of campaign IDs to filter by
client_idsstring- Comma-separated list of client IDs to filter by
full_datastring- Whether to return full detailed data
timezonestring- Timezone for date calculations (e.g., "America/New_York")
smartleadmcp_investigate_leadInvestigate a specific lead to understand their journey, interactions, and any issues.Read-onlyInvestigate lead
Investigate a specific lead to understand their journey, interactions, and any issues.
Inputs
leadIdnumberrequired- The ID of the lead to investigate
smartleadmcp_sd_get_email_headersHeaders of the copy received at the seed inbox (SPF/DKIM/DMARC results, spam verdict headers, routing).Read-onlySmart Delivery: Get email headers
Headers of the copy received at the seed inbox (SPF/DKIM/DMARC results, spam verdict headers, routing).
Inputs
assignment_idintegerrequired- Email assignment ID (from sd_list_run_emails)
run_idstringrequired- Run ID (UUID, from sd_get_test or sd_get_test_history)
smartleadmcp_sd_get_email_traceTimeline of one test email: sent, delivered, found (or missing / bounced), with the provider responses.Read-onlySmart Delivery: Get email trace
Timeline of one test email: sent, delivered, found (or missing / bounced), with the provider responses.
Inputs
assignment_idintegerrequired- Email assignment ID (from sd_list_run_emails)
run_idstringrequired- Run ID (UUID, from sd_get_test or sd_get_test_history)
smartleadmcp_sd_get_limitsSmart Delivery plan limits: run credits left this billing period, max sender mailboxes per test, seeds per sender per provider.Read-onlySmart Delivery: Get limits
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.
Inputs
This tool takes no inputs.
smartleadmcp_sd_get_report_summaryAccount-wide Smart Delivery placement totals (inbox / spam / missing ...) across all tests over a date range (max 400 days).Read-onlySmart Delivery: Get report summary
Account-wide Smart Delivery placement totals (inbox / spam / missing ...) across all tests over a date range (max 400 days).
Inputs
fromstring- Start day, YYYY-MM-DD (UTC). Default: 29 days before to
tostring- End day, YYYY-MM-DD (UTC), inclusive. Default: today
smartleadmcp_sd_get_runGet one Smart Delivery run: status, timing, skipped senders, and email counts by placement and send status.Read-onlySmart Delivery: Get run
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.
Inputs
run_idstringrequired- Run ID (UUID, from sd_get_test or sd_get_test_history)
smartleadmcp_sd_get_run_placementLive placement of a run while it collects (inbox / spam / missing ...Read-onlySmart Delivery: Get run placement
Live placement of a run while it collects (inbox / spam / missing ... so far). For a finished run use sd_get_run_report.
Inputs
run_idstringrequired- Run ID (UUID, from sd_get_test or sd_get_test_history)
smartleadmcp_sd_get_run_reportReport of a finished run: score, band, headline, recommendations, placement counts, time to inbox, by provider and by sender.Read-onlySmart Delivery: Get run report
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.
Inputs
run_idstringrequired- Run ID (UUID, from sd_get_test or sd_get_test_history)
include_diagnosticsboolean- Add DNS, blacklist, content and spam checksdefault
false
smartleadmcp_sd_get_testGet a Smart Delivery test: settings, schedule, providers, sender mailboxes and its latest 10 runs (newest first).Read-onlySmart Delivery: Get test
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.
Inputs
test_idstringrequired- Test ID (UUID, from sd_list_tests)
smartleadmcp_sd_get_test_historyRun reports of one test over a date range (oldest first within a page; the cursor steps back to older runs).Read-onlySmart Delivery: Get test history
Run reports of one test over a date range (oldest first within a page; the cursor steps back to older runs). Good for trends.
Inputs
test_idstringrequired- Test ID (UUID, from sd_list_tests)
cursorstring- nextCursor from the previous page; omit for the first page
fromstring- Start day, YYYY-MM-DD (UTC). Default: 29 days before to
limitinteger- Runs per page (1-100, default 20)default
20 tostring- End day, YYYY-MM-DD (UTC), inclusive. Default: today
smartleadmcp_sd_list_foldersList Smart Delivery test folders.Read-onlySmart Delivery: List folders
List Smart Delivery test folders.
Inputs
This tool takes no inputs.
smartleadmcp_sd_list_providersList the inbox providers a test can measure placement at (Gmail, Outlook, ...).Read-onlySmart Delivery: List providers
List the inbox providers a test can measure placement at (Gmail, Outlook, ...). Use their ids as provider_ids in sd_create_test.
Inputs
This tool takes no inputs.
smartleadmcp_sd_list_run_emailsPer-email results of a run (sender, provider, placement, send status, error).Read-onlySmart Delivery: List run emails
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.
Inputs
run_idstringrequired- Run ID (UUID, from sd_get_test or sd_get_test_history)
cursorstring- nextCursor from the previous page; omit for the first page
limitinteger- Page size (1-200, default 25)default
25 placementstring- No description.one of
INBOXTABSPAMMISSINGUNREADABLENOT_SENTUNCONFIRMEDPENDINGBOUNCED providerstring- Provider code (sd_list_providers)
sender_idinteger- Sender email account id
smartleadmcp_sd_list_run_seedsSeed inboxes a run sent to (provider and sending mailbox for each).Read-onlySmart Delivery: List run seeds
Seed inboxes a run sent to (provider and sending mailbox for each).
Inputs
run_idstringrequired- Run ID (UUID, from sd_get_test or sd_get_test_history)
smartleadmcp_sd_list_testsList Smart Delivery placement tests, newest first, each with its latest report score.Read-onlySmart Delivery: List tests
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.
Inputs
cursorstring- nextCursor from the previous page; omit for the first page
folder_idinteger- Folder ID (from sd_list_folders)
limitinteger- Page size (1-100, default 20)default
20 statusstring- No description.one of
ACTIVEPAUSEDCOMPLETEDSTOPPED typestring- MANUAL = one run; AUTO = scheduled runsone of
MANUALAUTO
smartleadmcp_sp_export_contactsExport Smart Prospect contacts as CSV for a given filter ID with optional filteringRead-onlySmart Prospect: Export contacts
Export Smart Prospect contacts as CSV for a given filter ID with optional filtering
Inputs
filter_idstringrequired- Filter ID to export contacts for
catch_all_statusstring- Filter by catch-all sub-status
chunk_sizestring- Records per chunk (default 5000)
limitstring- Max records to export (all if not provided)
searchstring- Filter by name
verification_statusstring- Filter by verification statusone of
validcatch_allinvalid
smartleadmcp_sp_get_all_contactsRetrieve all contacts for a filter ID in email_leads format suitable for campaign import.Read-onlySmart Prospect: Get all contacts
Retrieve all contacts for a filter ID in email_leads format suitable for campaign import. Provide either filter_id or lead_ids
Inputs
catch_all_statusstring- Filter by catch-all sub-status
filter_idnumber- Filter ID to get all contacts for
lead_idsarray- Array of adapt_ids to retrieve
verification_statusstring- Filter by email verification statusone of
validcatch_allinvalid
smartleadmcp_sp_get_citiesList all active cities for Smart Prospect search filters with pagination, search, and optional state/country filteringRead-onlySmart Prospect: Get cities
List all active cities for Smart Prospect search filters with pagination, search, and optional state/country filtering
Inputs
countrystring- Filter by country name(s), comma-separated. Requires state parameter
limitstring- Number of records (1-100, default "10")
offsetstring- Records to skip (default "0")
searchstring- Filter city names starting with this value
statestring- Filter by state name(s), comma-separated (e.g., "california,texas")
smartleadmcp_sp_get_company_autocompleteSearch company names from Elasticsearch for autocomplete in Smart ProspectRead-onlySmart Prospect: Get company autocomplete
Search company names from Elasticsearch for autocomplete in Smart Prospect
Inputs
searchstringrequired- Company name to search for
limitstring- Number of results (default "100")
offsetstring- Records to skip (default "0")
smartleadmcp_sp_get_contactsRetrieve previously fetched Smart Prospect contacts by filter ID or adapt IDs, with optional filtering by verification status and paginationRead-onlySmart Prospect: Get contacts
Retrieve previously fetched Smart Prospect contacts by filter ID or adapt IDs, with optional filtering by verification status and pagination
Inputs
catch_all_statusstring- Filter by catch-all sub-statusone of
catch_all_verifiedcatch_all_soft_bouncedcatch_all_hard_bouncedcatch_all_unknowncatch_all_bounced filter_idnumber- Filter ID to get contacts for
idarray- Array of adapt_ids (max 200)
limitnumber- Records to return (1-1000)
offsetnumber- Records to skip (min 0)
searchstring- Filter by first_name, last_name, or full_name
verification_statusstring- Filter by email verification statusone of
validcatch_allinvalid
smartleadmcp_sp_get_countriesList all active countries for Smart Prospect search filters with pagination and searchRead-onlySmart Prospect: Get countries
List all active countries for Smart Prospect search filters with pagination and search
Inputs
limitstring- Number of records (1-100, default "10")
offsetstring- Records to skip (default "0")
searchstring- Filter country names starting with this value
smartleadmcp_sp_get_departmentsList all active departments for Smart Prospect search filters with pagination and searchRead-onlySmart Prospect: Get departments
List all active departments for Smart Prospect search filters with pagination and search
Inputs
limitstring- Number of records (1-100, default "10")
offsetstring- Records to skip (default "0")
searchstring- Filter department names starting with this value
smartleadmcp_sp_get_domain_autocompleteSearch domain names from Elasticsearch for autocomplete in Smart ProspectRead-onlySmart Prospect: Get domain autocomplete
Search domain names from Elasticsearch for autocomplete in Smart Prospect
Inputs
searchstringrequired- Domain name to search for
limitstring- Number of results (default "100")
offsetstring- Records to skip (default "0")
smartleadmcp_sp_get_fetched_leadsRetrieve the user's fetched lead records (searches where contacts were actually fetched/revealed)Read-onlySmart Prospect: Get fetched leads
Retrieve the user's fetched lead records (searches where contacts were actually fetched/revealed)
Inputs
limitstring- Records per page (default "10")
offsetstring- Records to skip (default "0")
smartleadmcp_sp_get_head_countsList all active employee headcount ranges for Smart Prospect search filtersRead-onlySmart Prospect: Get head counts
List all active employee headcount ranges for Smart Prospect search filters
Inputs
limitstring- Number of records (1-100, default "10")
offsetstring- Records to skip (default "0")
searchstring- Filter head count ranges starting with this value
smartleadmcp_sp_get_industriesList all active industries for Smart Prospect search filters with pagination, search, and optional sub-industry inclusionRead-onlySmart Prospect: Get industries
List all active industries for Smart Prospect search filters with pagination, search, and optional sub-industry inclusion
Inputs
limitstring- Number of records (1-100, default "10")
offsetstring- Records to skip (default "0")
searchstring- Filter industry names starting with this value
withSubIndustrystring- Set to "true" to include sub-industries for each industry
smartleadmcp_sp_get_job_title_autocompleteSearch job titles from Elasticsearch for autocomplete in Smart ProspectRead-onlySmart Prospect: Get job title autocomplete
Search job titles from Elasticsearch for autocomplete in Smart Prospect
Inputs
searchstringrequired- Job title to search for
limitstring- Number of results (default "100")
offsetstring- Records to skip (default "0")
smartleadmcp_sp_get_keywords_autocompleteSearch company keywords from Elasticsearch for autocomplete in Smart ProspectRead-onlySmart Prospect: Get keywords autocomplete
Search company keywords from Elasticsearch for autocomplete in Smart Prospect
Inputs
searchstringrequired- Keyword to search for
limitstring- Number of results (default "100")
offsetstring- Records to skip (default "0")
smartleadmcp_sp_get_levelsList all active seniority levels for Smart Prospect search filters (e.g., C-Level, VP, Director)Read-onlySmart Prospect: Get levels
List all active seniority levels for Smart Prospect search filters (e.g., C-Level, VP, Director)
Inputs
limitstring- Number of records (1-100, default "10")
offsetstring- Records to skip (default "0")
searchstring- Filter level names starting with this value
smartleadmcp_sp_get_pending_countGet the number of contacts still pending email discovery for a Smart Prospect filterRead-onlySmart Prospect: Get pending count
Get the number of contacts still pending email discovery for a Smart Prospect filter
Inputs
filter_idstringrequired- Filter ID to check pending count for
smartleadmcp_sp_get_recent_searchesRetrieve the user's recent (unsaved) Smart Prospect searches with paginationRead-onlySmart Prospect: Get recent searches
Retrieve the user's recent (unsaved) Smart Prospect searches with pagination
Inputs
limitstring- Records per page (default "10")
offsetstring- Records to skip (default "0")
smartleadmcp_sp_get_reply_analyticsGet Smart Prospect reply analytics comparing current month vs previous monthRead-onlySmart Prospect: Get reply analytics
Get Smart Prospect reply analytics comparing current month vs previous month
Inputs
This tool takes no inputs.
smartleadmcp_sp_get_revenue_rangesGet all active revenue range options for Smart Prospect search filtersRead-onlySmart Prospect: Get revenue ranges
Get all active revenue range options for Smart Prospect search filters
Inputs
This tool takes no inputs.
smartleadmcp_sp_get_saved_searchesRetrieve the user's saved Smart Prospect searches with paginationRead-onlySmart Prospect: Get saved searches
Retrieve the user's saved Smart Prospect searches with pagination
Inputs
limitstring- Records per page (default "10")
offsetstring- Records to skip (default "0")
smartleadmcp_sp_get_search_analyticsGet Smart Prospect search and credit usage analytics including leads found, emails fetched, available credits, and daily limitsRead-onlySmart Prospect: Get search analytics
Get Smart Prospect search and credit usage analytics including leads found, emails fetched, available credits, and daily limits
Inputs
filter_idstring- Optional filter ID to get filter-specific analytics
smartleadmcp_sp_get_statesList all active states for Smart Prospect search filters with pagination, search, and optional country filteringRead-onlySmart Prospect: Get states
List all active states for Smart Prospect search filters with pagination, search, and optional country filtering
Inputs
countrystring- Filter by country name(s), comma-separated (e.g., "india,usa,canada")
limitstring- Number of records (1-100, default "10")
offsetstring- Records to skip (default "0")
searchstring- Filter state names starting with this value
smartleadmcp_sp_get_sub_industriesList all active sub-industries for Smart Prospect search filters with pagination, search, and optional industry filteringRead-onlySmart Prospect: Get sub industries
List all active sub-industries for Smart Prospect search filters with pagination, search, and optional industry filtering
Inputs
industry_idstring- Filter by parent industry ID or comma-separated IDs (e.g., "1,2,3")
limitstring- Number of records (1-100, default "10")
offsetstring- Records to skip (default "0")
searchstring- Filter sub-industry names starting with this value
smartleadmcp_sp_get_technologiesList all active technologies for Smart Prospect search filters with pagination and searchRead-onlySmart Prospect: Get technologies
List all active technologies for Smart Prospect search filters with pagination and search
Inputs
limitstring- Number of records (1-100, default "10")
offsetstring- Records to skip (default "0")
searchstring- Filter technology names starting with this value
smartleadmcp_sp_search_contactsSearch the Smart Prospect contact database using multiple filter criteria.Read-onlySmart Prospect: Search contacts
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
Inputs
limitnumberrequired- Results per page (1-500)
cityarray- City filters (max 2000)
companyDomainarray- Company domain filters (max 2000)
companyDomainExactMatchboolean- Exact match for company domain filter
companyExactMatchboolean- Exact match for company filter
companyHeadCountarray- Employee range filters (max 2000)
companyIndustryarray- Industry filters (max 2000)
companyKeywordarray- Company keyword filters (max 2000)
companyNamearray- Company name filters (max 2000)
companyRevenuearray- Revenue range filters (max 2000)
companySubIndustryarray- Sub-industry filters (max 2000)
countryarray- Country filters (max 2000)
departmentarray- Department filters (max 2000)
dontDisplayOwnedContactboolean- Exclude contacts already fetched by user
excludeCompanyarray- Exclude companies (max 2000)
excludeCompanyDomainarray- Exclude company domains (max 2000)
excludeTitlearray- Exclude contacts with these titles (max 2000)
firstNamearray- First name filters (max 2000)
includeCompanyarray- Include companies (max 2000)
includeCompanyDomainarray- Include company domains (max 2000)
includeTitlearray- Include contacts with these titles (max 2000)
lastNamearray- Last name filters (max 2000)
levelarray- Seniority level filters (max 2000)
linkedin_urlarray- Search by LinkedIn URL (max 100)
namearray- Full name filters (max 2000)
person_lookalike_idarray- Find similar people by adapt IDs (max 100)
scroll_idstring- Cursor for pagination from previous response
statearray- State filters (max 2000)
titlearray- Job title filters (max 2000)
titleExactMatchboolean- Exact match for title filter
smartleadmcp_add_domain_block_listAdd domains to the block list to prevent sending emails to those domainsWriteAdd domain block list
Add domains to the block list to prevent sending emails to those domains
Inputs
domainsarrayrequired- Array of domains to block
client_idnumber- Optional client ID for client-specific block list
smartleadmcp_add_email_accounts_to_campaignAdd email accounts to a campaign for sendingWriteAdd email accounts to campaign
Add email accounts to a campaign for sending
Inputs
campaign_idnumberrequired- The ID of the campaign
email_account_idsarrayrequired- Array of email account IDs to add
auto_adjust_warmupboolean- Auto-adjust warmup settings
smartleadmcp_create_campaignCreate a new campaign (status DRAFTED).WriteCreate campaign
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.
Inputs
namestringrequired- Campaign name
client_idinteger- Client ID (can be null for no client association)
smartleadmcp_create_master_inbox_lead_noteCreate a note for a lead in master inboxWriteCreate master inbox lead note
Create a note for a lead in master inbox
Inputs
email_lead_map_idnumberrequired- The email lead map ID
note_messagestringrequired- Note content
smartleadmcp_create_master_inbox_lead_taskCreate a task for a lead in master inboxWriteCreate master inbox lead task
Create a task for a lead in master inbox
Inputs
email_lead_map_idnumberrequired- The email lead map ID
namestringrequired- Task name
descriptionstring- Task description
due_datestring- Due date in ISO format
prioritystring- Task priorityone of
LOWMEDIUMHIGHdefaultMEDIUM
smartleadmcp_push_leads_from_campaign_to_listPush specific leads from a campaign to a listWritePush leads from campaign to list
Push specific leads from a campaign to a list
Inputs
campaignIdnumberrequired- The source campaign ID
listIdnumberrequired- The target list ID
leadMapIdsarray- Array of lead map IDs to push (max 100)
smartleadmcp_push_leads_to_listPush leads from all leads view to a listWritePush leads to list
Push leads from all leads view to a list
Inputs
leadIdsarrayrequired- Array of lead IDs to push (max 100)
listIdnumberrequired- The target list ID
smartleadmcp_sd_create_folderCreate a folder to group Smart Delivery tests.WriteSmart Delivery: Create folder
Create a folder to group Smart Delivery tests.
Inputs
namestringrequired- No description.
smartleadmcp_sd_refresh_limitsRe-read Smart Delivery plan credits from Smartlead and return the updated limits.WriteSmart Delivery: Refresh limits
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.
Inputs
This tool takes no inputs.
smartleadmcp_set_master_inbox_reminderSet a reminder for a lead in master inboxWriteSet master inbox reminder
Set a reminder for a lead in master inbox
Inputs
email_lead_map_idnumberrequired- The email lead map ID
email_stats_idstringrequired- The email stats ID
messagestringrequired- Reminder message
reminder_timestringrequired- Reminder time in ISO format
smartleadmcp_sp_save_searchSave a set of Smart Prospect search filters as a named saved searchWriteSmart Prospect: Save search
Save a set of Smart Prospect search filters as a named saved search
Inputs
search_stringstringrequired- Name for the saved search (min 1 char)
cityarray- City filters
companyDomainarray- Company domain filters
companyHeadCountarray- Employee range filters
companyIndustryarray- Industry filters
companyNamearray- Company name filters
countryarray- Country filters
departmentarray- Department filters
levelarray- Seniority level filters
limitnumber- Results limit for the search
statearray- State filters
titlearray- Job title filters
smartleadmcp_add_leads_to_campaignAdd leads to a campaign.DestructiveAdd leads to campaign
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.
Inputs
campaign_idnumberrequired- The ID of the campaign
lead_listarray- Array of lead objects to add to the campaign (max 1000). This is the preferred parameter name matching the SmartLead API contract.
leadsarray- DEPRECATED — use `lead_list` instead. Accepted as a backward-compatibility alias and mapped to `lead_list`.
settingsobject- 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).
smartleadmcp_block_master_inbox_domainsBlock domains from receiving emailsDestructiveBlock master inbox domains
Block domains from receiving emails
Inputs
domainsarrayrequired- Array of domains to block
sourcestring- Source of the block requestdefault
manual
smartleadmcp_bulk_delete_email_accountsBulk delete multiple SMTP email accountsDestructiveBulk delete email accounts
Bulk delete multiple SMTP email accounts
Inputs
emailAccountIdsarrayrequired- Array of email account IDs to delete
smartleadmcp_change_master_inbox_read_statusChange the read status of a lead in master inboxDestructiveChange master inbox read status
Change the read status of a lead in master inbox
Inputs
email_lead_map_idnumberrequired- The email lead map ID
read_statusbooleanrequired- True to mark as read, false to mark as unread
smartleadmcp_delete_campaignDelete a campaign permanentlyDestructiveDelete campaign
Delete a campaign permanently
Inputs
campaign_idnumberrequired- The ID of the campaign to delete
smartleadmcp_delete_campaign_leadDelete a lead from a campaignDestructiveDelete campaign lead
Delete a lead from a campaign
Inputs
campaign_idnumberrequired- The ID of the campaign
lead_idnumberrequired- The ID of the lead to delete
smartleadmcp_delete_campaign_webhookDelete a webhook from a campaignDestructiveDelete campaign webhook
Delete a webhook from a campaign
Inputs
campaign_idnumberrequired- The ID of the campaign
idnumber- The webhook ID to delete
smartleadmcp_delete_email_accountDelete a single email accountDestructiveDelete email account
Delete a single email account
Inputs
account_idnumberrequired- The email account ID to delete
smartleadmcp_delete_email_accounts_from_campaignRemove email accounts from a campaignDestructiveDelete email accounts from campaign
Remove email accounts from a campaign
Inputs
campaign_idnumberrequired- The ID of the campaign
email_account_idsarrayrequired- Array of email account IDs to remove
smartleadmcp_disconnect_google_accountDisconnect a Gmail OAuth accountDestructiveDisconnect google account
Disconnect a Gmail OAuth account
Inputs
emailAccountIdnumberrequired- The Gmail account ID to disconnect
smartleadmcp_disconnect_microsoft_accountDisconnect an Outlook/Microsoft OAuth accountDestructiveDisconnect microsoft account
Disconnect an Outlook/Microsoft OAuth account
Inputs
emailAccountIdnumberrequired- The Outlook account ID to disconnect
smartleadmcp_forward_campaign_emailForward an email from a campaign to other recipientsDestructiveForward campaign email
Forward an email from a campaign to other recipients
Inputs
campaign_idnumberrequired- The ID of the campaign
message_idstringrequired- The message ID to forward
stats_idstringrequired- The email statistics ID
to_emailsstringrequired- Comma-separated list of recipient emails
smartleadmcp_mark_lead_as_completeManually mark a lead as complete in a campaignDestructiveMark lead as complete
Manually mark a lead as complete in a campaign
Inputs
campaign_idnumberrequired- The ID of the campaign
lead_map_idnumberrequired- The lead map ID
smartleadmcp_mark_master_inbox_lead_as_unreadMark a lead as unread in master inbox (deprecated - use change_master_inbox_read_status)DestructiveMark master inbox lead as unread
Mark a lead as unread in master inbox (deprecated - use change_master_inbox_read_status)
Inputs
email_lead_map_idnumberrequired- The email lead map ID
smartleadmcp_move_leads_between_listsCopy or move leads between listsDestructiveMove leads between lists
Copy or move leads between lists
Inputs
actionstringrequired- Whether to copy or move the leadsone of
copymove toListIdnumberrequired- The target list ID
fromListIdnumber- Source list ID (provide either fromListId or leadIds)
leadIdsarray- Array of lead IDs (provide either fromListId or leadIds, max 10000)
smartleadmcp_pause_leadPause a lead in a campaignDestructivePause lead
Pause a lead in a campaign
Inputs
campaign_idnumberrequired- The ID of the campaign
lead_idnumberrequired- The ID of the lead
smartleadmcp_process_single_failed_email_accountProcess and reconnect a single failed email accountDestructiveProcess single failed email account
Process and reconnect a single failed email account
Inputs
emailAccountIdnumberrequired- The email account ID to process
smartleadmcp_push_leads_to_campaignCopy or move EXISTING leads (from a lead list or by lead ID) into a campaign.DestructivePush leads to campaign
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.
Inputs
actionstringrequired- Whether to copy or move the leadsone of
copymove campaignIdnumberrequired- The target campaign ID
csvSettingsobject- Optional CSV import settings
leadIdsarray- Array of lead IDs (provide either listId or leadIds, max 100)
listIdnumber- Source list ID (provide either listId or leadIds)
smartleadmcp_push_to_master_inbox_subsequencePush a lead to a subsequence campaignDestructivePush to master inbox subsequence
Push a lead to a subsequence campaign
Inputs
email_lead_map_idnumberrequired- The email lead map ID
sub_sequence_idnumberrequired- The subsequence ID
stop_lead_on_parent_campaign_replyboolean- Stop lead if they reply to parent campaigndefault
false sub_sequence_delay_timenumber- Delay time in minutes before starting subsequencedefault
0
smartleadmcp_reconnect_failed_email_accountsBulk reconnect all failed email accountsDestructiveReconnect failed email accounts
Bulk reconnect all failed email accounts
Inputs
This tool takes no inputs.
smartleadmcp_resume_leadResume a paused lead in a campaignDestructiveResume lead
Resume a paused lead in a campaign
Inputs
campaign_idnumberrequired- The ID of the campaign
lead_idnumberrequired- The ID of the lead
smartleadmcp_resume_lead_with_delayResume a paused lead with an optional delay in daysDestructiveResume lead with delay
Resume a paused lead with an optional delay in days
Inputs
campaign_idnumberrequired- The ID of the campaign
lead_idnumberrequired- The ID of the lead
resume_lead_with_delay_daysnumber- Number of days to wait before resuming
smartleadmcp_resume_master_inbox_leadResume a paused lead in a campaignDestructiveResume master inbox lead
Resume a paused lead in a campaign
Inputs
campaign_idnumberrequired- The campaign ID
email_lead_map_idnumberrequired- The email lead map ID
resume_delay_daysnumber- Number of days to delay before resuming
smartleadmcp_retrigger_campaign_webhooksRetrigger failed webhook events for a campaignDestructiveRetrigger campaign webhooks
Retrigger failed webhook events for a campaign
Inputs
campaign_idnumberrequired- The ID of the campaign
fromTimestring- Start date in ISO format
toTimestring- End date in ISO format
smartleadmcp_save_campaign_sequencesFULL 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.DestructiveSave campaign sequences
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:".
Inputs
campaign_idnumberrequired- The ID of the campaign
sequencesarrayrequired- Array of email sequences (at least 1).
smartleadmcp_save_campaign_webhookCreate or update a webhook for a campaignDestructiveSave campaign webhook
Create or update a webhook for a campaign
Inputs
campaign_idnumberrequired- The ID of the campaign
event_typesarrayrequired- Event types to trigger webhook
namestringrequired- Webhook name
webhook_urlstringrequired- Webhook URL
categoriesarray- Categories to filter events
idnumber- Webhook ID (for updates)
smartleadmcp_sd_create_testCreate a Smart Delivery inbox placement test.DestructiveSmart Delivery: Create test
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).
Inputs
campaign_idintegerrequired- SmartLead campaign whose email is tested
email_account_idsarrayrequired- Sender mailboxes attached to the campaign (max per test: sd_get_limits)
namestringrequired- No description.
provider_idsarrayrequired- No description.
sequence_idintegerrequired- Sequence step id (get_campaign_sequences)
typestringrequired- MANUAL = one run now; AUTO = runs on a scheduleone of
MANUALAUTO descriptionstring- No description.
ends_atstring- AUTO only, optional: no runs after this (ends_at or max_runs, not both). MANUAL: omit.
folder_idinteger- Folder ID (from sd_list_folders)
max_runsinteger- AUTO only, optional: stop after this many runs. MANUAL: omit.
scheduleobject- AUTO: required (when runs happen; each run sends real emails and uses one run credit). MANUAL: omit.
send_all_at_onceboolean- Send every test email immediately (or give send_gap)
send_gapobject- Spacing between test emails (min 5 minutes, max 30 days). Use instead of send_all_at_once: true.
starts_atstring- AUTO: required. First run not before this ISO time (must be in the future). MANUAL: omit.
variant_idinteger- A/B variant id of that step. Omit for a step without variants (required when the step has variants).
smartleadmcp_sd_delete_folderDelete a Smart Delivery folder.DestructiveSmart Delivery: Delete folder
Delete a Smart Delivery folder.
Inputs
folder_idintegerrequired- Folder ID (from sd_list_folders)
smartleadmcp_sd_delete_testDelete a test: it disappears from lists and its schedule stops.DestructiveSmart Delivery: Delete test
Delete a test: it disappears from lists and its schedule stops. Refused while a run is in progress.
Inputs
test_idstringrequired- Test ID (UUID, from sd_list_tests)
smartleadmcp_sd_pause_testPause an ACTIVE AUTO test: no further scheduled runs until resumed.DestructiveSmart Delivery: Pause test
Pause an ACTIVE AUTO test: no further scheduled runs until resumed.
Inputs
test_idstringrequired- Test ID (UUID, from sd_list_tests)
smartleadmcp_sd_rename_folderRename a Smart Delivery folder.DestructiveSmart Delivery: Rename folder
Rename a Smart Delivery folder.
Inputs
folder_idintegerrequired- Folder ID (from sd_list_folders)
namestringrequired- No description.
smartleadmcp_sd_resume_testResume a PAUSED AUTO test.DestructiveSmart Delivery: Resume test
Resume a PAUSED AUTO test. Its scheduled runs SEND REAL EMAILS and USE RUN CREDITS again. Confirm with the user before calling.
Inputs
test_idstringrequired- Test ID (UUID, from sd_list_tests)
smartleadmcp_sd_stop_testStop a test for good: no further runs.DestructiveSmart Delivery: Stop test
Stop a test for good: no further runs. It cannot be resumed.
Inputs
test_idstringrequired- Test ID (UUID, from sd_list_tests)
smartleadmcp_sd_update_testUpdate a Smart Delivery test: name, description, folder (null = no folder), AUTO schedule or email spacing.DestructiveSmart Delivery: Update test
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.
Inputs
test_idstringrequired- Test ID (UUID, from sd_list_tests)
descriptionstring- No description.
folder_idinteger- Folder ID, or null to remove from its folder
namestring- No description.
scheduleobject- AUTO: required (when runs happen; each run sends real emails and uses one run credit). MANUAL: omit.
send_all_at_onceboolean- No description.
send_gapobject- Spacing between test emails (min 5 minutes, max 30 days). Use instead of send_all_at_once: true.
smartleadmcp_send_campaign_email_threadSend a reply email in an existing email threadDestructiveSend campaign email thread
Send a reply email in an existing email thread
Inputs
campaign_idnumberrequired- The ID of the campaign
email_bodystringrequired- The email body content
email_stats_idstringrequired- The email statistics ID
add_signatureboolean- Whether to add email signature
attachmentsarray- Email attachments
bccstring- BCC recipients
ccstring- CC recipients
reply_email_bodystring- Body of the email being replied to
reply_email_timestring- Time of the email being replied to
reply_message_idstring- Message ID being replied to
schedule_conditionstring- Scheduling condition
scheduled_timestring- When to send the email
seq_typestring- Sequence type
to_emailstring- Recipient email address
to_first_namestring- Recipient first name
to_last_namestring- Recipient last name
smartleadmcp_sp_fetch_contactsFetch/reveal email addresses for contacts from a Smart Prospect search.DestructiveSmart Prospect: Fetch contacts
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
Inputs
filter_idnumberrequired- Filter ID from search results (required)
idarray- Array of specific adapt_ids to fetch
limitnumber- Number of contacts to fetch (1-10000; some users up to 30000)
visual_limitnumber- Page size for visual display (1-1000, default 10)
visual_offsetnumber- Offset for visual display (default 0)
smartleadmcp_sp_find_emailsFind email addresses for up to 10 contacts by first name, last name, and company domain.DestructiveSmart Prospect: Find emails
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)
Inputs
contactsarrayrequired- Array of contacts to find emails for (max 10)
smartleadmcp_sp_review_contactsTrigger a review/recount of Smart Prospect contacts and metrics for a filter.DestructiveSmart Prospect: Review contacts
Trigger a review/recount of Smart Prospect contacts and metrics for a filter. Recalculates verification statuses and catch-all statuses
Inputs
filter_idstringrequired- Filter ID to review
smartleadmcp_sp_update_email_metricsUpdate metrics and record the verification result for a specific email address within a Smart Prospect filterDestructiveSmart Prospect: Update email metrics
Update metrics and record the verification result for a specific email address within a Smart Prospect filter
Inputs
adapt_idstringrequired- Adapt ID of the contact
email_idstringrequired- Email address (max 255 chars)
email_sourcestringrequired- Source of verification (e.g., "anymail", "leadmagic", "hunter")
filter_idnumberrequired- Filter ID
statusstringrequired- Verification statusone of
validinvalidcatch_allriskyblacklistednot_foundvalid_catch_allunknown
smartleadmcp_sp_update_fetched_leadUpdate the name of a fetched lead record in Smart ProspectDestructiveSmart Prospect: Update fetched lead
Update the name of a fetched lead record in Smart Prospect
Inputs
idstringrequired- Fetched lead record ID
search_stringstringrequired- New name (1-255 chars)
smartleadmcp_sp_update_metricsBatch update fetch_details metrics for a Smart Prospect filter record.DestructiveSmart Prospect: Update metrics
Batch update fetch_details metrics for a Smart Prospect filter record. Allows incrementing or decrementing specific metric keys
Inputs
filter_idnumberrequired- Filter ID
listarrayrequired- Array of metric updates (1-50 items)
smartleadmcp_sp_update_saved_searchUpdate the name of a saved Smart Prospect searchDestructiveSmart Prospect: Update saved search
Update the name of a saved Smart Prospect search
Inputs
idstringrequired- Saved search ID
search_stringstringrequired- New name for the saved search (1-255 chars)
smartleadmcp_unsubscribe_leadUnsubscribe a lead from a campaignDestructiveUnsubscribe lead
Unsubscribe a lead from a campaign
Inputs
campaign_idnumberrequired- The ID of the campaign
lead_idnumberrequired- The ID of the lead to unsubscribe
smartleadmcp_unsubscribe_lead_globallyUnsubscribe a lead from all campaigns across the entire accountDestructiveUnsubscribe lead globally
Unsubscribe a lead from all campaigns across the entire account
Inputs
lead_idnumberrequired- The ID of the lead to unsubscribe
smartleadmcp_update_campaign_leadUpdate lead information in a campaignDestructiveUpdate campaign lead
Update lead information in a campaign
Inputs
campaign_idnumberrequired- The ID of the campaign
emailstringrequired- Lead email address
lead_idnumberrequired- The ID of the lead to update
company_namestring- Lead company name
company_urlstring- Lead company URL
custom_fieldsobject- Custom field values (max 200)
first_namestring- Lead first name
last_namestring- Lead last name
linkedin_profilestring- Lead LinkedIn profile URL
locationstring- Lead location
phone_numberstring- Lead phone number
websitestring- Lead website
smartleadmcp_update_campaign_scheduleSet when a campaign sends: timezone, days, hours, spacing and daily new-lead cap.DestructiveUpdate campaign schedule
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.
Inputs
campaign_idnumberrequired- The ID of the campaign
days_of_the_weekarrayrequired- Sending days as numbers: 0=Sunday, 1=Monday ... 6=Saturday. Weekdays = [1,2,3,4,5].
end_hourstringrequired- Daily end time, 24-hour HH:mm, e.g. "18:00". Must be later than start_hour.
max_new_leads_per_daynumberrequired- Maximum new leads to start per day
min_time_btw_emailsnumberrequired- Minimum minutes between emails sent by the campaign (at least 3)
start_hourstringrequired- Daily start time, 24-hour HH:mm in the campaign timezone, e.g. "09:00" (not "9:00 AM").
timezonestringrequired- 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_timestring- 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.
smartleadmcp_update_campaign_settingsUpdate campaign settings: tracking, stop rules, plain text, unsubscribe text, AI ESP matching and auto-pause.DestructiveUpdate campaign settings
Update campaign settings: tracking, stop rules, plain text, unsubscribe text, AI ESP matching and auto-pause. Only the fields you send are changed.
Inputs
campaign_idnumberrequired- The ID of the campaign
add_unsubscribe_tagboolean- Add unsubscribe tag to emails
ai_categorisation_optionsarray- AI categorization option IDs
auto_pause_domain_leads_on_replyboolean- Auto-pause all leads from domain on reply
bounce_autopause_thresholdstring- 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_idnumber- Client ID
domain_level_rate_limitboolean- Enable domain-level rate limiting across mailboxes on the same domain
enable_ai_esp_matchingboolean- Enable AI ESP matching
follow_up_percentagenumber- Percentage of leads to follow up
force_plain_textboolean- Force plain text for all emails
ignore_ss_mailbox_sending_limitboolean- Ignore mailbox sending limits
namestring- Campaign name
out_of_office_detection_settingsobject- Out-of-office detection settings
send_as_plain_textboolean- Send emails as plain text
stop_lead_settingsstring- Stop sending follow-ups to a lead when they reply, click a link, or open an emailone of
REPLY_TO_AN_EMAILCLICK_ON_A_LINKOPEN_AN_EMAIL track_settingsarray- 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_textstring- Unsubscribe link text
smartleadmcp_update_campaign_statusUpdate the status of a campaign.DestructiveUpdate campaign status
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).
Inputs
idnumberrequired- Campaign ID
statusstringrequired- Mutation status: START (resume/unpause), PAUSED, or STOPPEDone of
STARTPAUSEDSTOPPED
smartleadmcp_update_campaign_team_memberAssign or remove a team member from a campaignDestructiveUpdate campaign team member
Assign or remove a team member from a campaign
Inputs
campaign_idnumberrequired- The ID of the campaign
teamMemberIdnumberrequired- Team member ID (null to remove)
smartleadmcp_update_email_account_detailsUpdate specific details of an email accountDestructiveUpdate email account details
Update specific details of an email account
Inputs
account_idnumberrequired- The email account ID
bccstring- BCC email address for all sent emails
client_idnumber- Client ID for white-label
custom_tracking_urlstring- Custom domain for tracking
from_namestring- Display name for the sender
max_email_per_daynumber- Maximum emails to send per day
signaturestring- Email signature HTML
time_to_wait_in_minsnumber- Time to wait between emails (in minutes)
smartleadmcp_update_email_account_tagCreate or update an email account tagDestructiveUpdate email account tag
Create or update an email account tag
Inputs
colorstringrequired- Tag color in hex format (e.g., #FFFFFF)
idnumberrequired- Tag ID
namestringrequired- Tag name
smartleadmcp_update_email_warmup_detailsUpdate warmup settings for an email accountDestructiveUpdate email warmup details
Update warmup settings for an email account
Inputs
account_idnumberrequired- The email account ID
warmup_enabledbooleanrequired- Enable or disable warmup
auto_adjust_warmupboolean- Auto-adjust warmup based on performance
daily_rampupnumber- Daily increase in warmup emails (5-20)
is_rampup_enabledboolean- Enable gradual ramp-up
reply_rate_percentagenumber- Reply rate percentage (20-100)
total_warmup_per_daynumber- Total warmup emails per day (1-50)
warmup_key_idstring- Warmup key ID
smartleadmcp_update_lead_categoryUpdate lead category and optionally pause the leadDestructiveUpdate lead category
Update lead category and optionally pause the lead
Inputs
campaign_idnumberrequired- The ID of the campaign
lead_idnumberrequired- The ID of the lead
category_idnumber- The new category ID (null to remove category)
pause_leadboolean- Whether to pause the leaddefault
false
smartleadmcp_update_lead_email_accountUpdate the email account assigned to a leadDestructiveUpdate lead email account
Update the email account assigned to a lead
Inputs
email_account_idnumberrequired- The new email account ID
email_campaign_idnumberrequired- The campaign ID
email_lead_idnumberrequired- The lead ID
smartleadmcp_update_master_inbox_lead_categoryUpdate the category of a lead in master inboxDestructiveUpdate master inbox lead category
Update the category of a lead in master inbox
Inputs
email_lead_map_idnumberrequired- The email lead map ID
category_idnumber- The new category ID (null to unassign)
smartleadmcp_update_master_inbox_lead_revenueUpdate the revenue value of a lead in master inboxDestructiveUpdate master inbox lead revenue
Update the revenue value of a lead in master inbox
Inputs
email_lead_map_idnumberrequired- The email lead map ID
revenuenumberrequired- The revenue amount
smartleadmcp_update_master_inbox_lead_team_memberAssign a team member to a lead in master inboxDestructiveUpdate master inbox lead team member
Assign a team member to a lead in master inbox
Inputs
email_lead_map_idnumberrequired- The email lead map ID
team_member_idnumberrequired- The team member ID to assign
No tools match.