io.github.theYahia/sendpulse-mcp
MCP server for SendPulse API — mailing lists, email sending, statistics. OAuth2 auth.
Install
Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).
@theyahia/sendpulse-mcpclaude mcp add sendpulse-mcp -e 'SENDPULSE_ID=<your sendpulse_id>' -- npx -y @theyahia/sendpulse-mcp@1.0.3
{
"mcpServers": {
"sendpulse-mcp": {
"command": "npx",
"args": [
"-y",
"@theyahia/sendpulse-mcp@1.0.3"
],
"env": {
"SENDPULSE_ID": "<your sendpulse_id>"
}
}
}
}
Environment variables
SENDPULSE_IDrequired secret API key
Documentation
From the project's README on GitHub, refreshed weekly. Links open on GitHub.
Contents
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
Какая статистика у моей последней кампании?
Покажи мои шаблоны писем
Отправь транзакционное письмо на user@example.com
Покажи сайты с push-уведомлениями
Лицензия
MIT
Telegram: @vhodvai
Frequently asked questions
What is io.github.theYahia/sendpulse-mcp?
MCP server for SendPulse API — mailing lists, email sending, statistics. OAuth2 auth.
How do I install io.github.theYahia/sendpulse-mcp?
It runs on your machine. In Claude Code: claude mcp add sendpulse-mcp -e 'SENDPULSE_ID=<your sendpulse_id>' -- npx -y @theyahia/sendpulse-mcp@1.0.3. For other clients, paste the JSON configuration from this page into their MCP settings.
Does io.github.theYahia/sendpulse-mcp need an API key?
Yes. It expects SENDPULSE_ID, which you set in its configuration.
Is io.github.theYahia/sendpulse-mcp open source?
Yes. Its code is on GitHub under the MIT license.
Who maintains io.github.theYahia/sendpulse-mcp?
It is published by theYahia. AI.tn lists it but does not maintain or endorse it.
From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.