Smartlead MCP server for your AI

Fetch a specific master inbox item by its unique identifier.

Retrieve all lead replies across all campaigns in your unified inbox.

Send a reply email to a lead within campaign context.

Get account-wide overall statistics for date range with sent, opened, replied metrics.

Add new leads to a campaign with custom fields and validation settings.

Search for a lead by email address and retrieve all associated campaign data.

Retrieve complete email conversation history for a specific lead.

Retrieve all leads in a campaign with comprehensive filtering and pagination.

Retrieve all available lead categories including global and user-specific categories.

Temporarily pause a specific lead in a campaign.

Resume a paused lead with optional delay.

Update lead information including contact details and custom fields.

Assign or change the category for a lead within a campaign.

Creates a new email campaign with default settings in DRAFTED status Campaign name defaults to 'Untitled Campaign' if not provided.

Retrieves comprehensive details for a specific campaign including all configuration settings, schedule, tracking preferences, AI options, and associated metadata For client API keys, additionally filters by client_id.

Retrieve daily warmup performance statistics for the past 7 days.

Retrieves all email campaigns for the authenticated user with comprehensive campaign data including status, schedule settings, tracking configuration, AI matching preferences, and sending limits Essential for dashboard displays, campaign selection interfaces, and bulk operations across portfolio.

Retrieve all email accounts with advanced filtering and pagination options.

List every campaign a lead belongs to, by the lead's id.

Configures when and how frequently campaign emails are sent Sets timezone (IANA format), sending hours (start/end in 24-hour format), active days of week (0=Sunday through 6=Saturday), and minimum time between consecutive emails (in minutes) Validates timezone string and time format before saving.

