@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

sendpulse-mcp

Quick Install