io.github.theYahia/unisender-mcp
MCP server for UniSender API — email lists, campaigns, contacts. API key auth.
Open source Open in the app JSON README (API)
About
MCP server for UniSender API — email lists, campaigns, contacts. API key auth.
Details
- Kind
- MCP servers
- Topic
- Marketing & analytics
- Publisher
- theyahia
- Origin
- official
- Category
- ferramentas
- Transport
- local
- Version
- 1.0.2
- Last push
- 2026-09-03T04:46:54Z
- 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/unisender-mcp
README
# UniSender MCP — email-рассылки и списки подписчиков через нейросеть
Если вы искали, как запустить email-рассылку прямо из диалога с ИИ, добавить контакты в список, подставить шаблон или снять статистику по кампании без ручной работы в кабинете — это оно. 10 инструментов поверх API [UniSender](https://affiliate.unisender.com): списки, контакты, кампании, шаблоны и статистика.
> **[Регистрация в UniSender по реферальной ссылке](https://affiliate.unisender.com)** — 50% с первого платежа + 25% на регулярной основе.
[](https://www.npmjs.com/package/@theyahia/unisender-mcp)
[](https://opensource.org/licenses/MIT)
[](https://smithery.ai/server/@theyahia/unisender-mcp)
## Установка
### Claude Desktop
```json
{
"mcpServers": {
"unisender": {
"command": "npx",
"args": ["-y", "@theyahia/unisender-mcp"],
"env": {
"UNISENDER_API_KEY": "your_key"
}
}
}
}
```
### Claude Code
```bash
claude mcp add unisender -e UNISENDER_API_KEY=your_key -- npx -y @theyahia/unisender-mcp
```
### Smithery
```bash
npx @smithery/cli install @theyahia/unisender-mcp
```
### Streamable HTTP
```bash
UNISENDER_API_KEY=your_key npx @theyahia/unisender-mcp --http
# Сервер на http://localhost:3000/mcp
# Health check: GET http://localhost:3000/health
```
## Авторизация
`UNISENDER_API_KEY` — ключ API из UniSender. Где взять: [настройки API](https://www.unisender.com/ru/support/api/common/api-key/).
Базовый URL: `https://api.unisender.com/ru/api/`
## Инструменты (10)
### Списки
| Инструмент | Описание |
|------|-------------|
| `get_lists` | Все списки рассылки: ID, название, число подписчиков |
| `create_list` | Создать новый список рассылки |
### Контакты
| Инструмент | Описание |
|------|-------------|
| `get_contacts` | Контакты из списка: e-mail, статус подписки |
| `subscribe` | Подписать контакт на один или несколько списков |
### Кампании
| Инструмент | Описание |
|------|-------------|
| `create_email` | Создать письмо для кампании |
| `send_email` | Отправить кампанию с созданным письмом |
| `get_campaign_status` | Статус кампании |
| `get_campaign_delivery_stats` | Подробная статистика доставки |
### Шаблоны
| Инструмент | Описание |
|------|-------------|
| `get_templates` | Список шаблонов писем |
| `get_template` | Конкретный шаблон по ID |
## Навыки (Skills)
| Навык | Триггер | Описание |
|-------|---------|-------------|
| `skill-send-campaign` | «Отправь рассылку» | Полный цикл: список → письмо → отправка |
| `skill-campaign-stats` | «Статистика кампании» | Статус + подробная аналитика |
## Примеры промптов
```
Покажи все списки рассылки
Создай список «VIP-клиенты»
Подпиши user@example.com на список 123
Создай письмо с темой «Распродажа» и отправь на список 123
Статистика кампании 456
Покажи шаблоны писем
```
## Разработка
```bash
npm install
npm run build
npm test
```
## О UniSender
[UniSender](https://affiliate.unisender.com) — сервис email- и SMS-маркетинга. 50% с первого платежа + 25% на регулярной основе по [реферальной ссылке](https://affiliate.unisender.com).
## Лицензия
MIT