DashaMail

DashaMail MCP Server

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

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

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

Исходный код сервера закрыт — репозиторий нужен для описания и обратной связи. Ошибки и пожелания: issues или [email protected].

Подключение

Нужен аккаунт DashaMail — зарегистрироваться. Бесплатного тарифа достаточно, чтобы подключиться и посмотреть.

Claude

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

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

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

Клиент сам зарегистрируется по OAuth. Если клиент OAuth не умеет, передайте API-ключ заголовком:

{
  "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-сервера
• Страница возможностей
• REST API v2
• Сервер в каталоге Smithery
• Политика обработки персональных данных (English)

Лицензия

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

---

English

MCP server for DashaMail, 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. Support: [email protected].

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