@theyahia/sendpulse-mcp

Production-grade MCP server for SendPulse API — mailing lists, campaigns, templates, SMTP, push notifications. OAuth2 auth.

Installation

Claude Desktop

{
  "mcpServers": {
    "sendpulse": {
      "command": "npx",
      "args": ["-y", "@theyahia/sendpulse-mcp"],
      "env": {
        "SENDPULSE_ID": "your_client_id",
        "SENDPULSE_SECRET": "your_client_secret"
      }
    }
  }
}

Claude Code

claude mcp add sendpulse -e SENDPULSE_ID=id -e SENDPULSE_SECRET=secret -- npx -y @theyahia/sendpulse-mcp

Smithery

npx -y @smithery/cli install @theyahia/sendpulse-mcp --client claude

Streamable HTTP (remote / multi-client)

npx @theyahia/sendpulse-mcp --http
# Listening on port 3000 (override with PORT env)
# POST /mcp — MCP endpoint
# GET /health — health check

Auth

OAuth 2.0 client credentials flow. Set SENDPULSE_ID and SENDPULSE_SECRET from your SendPulse account settings.

Token endpoint: POST https://api.sendpulse.com/oauth/access_token with grant_type=client_credentials.

Tokens are cached and auto-refreshed.

Tools (11)

Mailing Lists

Tool	Description
get_mailing_lists	List all mailing lists (address books) with subscriber counts

Campaigns

Tool	Description
send_email	Create and send an email campaign to a mailing list
list_campaigns	List email campaigns with pagination
get_campaign_statistics	Campaign stats: sent, opens, clicks, open rate, click rate

Templates

Tool	Description
list_templates	List email templates (own or SendPulse system templates)
get_template	Get template details by ID

SMTP

Tool	Description
smtp_send_email	Send a transactional email via SMTP service
smtp_list_emails	List sent SMTP emails with pagination

Push Notifications

Tool	Description
list_push_websites	List websites with push subscriptions
get_push_statistics	Push notification statistics for a website
create_push_task	Create a push notification for a website

Skills

Skill	Trigger
skill-send-email	"Отправь email через SendPulse"
skill-list-stats	"Статистика подписчиков"

Development

npm install
npm run build
npm test

Example Prompts

Show all mailing lists
Send an email to list 12345
What are the stats for my last campaign?
List my email templates
Send a transactional email to user@example.com
Show push notification websites

License

MIT