Updates campaign configuration including: tracking settings (enable/disable opens and clicks - array format with DONT_EMAIL_OPEN/DONT_LINK_CLICK values), sending limits (max_leads_per_day, min_time_between_emails), stop conditions (when to stop emailing leads - REPLY_TO_AN_EMAIL/OPENED_EMAIL/CLIC...

Change the status of a campaign (start, pause, stop) Updates campaign status to START, PAUSE, or STOP.

Retrieve comprehensive analytics for a campaign.

Retrieve campaign analytics for a specific date range.

Fetch campaign statistics using the campaign's ID.

Associates one or more email accounts with a campaign for automatic sender rotation SmartLead distributes emails across added accounts to maximize deliverability, avoid ESP limits, and build sender reputation.

Retrieves all email accounts (sender accounts) associated with and actively rotating for this specific campaign Essential for monitoring sender distribution, checking account health, and troubleshooting delivery issues.

Retrieves all email sequences configured for a campaign, ordered by sequence number Essential for sequence editors, email preview interfaces, A/B testing configuration, and understanding campaign flow.

Create or update email sequences for multi-step campaigns.

Create automated recurring spam test with scheduled monitoring.

Create manual spam test where you send email to SmartLead test inboxes.

Create new folder for organizing spam tests.

Delete an empty test folder.

Delete multiple spam tests at once by test IDs.

Get complete spam test results including inbox placement and scores.

Check if sending IPs are listed on major email blacklists.

Check DKIM configuration status for sender domain authentication.

Check if sending domain is blacklisted.

Get actual email content from a specific spam test.

Get details for a specific test folder.

Analyze deliverability by geographic region.

Get comprehensive information about sending IP addresses.

Get count of test mailboxes by provider.

Get high-level summary of all test mailboxes.

Get deliverability report by email provider (Gmail, Outlook, Yahoo) Smart Delivery is a SmartLead add-on: a 401/403 here means it is not enabled for this account.

Check reverse DNS configuration for sending IP addresses.

Analyze email headers from test replies for advanced diagnostics.

IP details (sending IP, reverse DNS and blacklist status) for one reply in a Smart Delivery test.

Get send history for automated tests with execution log.

Get performance report by sender email account.

Detailed analysis of which spam filters triggered and why.

Verify SPF record configuration for sender authorization.

List organizational folders for spam tests.

Get region-wise email provider IDs for spam testing configuration.

List all sender accounts available for spam testing.

List all spam tests with filtering by date, type, and status.

Stop a running automated spam test, preserves results.

Fetch contact emails by filter or by IDs - POST /fetch-contacts.

Find email addresses for up to 10 contacts - POST /search-contacts/find-emails.

Retrieve saved contacts by filter or by adapt IDs - POST /get-contacts.

Retrieve reply analytics (replied count, trend) for the authenticated user - GET /reply-analytics.

Retrieve search analytics (leads found, emails fetched, credits) for the authenticated user - GET /search-analytics.

List cities for the authenticated user - GET /cities.

List countries for the authenticated user - GET /countries.

List departments for the authenticated user - GET /departments.

Retrieve fetched leads (search filters with fetch data) for the authenticated user - GET /search-filters/fetched-searches.

List head counts (company size ranges) for the authenticated user - GET /head-counts.

List industries for the authenticated user - GET /industries.

List job titles for the authenticated user - GET /job-title.

List keywords for the authenticated user - GET /keywords.

List levels (job/seniority levels) for the authenticated user - GET /levels.

Retrieve recent searches (search filters) for the authenticated user - GET /search-filters/recent-searches.

List active revenue options for the authenticated user - GET /revenue.

Retrieve saved searches (search filters) for the authenticated user - GET /search-filters/saved-searches.

List states for the authenticated user - GET /states.

List sub-industries for the authenticated user - GET /sub-industries.

Review/update contacts for a filter (sync metrics and status) - PATCH /review-contacts/:filter_id.

Save a search filter for the authenticated user - POST /search-filters/save-search.

List companies for the authenticated user - GET /company.

Search for contacts with filters - POST /search-contacts.

List domains for the authenticated user - GET /domain.

Update a fetched lead (search string/name) by ID - PUT /search-filters/fetched-searches/:id.

Update a saved search (search string/name) by ID - PUT /search-filters/save-search/:id.

Assign or reassign a lead to a specific team member.

Block one or more email domains to prevent future outreach.

Forward an email to other recipients.

Check the delivery status of a sent reply from the unified inbox.

Retrieve archived conversations removed from active inbox.

Retrieve all emails and conversations assigned to the authenticated user.

Retrieve emails marked as important to prioritize high-value conversations.

Retrieve emails based on saved custom filter views.

Retrieve emails with active reminders sorted by reminder time.

Retrieve emails queued for future sending with schedule time sorting.

Retrieve all sent emails across campaigns with comprehensive filtering and pagination.

Retrieve emails temporarily snoozed for later follow-up.

Retrieve all unread replies from leads to ensure no important responses are missed.

Retrieve replies not tracked by SmartLead campaigns.

Move a lead to a subsequence (child campaign) for targeted follow-up.

Resume a paused lead in a campaign with optional delay.

Set a reminder for a specific lead conversation.

Assign or change the category for a lead (Interested, Not Interested, etc.) Categories help organize leads by response type.

Update the revenue value associated with a lead for ROI tracking.

Mark emails as read or unread.

Get performance metrics for each campaign with engagement rates and lead counts.

Get detailed response analysis per campaign with sentiment breakdown.

Get count of campaigns in each status for operational overview.

Get performance metrics by client for agency reporting and analysis.

Get day-by-day email engagement breakdown with daily metrics.

Get daily breakdown organized by email sent time for schedule analysis.

Get daily positive reply metrics filtered to interested/positive categories only.

Get positive replies by sent time to optimize sending schedule.

Get performance metrics aggregated by email domain for domain analysis.

Analyze reply rates specifically for follow-up sequences (2, 3, 4+)

Get comprehensive lead engagement statistics by status and category.

Get lead response breakdown by category type with sentiment distribution.

Measure average time from first email sent to first reply received.

Calculate average leads contacted before receiving first reply.

Get overall health and performance statistics for all mailboxes.

Get detailed health metrics by individual email account address.

Get monthly breakdown of active clients showing growth trends.

Compare performance across email service providers (Gmail, Outlook, SMTP)

Get performance metrics by team member for collaboration features.

Retrieve list of all campaigns for building selectors and filtering.

Get list of all clients for agency account filtering and selection.

Remove a lead from a campaign.

Export all campaign leads as CSV file.

Retrieve message history for multiple leads at once.

Retrieve detailed information about a specific lead.

One lead's profile with every campaign it is in: per-campaign status, category and campaign_lead_map_id.

Step-by-step send history of one lead in one campaign: each sequence step's status, sent time and message.

List every lead in the account across all campaigns and lists, with pagination.

Retrieve lead activities across all campaigns for the authenticated user.

Manually mark a lead as completed in the campaign sequence.

Unsubscribe a lead from a campaign to stop all future emails.

Globally unsubscribe a lead from all current and future campaigns.

Change which email account is used to send to a specific lead.

Attach one or more tags to one or more campaigns in a single request.

Connect Gmail or Outlook account using OAuth 2.0 with automatic token refresh.

Add new SMTP/IMAP email account with connection validation and optional warmup configuration.

Create a child campaign (subsequence) with conditional trigger logic.

Permanently and irreversibly deletes a campaign and ALL associated data: sequences, lead-campaign mappings, email statis.

Delete an email account and remove it from all campaigns.

Creates a copy of an existing campaign including sequences, settings, and optionally sub-sequences and client labels.

Read recent messages straight from one connected mailbox (proxied live to the mail server).

Read recent messages from up to 10 connected mailboxes in one call, each with its own success or error.

Retrieve complete configuration, credentials, and warmup details for a specific email account.

Look up a single email account by its email address instead of paging through every account.

Retry the connection of every email account whose SMTP/IMAP connection failed.

Detach one or more tags from one or more campaigns in a single request.

Send a test email from a specific sequence to verify content and deliverability.

Temporarily suspend an email account from all sending activities including campaigns and warmup.

Reactivate a suspended email account and restore sending capabilities.

Assign or change the team member responsible for a campaign.

Update email account settings including sending limits, tracking domain, signature, and client association.

Configure email warmup parameters to gradually build sender reputation.

Add or remove tags from one or more lead lists.

Create a new lead list for organizing and segmenting your leads.

Create webhook to receive real-time notifications for campaign events like opens, clicks, and replies.

Remove a webhook from a campaign.

Delete a lead list by its ID.

Permanently delete a campaign webhook and stop all event notifications.

Get webhook execution summary and statistics for a campaign.

Retrieve details of a specific lead list by its ID.

Get configuration details for a specific webhook by ID.

Import leads into a specific lead list.

Retrieve all webhooks configured for a campaign.

Retrieve all lead lists with optional filtering and pagination.

Copy or move leads from one list to another.

Push leads from a list or by IDs to a campaign.

Manually retry failed webhook deliveries.

Create a new webhook or update existing webhook for campaign events.

Update the name of an existing lead list.

Update the configuration of an existing webhook.

Assign one or more tags to a specific lead.

Add a note to a lead's record for team collaboration and context.

Create a task associated with a lead for follow-up management.

Auto-generate professional mailbox email addresses for one or more domains.

Fetch campaign lead statistics using the campaign's ID.

Fetch mailbox statistics specific to a campaign.

Per-sequence and per-variant performance for a campaign, with rates.

Fetch campaign top-level analytics filtered by date range.

Fetch an one-time password for an admin mailbox.

Retrieve the status and details of a specific order placed through Smart Senders.

Retrieve all notes for a specific lead.

Get tags associated with a specific lead.

Retrieve all tasks for a specific lead.

Get the list of domains purchased through Smart Senders.

Get list of active mailbox vendors with pricing and service details.

Place an order to purchase domains and provision mailboxes through a Smart Senders vendor.

Remove a specific tag mapping from a lead.

Search for available domains in Smart Senders marketplace.

Add tags to one or more email accounts.

Create a named API key for one client sub-account.

Create a new email account tag with a name and optional color.

Delete a client sub-account API key.

List the API keys issued to your client sub-accounts, optionally for one client.

Retrieve all client sub-accounts under your main account.

Get tags associated with specific email accounts by email address.

Retrieve all inbox tags belonging to the authenticated user.

Remove tags from one or more email accounts.

Regenerate a client sub-account API key.

Create a new client (whitelabel sub-account) under your account.

Update an existing email account tag's name and color.

Attach every mailbox carrying a given tag to a campaign in a single call.

Disassociates email accounts from a campaign's sender rotation pool Does NOT delete accounts themselves - only removes from this campaign.

Comprehensive domain and email block list management GET retrieves paginated block list with filtering by client assignment and search terms.

Comprehensive domain and email block list management GET retrieves paginated block list with filtering by client assignment and search terms.

Comprehensive domain and email block list management GET retrieves paginated block list with filtering by client assignment and search terms.

Attach a Multi or Single SmartInfra (dedicated IPs) to many campaigns in a single request.

Send one-off transactional email outside of campaigns with attachments.