๐Ÿ’œ SmartLead MCP Server - Cold Email Automation for AI

July 2, 2025 ยท View on GitHub

๐Ÿš€ The #1 Model Context Protocol Server for SmartLead Cold Email Platform

NPM Downloads GitHub License

โœจ 116+ API Tools โ€ข ๐ŸŽจ Beautiful Installer โ€ข โšก 1-Click Setup โ€ข ๐Ÿ›ก๏ธ Enterprise Ready โœจ

Seamlessly integrate SmartLead's industry-leading cold email automation with Claude, Cursor, Windsurf, Continue.dev, VS Code, and all AI coding assistants


๐ŸŽฏ Why Choose SmartLead MCP Server?

Transform your AI coding workflow with the most comprehensive cold email automation suite available. Built by LeadMagic (official SmartLead partner), this server delivers complete SmartLead API access through a gorgeous React Ink installer.

๐Ÿ”ฅ Key Benefits

  • ๐Ÿ’œ Beautiful Setup Experience - Stunning purple gradient installer that users love
  • ๐Ÿš€ Complete API Coverage - All 116+ SmartLead endpoints in one package
  • โšก Zero Configuration - Auto-detects and configures all MCP clients instantly
  • ๐Ÿ›ก๏ธ Production Ready - TypeScript, error handling, security best practices
  • ๐ŸŽฏ AI-Optimized - Perfect integration with Claude, Cursor, and all AI tools

๐Ÿš€ Quick Start (30 seconds)

# Beautiful interactive installer
npx smartlead-mcp-by-leadmagic install

# Or direct usage
SMARTLEAD_API_KEY=your-key npx smartlead-mcp-by-leadmagic

Option 2: Global Install

npm install -g smartlead-mcp-by-leadmagic
smartlead-mcp-by-leadmagic install

๐Ÿ”‘ Get your SmartLead API key: app.smartlead.ai โ†’ Settings โ†’ API Keys


๐Ÿ’œ Beautiful Interactive Installer

Our React Ink installer is a masterpiece of UX design:

  • ๐Ÿ’œ Stunning purple gradients matching SmartLead's brand
  • ๐Ÿ” Smart auto-detection of Claude, Cursor, Windsurf, Continue, VS Code, Zed
  • ๐Ÿ”‘ Real-time API validation with SmartLead servers
  • โšก One-click configuration for all MCP clients
  • ๐ŸŽฏ Intelligent error handling with helpful guidance
  • ๐Ÿ“ฑ Cross-platform support (macOS, Linux, Windows)

๐Ÿ”— Supported AI Tools

ToolStatusAuto-ConfigNotes
๐Ÿค– Claude Desktopโœ… Fullโœ… YesAnthropic's flagship
๐ŸŽฏ Cursorโœ… Fullโœ… YesAI code editor
๐Ÿ„ Windsurfโœ… Fullโœ… YesCodeium IDE
๐Ÿ”„ Continue.devโœ… Fullโœ… YesOpen source
๐Ÿ’ป VS Codeโœ… Fullโœ… YesWith MCP extensions
โšก Zedโœ… Fullโœ… YesHigh-performance

๐Ÿ› ๏ธ Complete SmartLead API (116+ Tools)

๐ŸŽฏ The most comprehensive cold email automation toolkit available for AI assistants

CategoryToolsDescriptionKey Features
๐ŸŽฏ Campaign Management14Create, manage, optimize campaignsSequences, scheduling, A/B testing
๐Ÿ‘ฅ Lead Management17Import, track, engage prospectsCSV import, categorization, CRM sync
๐Ÿ“ง Email Accounts15Configure sending & warmupSMTP setup, reputation building
๐Ÿ“Š Analytics18Performance & ROI trackingReal-time metrics, conversion funnels
๐Ÿ“ˆ Statistics18Detailed performance metricsCampaign stats, warmup tracking
๐Ÿš€ Smart Delivery11Optimize timing & placementSpam testing, deliverability scoring
๐Ÿค– Smart Senders12Domain & deliverability managementDomain health, sender rotation
๐Ÿ”— Webhooks9Real-time integrationsEvent notifications, CRM updates
๐Ÿ‘ค Client Management8Team & API key managementUser roles, API access control

๐Ÿ“‹ Complete Tool Reference

๐ŸŽฏ Campaign Management Tools (14 tools)

Core Campaign Operations:

  • smartlead_create_campaign - Create new email campaigns with sequences and settings
  • smartlead_list_campaigns - List all campaigns with filtering and pagination
  • smartlead_get_campaign_by_id - Fetch specific campaign details and configuration
  • smartlead_update_campaign_settings - Modify campaign configuration and parameters
  • smartlead_get_campaigns_with_analytics - Get campaigns with performance data included
  • smartlead_delete_campaign - Remove campaigns from your account

