SendPulse MCP server
sendpulse-mcp
An MCP server for SendPulse: email campaigns, mailing lists, transactional mail via SMTP and web push notifications
High risk
We rate an entry high when the tool writes to external systems, handles money, production databases or secrets, or runs arbitrary commands. The CLI installs it only with your consent.
Why this level
- Can send an email campaign to the entire mailing list in one call with no confirmation
- The OAuth2 credentials grant access to the account's campaigns and statistics
Install
In your terminal, with SkillFoxx CLI
npx skillfoxx add mcp/sendpulse-mcpDetects the agents on your machine, checks the risk and pins the version.
Other ways to install
This entry is high risk, so there is no one-click install. Review the code and add the config by hand.
Run in a terminal
claude mcp add --transport stdio --env 'SENDPULSE_ID=<your SENDPULSE_ID>' --env 'SENDPULSE_SECRET=<your SENDPULSE_SECRET>' sendpulse -- npx -y @theyahia/sendpulse-mcpOr add to the file .mcp.json, in the project
{
"mcpServers": {
"sendpulse": {
"command": "npx",
"args": [
"-y",
"@theyahia/sendpulse-mcp"
],
"env": {
"SENDPULSE_ID": "<your SENDPULSE_ID>",
"SENDPULSE_SECRET": "<your SENDPULSE_SECRET>"
}
}
}
}If the file already exists, add the server inside the mcpServers key.
Keys and settings
SENDPULSE_IDsecret, requiredSENDPULSE_SECRETsecret, required
Replace the values in angle brackets with your own. Keys never go into install links and are not stored by us.
Add to the file ~/.cursor/mcp.json, for all projects
{
"mcpServers": {
"sendpulse": {
"command": "npx",
"args": [
"-y",
"@theyahia/sendpulse-mcp"
],
"env": {
"SENDPULSE_ID": "<your SENDPULSE_ID>",
"SENDPULSE_SECRET": "<your SENDPULSE_SECRET>"
}
}
}
}If the file already exists, add the server inside the mcpServers key. For a single project, put the same block into .cursor/mcp.json.
Keys and settings
SENDPULSE_IDsecret, requiredSENDPULSE_SECRETsecret, required
Replace the values in angle brackets with your own. Keys never go into install links and are not stored by us.
Run in a terminal
code --add-mcp '{"name":"sendpulse","type":"stdio","command":"npx","args":["-y","@theyahia/sendpulse-mcp"],"env":{"SENDPULSE_ID":"<your SENDPULSE_ID>","SENDPULSE_SECRET":"<your SENDPULSE_SECRET>"}}'Or add to the file .vscode/mcp.json, in the project
{
"servers": {
"sendpulse": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@theyahia/sendpulse-mcp"
],
"env": {
"SENDPULSE_ID": "<your SENDPULSE_ID>",
"SENDPULSE_SECRET": "<your SENDPULSE_SECRET>"
}
}
}
}If the file already exists, add the server inside the servers key.
Keys and settings
SENDPULSE_IDsecret, requiredSENDPULSE_SECRETsecret, required
Replace the values in angle brackets with your own. Keys never go into install links and are not stored by us.
Run in a terminal
codex mcp add sendpulse --env 'SENDPULSE_ID=<your SENDPULSE_ID>' --env 'SENDPULSE_SECRET=<your SENDPULSE_SECRET>' -- npx -y @theyahia/sendpulse-mcpOr add to the file ~/.codex/config.toml, for all projects
[mcp_servers.sendpulse]
command = "npx"
args = ["-y", "@theyahia/sendpulse-mcp"]
env = { SENDPULSE_ID = "<your SENDPULSE_ID>", SENDPULSE_SECRET = "<your SENDPULSE_SECRET>" }If the file already exists, append the block to the end.
Keys and settings
SENDPULSE_IDsecret, requiredSENDPULSE_SECRETsecret, required
Replace the values in angle brackets with your own. Keys never go into install links and are not stored by us.
Add to the file ~/.gemini/settings.json, for all projects
{
"mcpServers": {
"sendpulse": {
"command": "npx",
"args": [
"-y",
"@theyahia/sendpulse-mcp"
],
"env": {
"SENDPULSE_ID": "<your SENDPULSE_ID>",
"SENDPULSE_SECRET": "<your SENDPULSE_SECRET>"
}
}
}
}If the file already exists, add the server inside the mcpServers key.
Keys and settings
SENDPULSE_IDsecret, requiredSENDPULSE_SECRETsecret, required
Replace the values in angle brackets with your own. Keys never go into install links and are not stored by us.
Add to the file ~/.config/devin/mcp_config.json, for all projects
{
"mcpServers": {
"sendpulse": {
"command": "npx",
"args": [
"-y",
"@theyahia/sendpulse-mcp"
],
"env": {
"SENDPULSE_ID": "<your SENDPULSE_ID>",
"SENDPULSE_SECRET": "<your SENDPULSE_SECRET>"
}
}
}
}If the file already exists, add the server inside the mcpServers key. Legacy Cascade keeps the MCP config in ~/.codeium/windsurf/mcp_config.json.
Keys and settings
SENDPULSE_IDsecret, requiredSENDPULSE_SECRETsecret, required
Replace the values in angle brackets with your own. Keys never go into install links and are not stored by us.
Formerly Windsurf.
Add to the file cline_mcp_settings.json, for all projects
{
"mcpServers": {
"sendpulse": {
"command": "npx",
"args": [
"-y",
"@theyahia/sendpulse-mcp"
],
"env": {
"SENDPULSE_ID": "<your SENDPULSE_ID>",
"SENDPULSE_SECRET": "<your SENDPULSE_SECRET>"
}
}
}
}If the file already exists, add the server inside the mcpServers key. Open the settings file in Cline: MCP Servers tab, Configure MCP Servers.
Keys and settings
SENDPULSE_IDsecret, requiredSENDPULSE_SECRETsecret, required
Replace the values in angle brackets with your own. Keys never go into install links and are not stored by us.
Add to the file .roo/mcp.json, in the project
{
"mcpServers": {
"sendpulse": {
"command": "npx",
"args": [
"-y",
"@theyahia/sendpulse-mcp"
],
"env": {
"SENDPULSE_ID": "<your SENDPULSE_ID>",
"SENDPULSE_SECRET": "<your SENDPULSE_SECRET>"
}
}
}
}If the file already exists, add the server inside the mcpServers key.
Keys and settings
SENDPULSE_IDsecret, requiredSENDPULSE_SECRETsecret, required
Replace the values in angle brackets with your own. Keys never go into install links and are not stored by us.
A fork of Roo Code, same .roo folders.
Add to the file opencode.json, in the project
{
"mcp": {
"sendpulse": {
"type": "local",
"command": [
"npx",
"-y",
"@theyahia/sendpulse-mcp"
],
"environment": {
"SENDPULSE_ID": "<your SENDPULSE_ID>",
"SENDPULSE_SECRET": "<your SENDPULSE_SECRET>"
}
}
}
}If the file already exists, add the server inside the mcp key.
Keys and settings
SENDPULSE_IDsecret, requiredSENDPULSE_SECRETsecret, required
Replace the values in angle brackets with your own. Keys never go into install links and are not stored by us.
Add to the file ~/.config/zed/settings.json, for all projects
{
"context_servers": {
"sendpulse": {
"command": "npx",
"args": [
"-y",
"@theyahia/sendpulse-mcp"
],
"env": {
"SENDPULSE_ID": "<your SENDPULSE_ID>",
"SENDPULSE_SECRET": "<your SENDPULSE_SECRET>"
}
}
}
}If the file already exists, add the server inside the context_servers key.
Keys and settings
SENDPULSE_IDsecret, requiredSENDPULSE_SECRETsecret, required
Replace the values in angle brackets with your own. Keys never go into install links and are not stored by us.
Add to the file .codeassistant/mcp.json, in the project
{
"mcpServers": {
"sendpulse": {
"command": "npx",
"args": [
"-y",
"@theyahia/sendpulse-mcp"
],
"env": {
"SENDPULSE_ID": "<your SENDPULSE_ID>",
"SENDPULSE_SECRET": "<your SENDPULSE_SECRET>"
}
}
}
}If the file already exists, add the server inside the mcpServers key.
Keys and settings
SENDPULSE_IDsecret, requiredSENDPULSE_SECRETsecret, required
Replace the values in angle brackets with your own. Keys never go into install links and are not stored by us.
Get SENDPULSE_ID and SENDPULSE_SECRET from the SendPulse account API settings, then connect the server with claude mcp add sendpulse -e SENDPULSE_ID=id -e SENDPULSE_SECRET=secret -- npx -y @theyahia/sendpulse-mcp.
Other ways from the author
claude mcp add sendpulse -e SENDPULSE_ID=id -e SENDPULSE_SECRET=secret -- npx -y @theyahia/sendpulse-mcpCommand from the README for Claude Code.
This is third-party code. Review the repository files before installing.
What it does
The server authenticates to the SendPulse API using OAuth2 client credentials, caching and refreshing the token itself, and gives an agent 11 tools: a list of mailing lists with subscriber counts, creating and sending an email campaign to a list, a list of campaigns with send, open and click statistics, listing and viewing email templates, sending transactional mail via SMTP and listing sent SMTP mail, plus listing push-enabled sites, push notification statistics, and creating a push task. Two Claude Code skills run sending an email and a subscriber statistics summary.
Who it is for. For marketers running email and push campaigns in SendPulse who want to launch campaigns and check statistics through an agent.
Good fit when
- You want to quickly send an email campaign to an existing mailing list
- You need open and click statistics for a recent campaign
- You need to send transactional mail via SMTP or launch a push notification
Not a fit when
- You do not have a SendPulse account with API access
- You need to add or remove subscribers from mailing lists: no tool covers that
Example request
Send an email campaign to mailing list 12345 and show open statistics for the last weekLimitations
The project has a single author and is part of the same author's larger series of Russian API MCP servers. send_email really sends a campaign to the whole mailing list, and it cannot be undone after the call. The README does not describe SendPulse's API limits or plan restrictions.
How to disable. Remove the sendpulse server from your MCP client config.
MCP
- Transport
- stdio, http
- Authentication
- OAuth
| Environment variables | |
|---|---|
| SENDPULSE_ID required, secret | Client ID from the SendPulse account API settings. |
| SENDPULSE_SECRET required, secret | Client secret from the SendPulse account API settings. |
Security check
- Can send an email campaign to the entire mailing list in one call with no confirmation
- The OAuth2 credentials grant access to the account's campaigns and statistics
README in short
The Russian README groups 11 tools by mailing lists, campaigns, templates, SMTP and push notifications, describes the client credentials auth flow with automatic token refresh, and gives configs for Claude Desktop, Claude Code, Smithery and Streamable HTTP. Two Claude Code skills and example phrases are listed separately.
FAQ
Does the email go out immediately after send_email?
Yes, the tool creates and immediately sends a campaign to the given mailing list, and this cannot be undone.
Can I send mail without a mailing list?
Yes, for single transactional emails there is a separate smtp_send_email tool via the SMTP service.
Related
A skill that strips AI writing tells from text using Wikipedia's list, without adding invented facts
Marketing Skills for AI agents
Marketing Skills for AI Agents
About fifty skills for CRO, copywriting, SEO, analytics, ads and launches, built for coding agents
SendPulse MCP server
SendPulse MCP
SendPulse's official remote MCP server: statistics, campaigns and user data through an agent chat
Yandex Direct MCP generated from a machine-readable schema
yandex-direct-mcp
An MCP server and CLI covering all 113 Yandex Direct API v5 methods generated from WSDL, exposing 9 read tools by default and writes only on demand