io.github.theYahia/sendpulse-mcp
MCP server for SendPulse API — mailing lists, email sending, statistics. OAuth2 auth.
Open source Open in the app JSON README (API)
About
MCP server for SendPulse API — mailing lists, email sending, statistics. OAuth2 auth.
Details
- Kind
- MCP servers
- Topic
- Government & public data
- Publisher
- theyahia
- Origin
- official
- Category
- ferramentas
- Transport
- local
- Version
- 1.0.3
- Last push
- 2026-09-03T04:47:30Z
- Repository state
- ativo
- Language
- TypeScript
- License
- MIT
- Added
- 2026-08-29 04:01:32
- Updated
- 2026-08-29 04:01:32
- Origin id
io.github.theYahia/sendpulse-mcp
README
# SendPulse MCP — рассылки, SMTP и push-уведомления из нейросети
Если вы искали, как отправить email-кампанию прямо из диалога с ИИ, наполнить адресную книгу, отправить транзакционное письмо через SMTP или разослать web-push без ручной работы в кабинете — это оно. 11 инструментов поверх SendPulse API с авторизацией OAuth2: адресные книги, кампании, шаблоны, SMTP и push-уведомления.
[](https://www.npmjs.com/package/@theyahia/sendpulse-mcp)
[](https://opensource.org/licenses/MIT)
## Установка
### Claude Desktop
```json
{
"mcpServers": {
"sendpulse": {
"command": "npx",
"args": ["-y", "@theyahia/sendpulse-mcp"],
"env": {
"SENDPULSE_ID": "your_client_id",
"SENDPULSE_SECRET": "your_client_secret"
}
}
}
}
```
### Claude Code
```bash
claude mcp add sendpulse -e SENDPULSE_ID=id -e SENDPULSE_SECRET=secret -- npx -y @theyahia/sendpulse-mcp
```
### Smithery
[](https://smithery.ai/server/@theyahia/sendpulse-mcp)
```bash
npx -y @smithery/cli install @theyahia/sendpulse-mcp --client claude
```
### Streamable HTTP (удалённый сервер / несколько клиентов)
```bash
npx @theyahia/sendpulse-mcp --http
# Слушает порт 3000 (переопределяется переменной PORT)
# POST /mcp — эндпоинт MCP
# GET /health — проверка состояния
```
## Авторизация
OAuth 2.0, поток client credentials. Задайте `SENDPULSE_ID` и `SENDPULSE_SECRET` из [настроек аккаунта SendPulse](https://login.sendpulse.com/settings/#api).
Эндпоинт токена: `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` | «Статистика подписчиков» |
## Разработка
```bash
npm install
npm run build
npm test
```
## Примеры промптов
```
Покажи все адресные книги
Отправь письмо по списку 12345
Какая статистика у моей последней кампании?
Покажи мои шаблоны писем
Отправь транзакционное письмо на user@example.com
Покажи сайты с push-уведомлениями
```
## Лицензия
MIT