Campaign Control:

  • smartlead_pause_campaign - Pause active campaigns temporarily
  • smartlead_resume_campaign - Resume paused campaigns
  • smartlead_update_campaign_schedule - Modify sending schedules and timing
  • smartlead_clone_campaign - Duplicate successful campaigns

Advanced Campaign Features:

  • smartlead_update_campaign_sequences - Modify email sequences and content
  • smartlead_set_campaign_limits - Configure daily sending limits
  • smartlead_update_campaign_tracking - Enable/disable open and click tracking
  • smartlead_schedule_campaign - Set up advanced campaign scheduling
๐Ÿ‘ฅ Lead Management Tools (17 tools)

Lead Import & Management:

  • smartlead_add_leads_to_campaign - Import prospects to campaigns (supports bulk CSV)
  • smartlead_list_leads_by_campaign - Get all prospects in a specific campaign
  • smartlead_fetch_lead_by_email - Find specific prospect by email address
  • smartlead_remove_lead_from_campaign - Remove prospects from campaigns
  • smartlead_get_lead_details - Fetch detailed prospect information and history
  • smartlead_import_leads_from_csv - Bulk import prospects from CSV files

Lead Tracking & Analytics:

  • smartlead_update_lead_category - Categorize prospects (interested, not_interested, etc.)
  • smartlead_get_lead_activity_history - View complete prospect interaction timeline
  • smartlead_fetch_lead_email_history - Get all emails sent to a prospect
  • smartlead_get_lead_response_data - Analyze prospect responses and engagement
  • smartlead_track_lead_engagement - Monitor engagement metrics per prospect
  • smartlead_get_lead_conversion_data - Track conversion funnel performance

Advanced Lead Features:

  • smartlead_bulk_update_leads - Update multiple prospects simultaneously
  • smartlead_auto_categorize_leads - AI-powered lead categorization
  • smartlead_schedule_lead_followup - Set up automated follow-up sequences
  • smartlead_sync_leads_with_crm - Integrate with CRM systems
  • smartlead_export_leads_data - Export prospect data in various formats
๐Ÿ“ง Email Account Management Tools (15 tools)

Account Setup & Configuration:

  • smartlead_create_email_account - Add new sending email accounts
  • smartlead_fetch_all_email_accounts - List all configured email accounts
  • smartlead_update_email_account - Modify account settings and configuration
  • smartlead_delete_email_account - Remove email accounts from your setup
  • smartlead_test_email_account - Verify account connectivity and authentication
  • smartlead_get_email_account_details - Fetch detailed account information

Email Warmup & Reputation:

  • smartlead_add_update_warmup_to_email_account - Configure warmup settings for accounts
  • smartlead_get_warmup_status - Check current warmup progress and status
  • smartlead_pause_warmup - Temporarily pause warmup process
  • smartlead_resume_warmup - Resume paused warmup process
  • smartlead_get_warmup_statistics - View detailed warmup performance metrics
  • smartlead_optimize_warmup_settings - AI-powered warmup optimization

Account Performance:

  • 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
๐Ÿ“Š Analytics Tools (18 tools)

Campaign Analytics:

  • 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

Team & Client Analytics:

  • smartlead_get_analytics_client_list - Client analytics overview
  • 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

Advanced Reporting:

  • 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 email 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
๐Ÿ“ˆ Statistics Tools (18 tools)

Campaign Statistics:

  • smartlead_fetch_campaign_statistics - Comprehensive campaign performance stats
  • smartlead_fetch_campaign_top_level_analytics - High-level campaign metrics
  • smartlead_get_campaign_sending_stats - Sending volume and timing statistics
  • smartlead_get_campaign_response_rates - Response and engagement rate analysis
  • smartlead_get_campaign_bounce_analysis - Bounce rate analysis and trends
  • smartlead_get_campaign_unsubscribe_stats - Unsubscribe tracking and analysis

Warmup Statistics:

  • smartlead_fetch_warmup_stats_by_email_account - Account-specific warmup data
  • smartlead_get_warmup_progress_statistics - Warmup progression tracking
  • smartlead_get_warmup_engagement_stats - Warmup engagement metrics
  • smartlead_get_warmup_reputation_trends - Reputation improvement tracking

Performance Metrics:

  • smartlead_download_campaign_data - Export detailed campaign data
  • smartlead_get_deliverability_statistics - Inbox placement rates and analysis
  • smartlead_get_sender_reputation_stats - Domain and IP reputation tracking
  • smartlead_get_time_zone_performance - Performance analysis by time zone
  • smartlead_get_subject_line_performance - Subject line A/B testing results
  • smartlead_get_email_client_statistics - Performance by email client
  • smartlead_get_seasonal_performance_trends - Seasonal performance analysis
  • smartlead_get_competitive_benchmarks - Industry comparison data
๐Ÿš€ Smart Delivery Tools (11 tools)

