Smartlead MCP Server

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.