> ## 🗄 Репозиторий заархивирован
>
> Разработка переехала в **[theYahia/WWmcp](https://github.com/theYahia/WWmcp)** — монорепозиторий MCP-серверов для незападных API: СНГ, MENA, Африка, LATAM, Юго-Восточная Азия. Общее ядро `@theyahia/mcp-core`, единый CI, единый релизный конвейер.
>
> Актуальная версия того, что лежало здесь: [`servers/unisender/`](https://github.com/theYahia/WWmcp/tree/main/servers/unisender)
>
> Пакет в npm прежний — [`@theyahia/unisender-mcp`](https://www.npmjs.com/package/@theyahia/unisender-mcp), ставится и работает как раньше.
> Здесь больше ничего не обновляется. Задачи и pull request'ы — в WWmcp.
>
> **Archived — development moved to [theYahia/WWmcp](https://github.com/theYahia/WWmcp),** a monorepo of MCP servers for non-Western APIs.
> The current version of this package now lives at [`servers/unisender/`](https://github.com/theYahia/WWmcp/tree/main/servers/unisender).
> The npm package [`@theyahia/unisender-mcp`](https://www.npmjs.com/package/@theyahia/unisender-mcp) is unchanged.
> Please open issues and pull requests there.

# 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

---

Telegram: [@vhodvai](https://t.me/vhodvai)