Smartlead Simplified MCP Server

What is Smartlead Simplified MCP Server about?

A lightweight server that exposes Smartlead’s email‑marketing capabilities through a Model Context Protocol (MCP) endpoint, allowing AI assistants such as Claude and workflow tools like n8n to programmatically create, update, and analyse campaigns, leads, and delivery statistics.

How to use Smartlead Simplified MCP Server?

1. Installation – Install the package globally or run it directly with npx:

   npm install smartlead-mcp-server@1.2.1
   # or run without installing
   npx smartlead-mcp-server start   # for Claude
   npx smartlead-mcp-server sse     # for n8n (Server‑Sent Events)
   

2. Configuration – On first launch you will be prompted for your Smartlead API key, or supply it non‑interactively:

   npx smartlead-mcp-server start --api-key YOUR_API_KEY
   

3. Integration – Add the MCP server definition to the client (Claude extension, n8n MCP node, etc.) using the command and environment variable shown above.

Key features of Smartlead Simplified MCP Server

• Full campaign, lead, and client management via MCP calls
• Real‑time statistics, analytics, and smart delivery controls
• Built‑in n8n integration with SSE and message endpoints (/sse, /message)
• Download tracking for analytics, leads, sequences, and full exports
• Automatic logging of download activity in ~/.smartlead-mcp/downloads.json
• No license key required; all features enabled by default

Use cases of Smartlead Simplified MCP Server

• AI‑driven email assistants – Claude can invoke campaign creation, send emails, or fetch analytics through simple MCP commands.
• Workflow automation – n8n users can pipe campaign data, lead lists, or download files into downstream nodes without custom scripting.
• Analytics dashboards – Developers can query download statistics or campaign performance to power internal reporting tools.
• Bulk export – Export full campaign data in JSON or CSV for migration, backup, or third‑party analysis.

FAQ from the Smartlead Simplified MCP Server

• Do I need a license? No. All features are enabled by default and operate with a valid Smartlead API key.
• Which command should I use for n8n? Start the server with npx smartlead-mcp-server sse; then configure the n8n MCP Client node to point to http://localhost:3000/sse and http://localhost:3000/message.
• How are downloads tracked? Each download request is recorded in ~/.smartlead-mcp/downloads.json, which can be queried via the smartlead_view_download_statistics tool.
• Can I run the server without installation? Yes, using npx as shown above.
• Where can I get help? Run npx smartlead-mcp-server config for credential setup or contact jonathan@jeantechnologies.com.

Smartlead Simplified MCP Server

This application provides a simplified interface to the Smartlead API, allowing AI assistants and automation tools to interact with Smartlead's email marketing features. We welcome contribution from the community.

Licensing: All features are now enabled by default with maximum permissiveness! No license key required.

For developer details: See DEVELOPER_ONBOARDING.md

Quick Start

Installation

npm install smartlead-mcp-server@1.2.1

or use directly with npx (no installation needed):

Installing via Smithery

To install Smartlead Campaign Management Server for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install @jean-technologies/smartlead-mcp-server-local --client claude

With Claude:

npx smartlead-mcp-server start

With n8n:

npx smartlead-mcp-server sse

First run will prompt for your Smartlead API Key. No license key is required.

Integration Examples

Claude Extension:

{
  "mcpServers": {
    "smartlead": {
      "command": "npx",
      "args": ["smartlead-mcp-server", "start"],
      "env": {
        "SMARTLEAD_API_KEY": "your_api_key_here"
      }
    }
  }
}

n8n Setup:

1. Start the server: npx smartlead-mcp-server sse
2. Configure n8n MCP Client node with:
   • SSE URL: http://localhost:3000/sse
   • Message URL: http://localhost:3000/message

Available Features

All features are now enabled by default, including:

• Campaign & Lead Management
• Statistics and Analytics
• Smart Delivery & Webhooks
• n8n Integration
• Client Management
• Smart Senders
• Download Tracking and Analytics

New Download Tracking Features

This release adds new download tracking capabilities:

Download Campaign Data

Download campaign data with tracking using the smartlead_download_campaign_data tool:

{
  "campaign_id": 12345,
  "download_type": "analytics", // "analytics", "leads", "sequence", "full_export"
  "format": "json", // "json" or "csv"
  "user_id": "optional-user-identifier"
}

View Download Statistics

View download statistics using the smartlead_view_download_statistics tool:

{
  "time_period": "all", // "all", "today", "week", "month"
  "group_by": "type" // "type", "format", "campaign", "date"
}

All downloads are tracked in ~/.smartlead-mcp/downloads.json for analytics.

Need Help?

• Run npx smartlead-mcp-server config to set up credentials
• Use --api-key option for non-interactive setup
• Contact: jonathan@jeantechnologies.com
• Website: jeantechnologies.com

License

This software is proprietary and confidential. Unauthorized copying, redistribution, or use of this software, in whole or in part, via any medium, is strictly prohibited without the express permission of Jean Technologies.

Copyright © 2025 Jean Technologies. All rights reserved.