home / mcp / smartlead mcp server

SmartLead MCP Server

🚀 Premier Model Context Protocol server for SmartLead cold email marketing automation. Complete API integration with 113 tools for campaign management, lead tracking, deliverability optimization, and analytics. Works with Claude Desktop, Cursor, Windsurf, Continue.dev. Zero-config NPX installation.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "leadmagic-smartlead-mcp-server": {
      "command": "npx",
      "args": [
        "smartlead-mcp-by-leadmagic"
      ],
      "env": {
        "SMARTLEAD_API_KEY": "YOUR_API_KEY",
        "SMARTLEAD_ADVANCED_TOOLS": "true"
      }
    }
  }
}

You can integrate SmartLead’s cold email automation capabilities with your AI tools through a dedicated MCP Server. It exposes the complete SmartLead API via an intuitive installer and supports automatic configuration for your favorite AI assistants, editors, and IDEs, so you can manage campaigns, leads, emails, analytics, and more from a single, consistent interface.

How to use

Install the MCP Server using your preferred method, then connect your MCP-enabled AI client or editor to the server. Use the provided MCP configurations to run the server locally or point your client to the remote server, enabling you to create campaigns, manage leads and emails, monitor analytics, and leverage smart delivery and sender tools from within your AI workflow. Ensure your API key is valid and that your environment variables are set so the client can authenticate and access all SmartLead endpoints.

How to install

# Prerequisites: Node.js (recommended) and npm installed on your machine

# Option A: NPX (recommended for quick setup)
npx smartlead-mcp-by-leadmagic install

# Option B: Global install (alternative)
npm install -g smartlead-mcp-by-leadmagic
smartlead-mcp-by-leadmagic install

# Get your API key from the SmartLead app
# Example usage with NPX and API key
SMARTLEAD_API_KEY=your-key npx smartlead-mcp-by-leadmagic

Additional configuration and notes

Configuration is driven by MCP server blocks that specify how to run the server and which environment variables to use. In this guide, two ready-to-use examples show how to wire the MCP server into common editors and IDEs. The installer validates API access in real time and auto-detects integration points with Claude Desktop, Cursor, Windsurf, Continue.dev, VS Code, and Zed. You can customize the connection for your environment by adjusting the environment variables or changing the command and arguments in the MCP setup.

Security and troubleshooting

Security: Use API key validation, avoid hardcoding secrets, enable HTTPS, apply rate limiting, sanitize errors, and monitor for anomalies.

Troubleshooting tips: verify your API key, restart your AI client if tools seem missing, check network connectivity and firewall rules, and prefer global installs for performance if you experience issues with npx.

Updates and support

To update the MCP server tools, use the package manager and reinstall if necessary. If you need help, contact support at the provided channels or access the dedicated support resources for SmartLead and LeadMagic.

Available tools

smartlead_create_campaign

Create a new email campaign with sequences and settings.

smartlead_list_campaigns

List campaigns with filtering and pagination.

smartlead_get_campaign_by_id

Fetch details for a specific campaign.

smartlead_update_campaign_settings

Modify campaign configuration and parameters.

smartlead_get_campaigns_with_analytics

Retrieve campaigns along with performance data.

smartlead_delete_campaign

Remove a campaign from your account.

smartlead_pause_campaign

Pause an active campaign.

smartlead_resume_campaign

Resume a paused campaign.

smartlead_update_campaign_schedule

Change sending schedules and timing.

smartlead_clone_campaign

Duplicate an existing campaign.

smartlead_update_campaign_sequences

Edit email sequences and content.

smartlead_set_campaign_limits

Set daily sending limits for campaigns.

smartlead_update_campaign_tracking

Enable or disable open and click tracking.

smartlead_schedule_campaign

Set up advanced campaign scheduling.

smartlead_add_leads_to_campaign

Import prospects into a campaign.

smartlead_list_leads_by_campaign

Get all leads in a campaign.

smartlead_fetch_lead_by_email

Find a lead by email address.

smartlead_import_leads_from_csv

Bulk import leads from CSV.

smartlead_update_lead_category

Tag leads by status (e.g., interested).

smartlead_get_lead_activity_history

View a lead's interaction timeline.

smartlead_track_lead_engagement

Monitor engagement metrics per lead.

smartlead_export_leads_data

Export lead data in various formats.

smartlead_create_email_account

Add a new sending email account.

smartlead_test_email_account

Verify connectivity and authentication of email accounts.

smartlead_get_warmup_status

Check warmup status for an account.

smartlead_optimize_warmup_settings

AI-powered warmup optimization.

smartlead_get_account_sending_stats

View sending statistics per account.

smartlead_fetch_account_deliverability

Check deliverability metrics and scores.

smartlead_get_account_reputation_score

Monitor sender reputation health.

smartlead_get_analytics_campaign_list

List campaigns with analytics data.

smartlead_get_analytics_overall_stats_v2

Overall performance statistics.

smartlead_get_analytics_day_wise_overall_stats

Daily performance breakdown.

smartlead_get_campaign_performance_summary

Campaign-specific performance metrics.

smartlead_get_sequence_performance_analytics

Email sequence analysis.

smartlead_get_campaign_conversion_funnel

Conversion tracking and analysis.

smartlead_get_team_performance_analytics

Team productivity metrics.

smartlead_get_user_activity_analytics

Individual user performance tracking.

smartlead_get_client_campaign_analytics

Client-specific campaign data.

smartlead_get_deliverability_analytics

Email deliverability insights.

smartlead_get_engagement_analytics

Open, click, and response rate analysis.

smartlead_get_time_based_analytics

Performance trends over time.

smartlead_get_geographic_analytics

Location-based performance insights.

smartlead_get_device_analytics

Device and client performance data.

smartlead_export_analytics_report

Export comprehensive analytics reports.

smartlead_get_real_time_analytics

Live performance dashboard data.

smartlead_get_comparative_analytics

Compare campaigns and time periods.

smartlead_get_spam_test_details

View spam test results and recommendations.

smartlead_get_placement_test_history

Historical deliverability test data.

smartlead_schedule_recurring_tests

Set up automated deliverability tests.

smartlead_get_provider_wise_report

Performance by email provider.

smartlead_get_deliverability_score

Deliverability rating and insights.

smartlead_get_inbox_placement_rates

Inbox vs spam placement rates.

smartlead_get_domain_reputation_analysis

Domain health and reputation checks.

smartlead_get_ip_reputation_monitoring

IP address reputation tracking.

smartlead_optimize_delivery_settings

AI-powered delivery optimization.

smartlead_search_domain

Domain reputation lookup and analysis.

smartlead_get_domain_list

List all owned/configured domains.

smartlead_add_domain

Add new domains to your account.

smartlead_verify_domain

Domain verification and DNS setup.

smartlead_get_domain_health_score

Domain reputation and health scoring.

smartlead_configure_domain_settings

Advanced domain configuration.

smartlead_get_vendors

List available email service providers.

smartlead_auto_generate_mailboxes

Automatically generate email accounts.

smartlead_bulk_create_accounts

Create multiple email accounts at once.

smartlead_configure_mailbox_settings

Configure individual mailbox settings.

smartlead_test_mailbox_connectivity

Verify mailbox setup and connectivity.

smartlead_optimize_sender_rotation

Smart sender rotation optimization.