Smartlead MCP Server

What is Smartlead MCP Server?

Smartlead MCP Server is a Model Context Protocol (MCP) server for Smartlead campaign management integration. It provides tools for creating and managing campaigns, updating campaign settings, and managing campaign sequences, email accounts, and leads.

How to use Smartlead MCP Server?

Install dependencies with npm install, create a .env file with your SMARTLEAD_API_KEY, then build using npm run build and start with npm start. To integrate with Claude, add the server to the MCP settings file (cline_mcp_settings.json for the VSCode extension or claude_desktop_config.json for the desktop app) with the command, arguments, and environment variables.

Key features of Smartlead MCP Server

• Create new campaigns in Smartlead
• Update campaign schedule and general settings
• Get and list campaigns with filtering
• Manage campaign email sequences (save, get, update, delete)
• Manage email accounts in campaigns (add, update, delete)
• Manage leads in campaigns (add, update, delete, up to 100 per call)

Use cases of Smartlead MCP Server

• Automate campaign creation and scheduling from an AI assistant
• Bulk add or update leads across multiple campaigns
• Adjust campaign settings and sequences without manual API calls
• Integrate Smartlead campaign management into AI-powered workflows

FAQ from Smartlead MCP Server

What is required to run the server?

You need a Smartlead API key set in the SMARTLEAD_API_KEY environment variable. Optionally, you can configure a custom API URL and retry settings.

How do I integrate with Claude Desktop or VSCode?

Add the server definition to the MCP settings file (cline_mcp_settings.json for VSCode or claude_desktop_config.json for the desktop app) with the node command, path to the built index.js, and the SMARTLEAD_API_KEY environment variable.

What is the maximum number of leads I can add at once?

You can add up to 100 leads per smartlead_add_lead_to_campaign call. Each lead can have up to 20 custom fields.

What tools are available for campaign sequences?

Tools include smartlead_save_campaign_sequence, smartlead_get_campaign_sequence, smartlead_update_campaign_sequence, and smartlead_delete_campaign_sequence. They support A/B testing variants with delay settings and distribution options.

What optional configuration settings exist?

The server supports SMARTLEAD_API_URL (defaults to https://server.smartlead.ai/api/v1), along with retry settings: SMARTLEAD_RETRY_MAX_ATTEMPTS (default 3), SMARTLEAD_RETRY_INITIAL_DELAY, SMARTLEAD_RETRY_MAX_DELAY, and SMARTLEAD_RETRY_BACKOFF_FACTOR.