Smartlead MCP Server

What is Smartlead MCP Server?

The Smartlead MCP Server is a Model Context Protocol server that integrates with Smartlead’s campaign management API. It provides tools for creating and managing campaigns, updating settings, managing email sequences, email accounts, and leads. It is intended for developers and users who want to automate Smartlead workflows through MCP-compatible clients like Claude.

How to use Smartlead MCP Server?

Clone the repository, install dependencies with npm install, create a .env file with your Smartlead API key, and build the project with npm run build. Start the server directly with npm start. For integration with Claude, add the server to the MCP settings file (e.g., claude_desktop_config.json) with the command node pointing to the built index.js and pass the API key in the env object.

Key features of Smartlead MCP Server

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

Use cases of Smartlead MCP Server

• Automate campaign creation and configuration from an MCP client
• Bulk add leads to a campaign with custom fields and settings
• Update campaign schedules and email sequences programmatically
• Add or remove email accounts from existing campaigns

FAQ from Smartlead MCP Server

What does the Smartlead MCP Server do?

It provides a set of MCP tools that let you interact with the Smartlead API for campaign management, including creating campaigns, updating settings, managing sequences, email accounts, and leads.

How do I configure the API key?

Create a .env file with SMARTLEAD_API_KEY=your_api_key_here. The server reads this environment variable on startup. You can also pass it in the env block when configuring the server with Claude.

Can I customize the API base URL?

Yes, set the optional environment variable SMARTLEAD_API_URL to a custom URL. It defaults to https://server.smartlead.ai/api/v1.

What runtime and dependencies are required?

Node.js and npm. After cloning, run npm install and npm run build. The server runs as a Node process.

Does the server support retries on API failures?

Yes. Retry behavior is configurable via environment variables: SMARTLEAD_RETRY_MAX_ATTEMPTS (default 3), SMARTLEAD_RETRY_INITIAL_DELAY (default 1000 ms), SMARTLEAD_RETRY_MAX_DELAY (default 10000 ms), and SMARTLEAD_RETRY_BACKOFF_FACTOR (default 2).