Skip to content
Scalekit Docs
Talk to an Engineer Dashboard

Connect AI agents to the Smartlead MCP server

Vendor MCP
Open markdown

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 app
Your own Smartlead MCP server app

Setup

  1. Install the SDK

    Terminal window
    npm install @scalekit-sdk/node dotenv
  2. Set your credentials

    Add your Scalekit credentials to your .env file. 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>
  3. Create the Smartlead MCP connection

    In AgentKit > Connections, create a Smartlead MCP connection and copy its redirect URI. The name you give it is the connection_name your code passes. See Configure connections.

  4. Register an OAuth app

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

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

  5. Authorize a user and make your first call

    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.actions
    const connector = 'smartleadmcp'
    const identifier = 'user_123'
    // Generate an authorization link for the user
    const { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })
    console.log('Authorize Smartlead MCP:', link)
    const rl = createInterface({ input: process.stdin, output: process.stdout })
    await rl.question('Press Enter after authorizing...')
    rl.close()
    // Make your first call
    const result = await actions.executeTool({
    connector,
    identifier,
    toolName: 'smartleadmcp_fetch_master_inbox_assigned_me',
    toolInput: {},
    })
    console.log(result)
    Terminal window
    npx tsx quickstart.mts

    Each user signs in once. See Authorize a user for the full flow and statuses.

Tools

Pass the exact name to execute_tool
Try in PlaygroundRequest a tool
  • smartleadmcp_analyse_campaign_copyAnalyze the email copy used in a campaign.Read-only

    Analyse 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-only

    Analyse 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-only

    Bulk 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-only

    Check 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-only

    Check 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-only

    Check 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-only

    Check 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-only

    Check whitelabel domain CNAME

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

    Inputs

    This tool takes no inputs.