Back to the catalog

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% на регулярной основе.

[![npm](https://img.shields.io/npm/v/@theyahia/unisender-mcp)](https://www.npmjs.com/package/@theyahia/unisender-mcp)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
[![Smithery](https://smithery.ai/badge/@theyahia/unisender-mcp)](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

More