Hosted on GitHub for issue tracking, documentation access, and open contributions to the codebase
Cross-platform support including Linux for running the MCP server in various environments
Cross-platform support including macOS for running the MCP server in various environments
Available through npm for easy installation and updates with package management capabilities
Uses React Ink for a beautiful interactive installer experience with purple gradients matching SmartLead's brand
Built with TypeScript for type safety and better developer experience when extending the MCP server's functionality
💜 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)
Option 2: Global 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
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 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
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
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
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
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
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 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
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
Cursor/VS Code
🔒 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
🤝 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?
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
This server cannot be installed
A Model Context Protocol server that provides AI coding assistants (Claude, Cursor, etc.) with access to SmartLead's cold email automation platform through 116+ API endpoints for campaign management, lead tracking, and email delivery.
Related MCP Servers
- -securityFlicense-qualityA versatile Model Context Protocol server that enables AI assistants to manage calendars, track tasks, handle emails, search the web, and control smart home devices.Last updated -2Python
- -securityAlicense-qualityA Model Context Protocol server that enables AI assistants like Claude to interact with Gmail through natural language, providing comprehensive email management capabilities including sending, reading, organizing, searching, and managing drafts and labels.Last updated -PythonGPL 3.0
Mailgun MCP Serverofficial
-securityAlicense-qualityA Model Context Protocol server implementation that enables AI assistants like Claude Desktop to interact with Mailgun email services, allowing users to send emails and visualize email delivery statistics through natural language.Last updated -6JavaScriptApache 2.0- -securityFlicense-qualityA Model Context Protocol server that enables AI models to send emails via simple tool calls, supporting both plain text and HTML formats with JWT authentication.Last updated -14TypeScript