# DashaMail MCP Server

[![smithery badge](https://smithery.ai/badge/dashamail/mcp)](https://smithery.ai/servers/dashamail/mcp)

MCP-сервер сервиса email-маркетинга [DashaMail](https://dashamail.ru): даёт
ИИ-агенту доступ к аккаунту — адресные базы, рассылки, отчёты, шаблоны,
автоматизации, сегменты, транзакционные письма, вебхуки и входящая почта.

Сервер удалённый, разворачивать ничего не нужно.

| | |
|---|---|
| Адрес | `https://mcp.dashamail.ru/` |
| Транспорт | Streamable HTTP, протокол MCP 2025-06-18 |
| Авторизация | OAuth 2.1 + PKCE + динамическая регистрация клиента, либо API-ключ |
| Инструментов | 107 ([список](TOOLS.md)) |
| В реестре | `ru.dashamail/mcp` |
| Документация | https://dashamail.ru/api/mcp/ |

Исходный код сервера закрыт — репозиторий нужен для описания и обратной
связи. Ошибки и пожелания: issues или `support@dashamail.ru`.

## Подключение

Нужен аккаунт DashaMail — [зарегистрироваться](https://dashamail.ru).
Бесплатного тарифа достаточно, чтобы подключиться и посмотреть.

### Claude

Settings → Connectors → Add custom connector, адрес
`https://mcp.dashamail.ru/`. Откроется экран согласия DashaMail, где вы
выбираете, какие разделы аккаунта доступны агенту.

### Cursor, VS Code и другие клиенты

```json
{
  "mcpServers": {
    "dashamail": {
      "url": "https://mcp.dashamail.ru/"
    }
  }
}
```

Клиент сам зарегистрируется по OAuth. Если клиент OAuth не умеет, передайте
[API-ключ](https://dashamail.ru/api/) заголовком:

```json
{
  "mcpServers": {
    "dashamail": {
      "url": "https://mcp.dashamail.ru/",
      "headers": { "Authorization": "Bearer ВАШ_КЛЮЧ" }
    }
  }
}
```

## Что важно знать

**Сначала черновик.** Создание рассылки никогда не запускает отправку — для
этого есть отдельные инструменты `campaigns_schedule` и
`campaigns_send_now`. Так агент не разошлёт письма, «помогая» с черновиком.

**Подтверждение перед отправкой.** У двенадцати инструментов, которые отправляют
письма или удаляют данные, проставлен `destructiveHint` — клиент спрашивает
подтверждение перед каждым вызовом. Чтение идёт без вопросов.

**Права выбираете вы.** На экране согласия видно, какие разделы аккаунта
запрашивает клиент; выбор меняется потом в кабинете. Токен ограничен
выбранным.

**Чужой текст помечен.** Ответ подписчика на рассылку и значение поля из
формы — это данные, а не указания агенту. У инструментов, которые такой
текст возвращают, это написано в описании; флаг `?no_ugc=1` убирает его из
ответов совсем.

**Справочники отдельно от инструментов.** Сервер отдаёт пять ресурсов MCP
(`dashamail://docs/metrics`, `docs/segments`, `docs/personalization`,
`docs/errors`, `account/summary`): формулы метрик, формат условий отбора,
подстановки в письме, коды ошибок и состояние аккаунта. Клиент прикладывает
их к разговору целиком, вместо того чтобы агент вычитывал одно и то же из
описания каждого инструмента.

**Файл и проверка — прямо из разговора.** `imports_start` принимает файл
содержимым — CSV текстом, остальное в base64, — так что базу, собранную в
переписке, не нужно выкладывать по ссылке. `campaigns_test` с `member_email`
заполняет подстановки данными выбранного подписчика: персональный вариант
письма проверяется до запуска.

**Отчёт карточкой.** В клиентах с поддержкой MCP Apps — например, в Claude —
`reports_dashboard` показывает итоги рассылки интерактивной карточкой прямо в
переписке: доставка, открытия, клики, отписки, график по часам за первые
трое суток, почтовые домены и ссылки; на полном экране переключаются
последние рассылки. Доли считаются от доставленных, как в отчёте кабинета.
Остальные клиенты получают ту же сводку текстом.

**Три параметра для сужения:**

| Параметр | Что делает |
|---|---|
| `?readonly=1` | убирает все изменяющие инструменты, остаётся только чтение |
| `?toolset=core` | короткий набор (~40) для клиентов с малым контекстом |
| `?no_ugc=1` | ответы без текста, написанного посторонними |

Например: `https://mcp.dashamail.ru/?readonly=1&toolset=core`

## Что можно делать

- собрать и почистить адресную базу, проверить её здоровье перед отправкой;
- поставить A/B-тест по теме или отправителю, а через сутки разобрать, кто
  выиграл, и отправить победителя остальным;
- сделать черновик рассылки по брифу, запланировать, потом разобрать отчёт —
  открытия, клики, возвраты, отписки по доменам, ссылкам, географии и
  устройствам;
- разобраться, почему клиент не получил транзакционное письмо;
- сравнить периоды и каналы, не открывая кабинет.

## Ссылки

- [Документация MCP-сервера](https://dashamail.ru/api/mcp/)
- [Страница возможностей](https://dashamail.ru/features/mcp/)
- [REST API v2](https://dashamail.ru/api/)
- [Сервер в каталоге Smithery](https://smithery.ai/servers/dashamail/mcp)
- [Политика обработки персональных данных](https://dashamail.ru/privacy/)
  ([English](https://dashamail.ru/privacy_en/))

## Лицензия

[MIT](LICENSE) — на содержимое этого репозитория: описание, список
инструментов и манифест сервера. Сам MCP-сервер и сервис DashaMail под неё
не попадают: их код закрыт и здесь не распространяется.

---

## English

MCP server for [DashaMail](https://dashamail.ru), an email marketing service
used by Russian businesses. It gives an AI agent access to the account:
subscriber lists and members, campaigns, reports, templates, automations,
transactional email, segments, dialogs, webhooks and inbound routing — 107 tools
in total.

The server is remote, at `https://mcp.dashamail.ru/`, over Streamable HTTP.
Authentication is OAuth 2.1 with PKCE and dynamic client registration; an API
key in the `Authorization` header works too. A DashaMail account is required.

Draft-first by design: creating a campaign never sends it. Sending, scheduling
and deletion carry `destructiveHint`, so clients ask for confirmation before
each call; read-only tools run without prompts. Users pick scopes on the
consent screen and can change them later. `?readonly=1` drops every write
tool, `?toolset=core` exposes a compact set for small context windows, and
`?no_ugc=1` strips text written by outsiders — subscriber-entered field
values and inbound email — which tool descriptions otherwise flag as data,
not instructions.

Besides tools the server exposes five MCP resources — metric definitions and
calculation bases, the segment condition format, merge tags and conditional
blocks, error codes, and a snapshot of the account — so a client can attach
the reference material once instead of the agent re-reading it from every
tool description.

`imports_start` accepts a file as its contents (CSV as text, other formats in
base64), so a list put together in the conversation needs no public link, and
`campaigns_test` with `member_email` fills the merge tags from a chosen
subscriber, so a personalised version of an email can be checked before
launch.

In clients that support MCP Apps, such as Claude, `reports_dashboard` renders
a campaign report as an interactive card right in the conversation: delivery,
opens, clicks, unsubscribes, an hourly chart for the first three days, mail
domains and links, with a switcher between recent campaigns in full screen.
Rates are shares of delivered email, as in the DashaMail dashboard report.
Other clients get the same summary as text.

The server source is closed; this repository holds the description and is the
place for issues. Tool list: [TOOLS.md](TOOLS.md). Support:
`support@dashamail.ru`.

The contents of this repository — the description, the tool list and the
server manifest — are published under the [MIT license](LICENSE). The MCP
server and the DashaMail service are not covered by it.