💜 SmartLead MCP Server - Cold Email Automation for AI
🚀 The #1 Model Context Protocol Server for SmartLead Cold Email Platform
✨ 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)
Option 1: NPX (Recommended)
# 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
| Tool | Status | Auto-Config | Notes |
|---|---|---|---|
| 🤖 Claude Desktop | ✅ Full | ✅ Yes | Anthropic's flagship |
| 🎯 Cursor | ✅ Full | ✅ Yes | AI code editor |
| 🏄 Windsurf | ✅ Full | ✅ Yes | Codeium IDE |
| 🔄 Continue.dev | ✅ Full | ✅ Yes | Open source |
| 💻 VS Code | ✅ Full | ✅ Yes | With MCP extensions |
| ⚡ Zed | ✅ Full | ✅ Yes | High-performance |
🛠️ Complete SmartLead API (116+ Tools)
🎯 The most comprehensive cold email automation toolkit available for AI assistants
| Category | Tools | Description | Key Features |
|---|---|---|---|
| 🎯 Campaign Management | 14 | Create, manage, optimize campaigns | Sequences, scheduling, A/B testing |
| 👥 Lead Management | 17 | Import, track, engage prospects | CSV import, categorization, CRM sync |
| 📧 Email Accounts | 15 | Configure sending & warmup | SMTP setup, reputation building |
| 📊 Analytics | 18 | Performance & ROI tracking | Real-time metrics, conversion funnels |
| 📈 Statistics | 18 | Detailed performance metrics | Campaign stats, warmup tracking |
| 🚀 Smart Delivery | 11 | Optimize timing & placement | Spam testing, deliverability scoring |
| 🤖 Smart Senders | 12 | Domain & deliverability management | Domain health, sender rotation |
| 🔗 Webhooks | 9 | Real-time integrations | Event notifications, CRM updates |
| 👤 Client Management | 8 | Team & API key management | User 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 settingssmartlead_list_campaigns- List all campaigns with filtering and paginationsmartlead_get_campaign_by_id- Fetch specific campaign details and configurationsmartlead_update_campaign_settings- Modify campaign configuration and parameterssmartlead_get_campaigns_with_analytics- Get campaigns with performance data includedsmartlead_delete_campaign- Remove campaigns from your account
Campaign Control:
smartlead_pause_campaign- Pause active campaigns temporarilysmartlead_resume_campaign- Resume paused campaignssmartlead_update_campaign_schedule- Modify sending schedules and timingsmartlead_clone_campaign- Duplicate successful campaigns
Advanced Campaign Features:
smartlead_update_campaign_sequences- Modify email sequences and contentsmartlead_set_campaign_limits- Configure daily sending limitssmartlead_update_campaign_tracking- Enable/disable open and click trackingsmartlead_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 campaignsmartlead_fetch_lead_by_email- Find specific prospect by email addresssmartlead_remove_lead_from_campaign- Remove prospects from campaignssmartlead_get_lead_details- Fetch detailed prospect information and historysmartlead_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 timelinesmartlead_fetch_lead_email_history- Get all emails sent to a prospectsmartlead_get_lead_response_data- Analyze prospect responses and engagementsmartlead_track_lead_engagement- Monitor engagement metrics per prospectsmartlead_get_lead_conversion_data- Track conversion funnel performance
Advanced Lead Features:
smartlead_bulk_update_leads- Update multiple prospects simultaneouslysmartlead_auto_categorize_leads- AI-powered lead categorizationsmartlead_schedule_lead_followup- Set up automated follow-up sequencessmartlead_sync_leads_with_crm- Integrate with CRM systemssmartlead_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 accountssmartlead_fetch_all_email_accounts- List all configured email accountssmartlead_update_email_account- Modify account settings and configurationsmartlead_delete_email_account- Remove email accounts from your setupsmartlead_test_email_account- Verify account connectivity and authenticationsmartlead_get_email_account_details- Fetch detailed account information
Email Warmup & Reputation:
smartlead_add_update_warmup_to_email_account- Configure warmup settings for accountssmartlead_get_warmup_status- Check current warmup progress and statussmartlead_pause_warmup- Temporarily pause warmup processsmartlead_resume_warmup- Resume paused warmup processsmartlead_get_warmup_statistics- View detailed warmup performance metricssmartlead_optimize_warmup_settings- AI-powered warmup optimization
Account Performance:
smartlead_get_account_sending_stats- View sending statistics per accountsmartlead_fetch_account_deliverability- Check deliverability metrics and scoressmartlead_get_account_reputation_score- Monitor sender reputation health
📊 Analytics Tools (18 tools)
Campaign Analytics:
smartlead_get_analytics_campaign_list- List campaigns with analytics datasmartlead_get_analytics_overall_stats_v2- Overall performance statisticssmartlead_get_analytics_day_wise_overall_stats- Daily performance breakdownsmartlead_get_campaign_performance_summary- Campaign-specific performance metricssmartlead_get_sequence_performance_analytics- Email sequence analysissmartlead_get_campaign_conversion_funnel- Conversion tracking and analysis
Team & Client Analytics:
smartlead_get_analytics_client_list- Client analytics overviewsmartlead_get_team_performance_analytics- Team productivity metricssmartlead_get_user_activity_analytics- Individual user performance trackingsmartlead_get_client_campaign_analytics- Client-specific campaign data
Advanced Reporting:
smartlead_get_deliverability_analytics- Email deliverability insightssmartlead_get_engagement_analytics- Open, click, and response rate analysissmartlead_get_time_based_analytics- Performance trends over timesmartlead_get_geographic_analytics- Location-based performance insightssmartlead_get_device_analytics- Device and email client performance datasmartlead_export_analytics_report- Export comprehensive analytics reportssmartlead_get_real_time_analytics- Live performance dashboard datasmartlead_get_comparative_analytics- Compare campaigns and time periods
📈 Statistics Tools (18 tools)
Campaign Statistics:
smartlead_fetch_campaign_statistics- Comprehensive campaign performance statssmartlead_fetch_campaign_top_level_analytics- High-level campaign metricssmartlead_get_campaign_sending_stats- Sending volume and timing statisticssmartlead_get_campaign_response_rates- Response and engagement rate analysissmartlead_get_campaign_bounce_analysis- Bounce rate analysis and trendssmartlead_get_campaign_unsubscribe_stats- Unsubscribe tracking and analysis
Warmup Statistics:
smartlead_fetch_warmup_stats_by_email_account- Account-specific warmup datasmartlead_get_warmup_progress_statistics- Warmup progression trackingsmartlead_get_warmup_engagement_stats- Warmup engagement metricssmartlead_get_warmup_reputation_trends- Reputation improvement tracking
Performance Metrics:
smartlead_download_campaign_data- Export detailed campaign datasmartlead_get_deliverability_statistics- Inbox placement rates and analysissmartlead_get_sender_reputation_stats- Domain and IP reputation trackingsmartlead_get_time_zone_performance- Performance analysis by time zonesmartlead_get_subject_line_performance- Subject line A/B testing resultssmartlead_get_email_client_statistics- Performance by email clientsmartlead_get_seasonal_performance_trends- Seasonal performance analysissmartlead_get_competitive_benchmarks- Industry comparison data
🚀 Smart Delivery Tools (11 tools)
Deliverability Testing:
smartlead_create_manual_placement_test- Manual spam folder testingsmartlead_create_automated_placement_test- Automated deliverability testingsmartlead_get_spam_test_details- View detailed test results and recommendationssmartlead_get_placement_test_history- Historical deliverability test datasmartlead_schedule_recurring_tests- Set up automated testing schedules
Deliverability Optimization:
smartlead_get_provider_wise_report- Performance analysis by email providersmartlead_get_deliverability_score- Overall deliverability rating and insightssmartlead_get_inbox_placement_rates- Inbox vs spam folder placement ratessmartlead_get_domain_reputation_analysis- Domain health and reputation checksmartlead_get_ip_reputation_monitoring- IP address reputation trackingsmartlead_optimize_delivery_settings- AI-powered delivery optimization
🤖 Smart Senders Tools (12 tools)
Domain Management:
smartlead_search_domain- Domain reputation lookup and analysissmartlead_get_domain_list- List all owned and configured domainssmartlead_add_domain- Add new domains to your accountsmartlead_verify_domain- Domain verification and DNS setupsmartlead_get_domain_health_score- Domain reputation and health scoringsmartlead_configure_domain_settings- Advanced domain configuration
Mailbox Management:
smartlead_get_vendors- List available email service providerssmartlead_auto_generate_mailboxes- Automatically generate email accountssmartlead_bulk_create_accounts- Create multiple email accounts simultaneouslysmartlead_configure_mailbox_settings- Configure individual mailbox settingssmartlead_test_mailbox_connectivity- Verify mailbox setup and connectivitysmartlead_optimize_sender_rotation- Smart sender rotation optimization
🔗 Webhook Tools (9 tools)
Webhook Configuration:
smartlead_fetch_webhooks_by_campaign- Get all webhooks for a campaignsmartlead_upsert_campaign_webhook- Create or update campaign webhookssmartlead_delete_campaign_webhook- Remove webhooks from campaignssmartlead_test_webhook_endpoint- Verify webhook connectivity and responsesmartlead_get_webhook_logs- View webhook delivery logs and history
Webhook Analytics & Management:
smartlead_get_webhooks_publish_summary- Webhook delivery statisticssmartlead_get_webhook_failure_analysis- Analyze failed webhook deliveriessmartlead_retry_failed_webhooks- Retry failed webhook deliveriessmartlead_configure_webhook_retry_policy- Set webhook retry behavior
👤 Client Management Tools (8 tools)
Team Management:
smartlead_create_client- Add new team members and clientssmartlead_get_all_clients- List all clients and team memberssmartlead_update_client_permissions- Modify user roles and permissionssmartlead_delete_client- Remove team members from accountsmartlead_get_team_details- Get team information and metrics
API & Access Management:
smartlead_create_client_api_key- Generate API keys for team memberssmartlead_revoke_client_api_key- Remove API access for userssmartlead_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
| Issue | Solution |
|---|---|
| API Key Error | Verify key at app.smartlead.ai |
| Tools Missing | Restart your AI client completely |
| Connection Failed | Check internet & firewall settings |
| Slow Performance | Use 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
🤝 Support & Links
- 📧 Support: jesse@leadmagic.io
- 🐛 Issues: GitHub Issues
- 📚 Docs: Full Documentation
- 🌐 SmartLead: smartlead.ai
- 🔧 LeadMagic: leadmagic.io
📄 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
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