Deliverability Testing:

  • smartlead_create_manual_placement_test - Manual spam folder testing
  • smartlead_create_automated_placement_test - Automated deliverability testing
  • smartlead_get_spam_test_details - View detailed test results and recommendations
  • smartlead_get_placement_test_history - Historical deliverability test data
  • smartlead_schedule_recurring_tests - Set up automated testing schedules

Deliverability Optimization:

  • smartlead_get_provider_wise_report - Performance analysis by email provider
  • smartlead_get_deliverability_score - Overall deliverability rating and insights
  • smartlead_get_inbox_placement_rates - Inbox vs spam folder placement rates
  • smartlead_get_domain_reputation_analysis - Domain health and reputation check
  • smartlead_get_ip_reputation_monitoring - IP address reputation tracking
  • smartlead_optimize_delivery_settings - AI-powered delivery optimization
๐Ÿค– Smart Senders Tools (12 tools)

Domain Management:

  • smartlead_search_domain - Domain reputation lookup and analysis
  • smartlead_get_domain_list - List all owned and 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

Mailbox Management:

  • smartlead_get_vendors - List available email service providers
  • smartlead_auto_generate_mailboxes - Automatically generate email accounts
  • smartlead_bulk_create_accounts - Create multiple email accounts simultaneously
  • 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
๐Ÿ”— Webhook Tools (9 tools)

Webhook Configuration:

  • smartlead_fetch_webhooks_by_campaign - Get all webhooks for a campaign
  • smartlead_upsert_campaign_webhook - Create or update campaign webhooks
  • smartlead_delete_campaign_webhook - Remove webhooks from campaigns
  • smartlead_test_webhook_endpoint - Verify webhook connectivity and response
  • smartlead_get_webhook_logs - View webhook delivery logs and history

Webhook Analytics & Management:

  • smartlead_get_webhooks_publish_summary - Webhook delivery statistics
  • smartlead_get_webhook_failure_analysis - Analyze failed webhook deliveries
  • smartlead_retry_failed_webhooks - Retry failed webhook deliveries
  • smartlead_configure_webhook_retry_policy - Set webhook retry behavior
๐Ÿ‘ค Client Management Tools (8 tools)

Team Management:

  • smartlead_create_client - Add new team members and clients
  • smartlead_get_all_clients - List all clients and team members
  • smartlead_update_client_permissions - Modify user roles and permissions
  • smartlead_delete_client - Remove team members from account
  • smartlead_get_team_details - Get team information and metrics

API & Access Management:

  • smartlead_create_client_api_key - Generate API keys for team members
  • smartlead_revoke_client_api_key - Remove API access for users
  • smartlead_get_client_usage_statistics - Monitor API usage by team member

๐Ÿ“‹ Configuration Examples

Claude Desktop

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

Cursor/VS Code

{
  "cline.mcpServers": {
    "smartlead": {
      "command": "npx",
      "args": ["smartlead-mcp-by-leadmagic"],
      "env": { "SMARTLEAD_API_KEY": "your_api_key" }
    }
  }
}

๐Ÿ”’ Enterprise Security

  • โœ… API Key Validation - Real-time verification
  • โœ… Environment Variables - No hardcoded secrets
  • โœ… Rate Limiting - Respects API limits
  • โœ… Error Sanitization - No data leaks
  • โœ… HTTPS Only - Encrypted communications

๐Ÿš€ Performance

  • โšก Lightning Fast - TypeScript + Bun optimized
  • ๐ŸŽฏ Smart Caching - Reduced API calls
  • ๐Ÿ“Š Monitoring - Built-in performance tracking
  • ๐Ÿ”„ Auto-Retry - Resilient error handling
  • ๐Ÿ“ฑ Cross-Platform - Works everywhere

๐Ÿ†˜ Quick Troubleshooting

IssueSolution
API Key ErrorVerify key at app.smartlead.ai
Tools MissingRestart your AI client completely
Connection FailedCheck internet & firewall settings
Slow PerformanceUse global install vs npx

๐Ÿ”„ Updates

# Check version
npx smartlead-mcp-by-leadmagic --version

# Update
npm update -g smartlead-mcp-by-leadmagic

# Reinstall
npm uninstall -g smartlead-mcp-by-leadmagic
npm install -g smartlead-mcp-by-leadmagic


๐Ÿ“„ License & Contributing

MIT License - see LICENSE file. Contributions welcome via GitHub.


๐Ÿš€ Ready to automate your cold email campaigns with AI?

npx smartlead-mcp-by-leadmagic install

Made with ๐Ÿ’œ by LeadMagic โ€ข Official SmartLead Partner

NPM GitHub

Keywords: SmartLead, MCP, Model Context Protocol, Cold Email, Email Marketing, AI Tools, Claude, Cursor, Windsurf, Continue, VS Code, Campaign Management, Lead Generation, Email Automation, Sales Automation, TypeScript, React Ink