miskakaskinen/Smartlead-Campaign-MCP-server

Smartlead MCP Server

A Model Context Protocol (MCP) server implementation for interacting with the Smartlead API. This server provides tools for managing campaigns through Smartlead's API.

Overview

This project implements an MCP server that exposes Smartlead API endpoints as tools for AI assistants. It enables AI agents to perform operations like creating, updating, and analyzing email campaigns in Smartlead through a standardized protocol.

Features

The server provides comprehensive tools for:

Campaign Management

• List, create, and manage campaigns
• Update campaign schedules and settings
• Save and manage campaign sequences
• Export campaign data and analytics

Prerequisites

• Python 3.12+
• Docker (recommended for deployment)
• Smartlead API credentials

Installation

Using uv

1. Install uv if you don't have it:

   pip install uv
   

2. Clone this repository:

   git clone https://github.com/miskakaskinen/Smartlead-Campaign-MCP-server.git
   cd Smartlead-Campaign-MCP-server
   

3. Install dependencies:

   uv pip install -e .
   

4. Create a .env file based on .env.example:

   cp .env.example .env
   

Using Docker (Recommended)

1. Build the Docker image:

   docker build -t smartlead/mcp-campaign .
   

2. Create a .env file and configure your environment variables

Configuration

Configure the following environment variables in your .env file:

Running the Server

Using uv

SSE Transport

# Set TRANSPORT=sse in .env then:
uv run src/main.py

The MCP server will essentially be run as an API endpoint that you can then connect to with config shown below.

Using Docker with SSE Transport (Recommended)

Run the container with SSE transport:

docker run -p 8050:8050 --env-file .env smartlead/mcp-campaign

Integration with MCP Clients

Add this configuration to your MCP client (e.g., Claude Desktop, Windsurf):

{
  "mcpServers": {
    "smartlead": {
      "transport": "sse",
      "url": "http://localhost:8050/sse"
    }
  }
}

Note for n8n users: Use host.docker.internal instead of localhost since n8n has to reach outside of its own container to the host machine:

So the full URL in the MCP node would be: http://host.docker.internal:8050/sse

Available Tools

Campaign Management

• list_campaigns: List all campaigns
• get_campaign: Get campaign by ID
• create_campaign: Create a new campaign
• update_campaign_schedule: Update campaign schedule
• update_campaign_settings: Update campaign settings
• save_campaign_sequence: Save campaign sequence
• patch_campaign_status: Update campaign status
• get_campaign_analytics: Get campaign analytics
• get_campaign_sequence: Get campaign sequence
• get_campaigns_by_lead_id: Get campaigns by lead ID
• export_campaign_data: Export campaign data
• get_campaign_sequence_analytics: Get sequence analytics