🚀 SmartLead MCP Server - Cold Email Automation for AI
Seamlessly integrate SmartLead's industry - leading cold email automation with various AI coding assistants, revolutionizing your AI coding workflow.
🚀 Quick Start
Option 1: NPX (Recommended)
npx smartlead-mcp-by-leadmagic install
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
✨ Features
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
📦 Installation
The installation process is straightforward and offers multiple options:
- NPX (Recommended): Use
npx smartlead-mcp-by-leadmagic install
for a beautiful interactive installer or directly run with your API key.
- Global Install: Install globally via
npm install -g smartlead-mcp-by-leadmagic
and then run the installer.
💻 Usage Examples
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" }
}
}
}
📚 Documentation
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 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
🔧 Technical Details
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
npx smartlead-mcp-by-leadmagic --version
npm update -g smartlead-mcp-by-leadmagic
npm uninstall -g smartlead-mcp-by-leadmagic
npm install -g smartlead-mcp-by-leadmagic
🤝 Support & Links
📄 License
MIT License - see LICENSE file. Contributions welcome via GitHub.