sendpulse-mcp

Name: sendpulse-mcp
Author: theYahia

Local

github.com/theYahiaBusiness & Marketing0Updated 8w ago

Repository

About sendpulse-mcp

sendpulse-mcp connects MCP clients to SendPulse for email campaigns, SMTP messages, and web push. Its 11 tools cover mailing lists, campaigns, templates, delivery statistics, SMTP, and push notifications, using OAuth2 authentication.

Key features

01List mailing lists and templates
02Create email campaigns and view statistics
03Send transactional email through SMTP
04List sent SMTP messages
05Create push notifications and view statistics

Use cases

01Send an email campaign to a mailing list
02Check campaign opens and clicks
03Send a transactional message through SMTP
04Create a web push notification

MCP support

Exposes 11 SendPulse API tools to MCP clients over stdio or Streamable HTTP. It obtains and refreshes OAuth 2.0 client-credentials tokens automatically.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config

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

Run commandnpx -y @theyahia/sendpulse-mcp

Environment variables to set

SENDPULSE_IDSecretAPI key

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages

npm@theyahia/sendpulse-mcp1.0.3stdio

Tools

Saved tool list · updated 2w ago

This tool takes no parameters.

Details

From the project README

SendPulse MCP — рассылки, SMTP и push-уведомления из нейросети

Если вы искали, как отправить email-кампанию прямо из диалога с ИИ, наполнить адресную книгу, отправить транзакционное письмо через SMTP или разослать web-push без ручной работы в кабинете — это оно. 11 инструментов поверх SendPulse API с авторизацией OAuth2: адресные книги, кампании, шаблоны, SMTP и push-уведомления.

Установка

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 (удалённый сервер / несколько клиентов)

npx @theyahia/sendpulse-mcp --http
# Слушает порт 3000 (переопределяется переменной PORT)
# POST /mcp — эндпоинт MCP
# GET /health — проверка состояния

Авторизация

OAuth 2.0, поток client credentials. Задайте SENDPULSE_ID и SENDPULSE_SECRET из настроек аккаунта SendPulse.

Эндпоинт токена: POST https://api.sendpulse.com/oauth/access_token с grant_type=client_credentials.

Токены кэшируются и обновляются автоматически.

Инструменты (11)

Адресные книги

Инструмент	Описание
`get_mailing_lists`	Все адресные книги со счётчиками подписчиков

Кампании

Инструмент	Описание
`send_email`	Создать и отправить email-кампанию по адресной книге
`list_campaigns`	Список email-кампаний с пагинацией
`get_campaign_statistics`	Статистика кампании: отправлено, открытия, клики, open rate, click rate

Шаблоны

Инструмент	Описание
`list_templates`	Список шаблонов писем (свои или системные шаблоны SendPulse)
`get_template`	Подробности шаблона по ID

SMTP

Инструмент	Описание
`smtp_send_email`	Отправить транзакционное письмо через сервис SMTP
`smtp_list_emails`	Список отправленных SMTP-писем с пагинацией

Push-уведомления

Инструмент	Описание
`list_push_websites`	Список сайтов с push-подписками
`get_push_statistics`	Статистика push-уведомлений по сайту
`create_push_task`	Создать push-уведомление для сайта

Навыки (Skills)

Навык	Триггер
`skill-send-email`	«Отправь email через SendPulse»
`skill-list-stats`	«Статистика подписчиков»

Разработка

npm install
npm run build
npm test

Примеры промптов

Покажи все адресные книги
Отправь письмо по списку 12345
Какая статистика у моей последней кампании?
Покажи мои шаблоны писем
Отправь транзакционное письмо на [email protected]
Покажи сайты с push-уведомлениями

Лицензия

MIT

Telegram: @vhodvai

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

Read the getting-started guide

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.