Smartlead MCP Server

@jean-technologies

About Smartlead MCP Server

Smartlead MCP server.

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "smartlead": {
      "command": "node",
      "args": [
        "path/to/smartlead-mcp-server/dist/index.js"
      ],
      "env": {
        "SMARTLEAD_API_KEY": ""
      }
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is Smartlead MCP Server?

A Model Context Protocol (MCP) server for Smartlead integration. It provides tools for managing campaigns, leads, statistics, smart delivery, webhooks, client management, and smart senders, enabling automation of email outreach workflows.

How to use Smartlead MCP Server?

Clone the repository, install dependencies with npm install, add your Smartlead API key to a .env file, and build with npm run build. Start the server standalone with npm start, or integrate it with MCP clients like Claude by adding the server configuration (command, args, and env) to the appropriate MCP settings file.

Key features of Smartlead MCP Server

Campaign management: create, update, and manage email campaigns and sequences
Lead management: add, update, and track leads in campaigns
Statistics: fetch and analyze campaign performance metrics
Smart Delivery: spam test automation, reporting, and analytics
Webhooks: manage webhook integrations with external services
Client management: manage clients and their permissions
Smart Senders: search, generate, and purchase domains and mailboxes

Use cases of Smartlead MCP Server

Automate email campaign creation and lead management for outreach
Analyze campaign performance with statistics and spam test reports
Integrate real-time event handling via webhooks
Manage client access and permissions within a Smartlead account
Streamline email infrastructure setup by purchasing domains and mailboxes

FAQ from Smartlead MCP Server

What do I need to get started?

A Smartlead API key is required. Set it in a .env file as SMARTLEAD_API_KEY. Node.js and npm are also required.

How do I configure the server?

Create a .env file with the required API key and optional environment variables such as SMARTLEAD_API_URL, retry settings (max attempts, delays, backoff factor), and others.

Can I enable or disable specific feature categories?

Yes, feature categories can be enabled or disabled in the src/config/feature-config.ts file. By default, Smart Delivery, Webhooks, Client Management, and Smart Senders are enabled.

How do I integrate with MCP clients like Claude?

Add the server configuration (command, args, and env) to the MCP settings file for Claude VSCode extension or Claude desktop app, using the path to the built dist/index.js file.

Does the server handle different API base URLs?

Yes, Smart Senders endpoints use a different base URL (https://smart-senders.smartlead.ai/api/v1), which is handled automatically by the server.

Frequently asked questions

What do I need to get started?

A Smartlead API key is required. Set it in a `.env` file as `SMARTLEAD_API_KEY`. Node.js and npm are also required.

How do I configure the server?

Create a `.env` file with the required API key and optional environment variables such as `SMARTLEAD_API_URL`, retry settings (max attempts, delays, backoff factor), and others.

Can I enable or disable specific feature categories?

Yes, feature categories can be enabled or disabled in the `src/config/feature-config.ts` file. By default, Smart Delivery, Webhooks, Client Management, and Smart Senders are enabled.

How do I integrate with MCP clients like Claude?

Add the server configuration (command, args, and env) to the MCP settings file for Claude VSCode extension or Claude desktop app, using the path to the built `dist/index.js` file.