With the Smartlead MCP server, you can now access and interact with your Smartlead data directly inside Claude. This integration allows you to manage campaigns, retrieve insights, and perform diagnostics seamlessly - without ever leaving your chat interface!
This guide will walk you step-by-step through setting up the integration using Server-Sent Events (SSE).
The Model Context Protocol (MCP) is an open standard that lets AI models securely interact with external apps and data sources. With Smartlead MCP, Claude can now:
Fetch campaign insights in real time
Run deliverability and health diagnostics
Access lead, account, and performance data
Use Smartlead APIs securely — without manual requests
⚡ Tip: The Smartlead MCP integration works only via SSE (Server-Sent Events) for now. HTTPS transport is not supported.
Log in to your Smartlead Dashboard.
Go to Settings → API Keys.
Click Generate API Key (if you don’t already have one).
Copy your API key - we’ll use it in the next step.
🔒 Important: Treat your API key like a password. Do not share it publicly.
Open Claude Desktop
Go to:
Settings → Developer → Edit Config
This will take you to the MCP configuration JSON file. Double click to open the file. See the screenshot below. It will be named - claude_desktop_config.json
Inside the JSON file add the following configuration:
{
"mcpServers": {
"smartlead": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://mcp.smartlead.ai/sse?user_api_key=YOUR_API_KEY"
]
}
}
}
Replace <YOUR_API_KEY> with the key from Step 1.
Ensure you don’t delete any existing configurations if you already have other MCP servers set up.
Make sure you have Node.js installed, as npx is required to run the remote MCP module.
Download Node.js: https://nodejs.org
Once your configuration is saved:
Open the Claude desktop app.
Click on new chat, you will see the search and tools icon
You should see Smartlead show up there
Toggle Enable Smartlead for new chats.
Open a new chat in Claude.
Type /mcp.
Claude will authenticate using your API key.
If successful, you’ll see available Smartlead commands you can now run, like:
get_campaign_status
fetch_lead_data
check_deliverability
Start interacting directly with your Smartlead account.
Issue | Possible Cause | Solution |
| | Install Node.js here |
Authentication fails | API key missing or incorrect | Double-check your API key under Smartlead dashboard |
MCP tools not appearing in Claude | Integration disabled | Enable MCP tools under Claude Settings → Integrations |
Requests timing out | Network restrictions | Allow outbound connections to |
Endpoint limit errors | API quota exceeded | Check your Smartlead plan or usage dashboard |
With MCP set up, you can:
View real-time campaign stats
Run deliverability and spam diagnostics
Query lead and sender data
Integrate with advanced recipes and workflows (coming soon)
Smartlead MCP lets Claude interact with your Smartlead data using Model Context Protocol. You can fetch stats, diagnose campaigns, and access leads in real time — all without switching tabs.
No. For now, Smartlead MCP only supports SSE (Server-Sent Events). All setup instructions in this article assume SSE transport.
Go to Smartlead Dashboard → Settings → API Keys and copy your API key. If you don’t have one, click Generate API Key.
Currently, MCP integrations are supported only in Claude Desktop. Web support will come later.
Yes. Your API keys stay local in your Claude config file and are used only to authenticate with Smartlead MCP. Never share them publicly.
No, you don’t. Just follow the steps above — everything is copy-paste friendly.
/mcp it doesn’t work. What should I do?Check the following:
Ensure you saved the config file.
Make sure you have Node.js installed.
Verify that MCP tools are enabled under Claude Integrations.
Yes! Soon we’ll release curated recipes, hacks, and shortcuts that leverage MCP to automate campaign insights, deliverability checks, and lead management directly via Claude.