MCP-Unisender предоставляет набор инструментов, сгруппированных по функциональным областям продукта: контакты, списки, письма, кампании, шаблоны, отправители и другие. Имя каждого инструмента строится по схеме unisender_<имя> — например, unisender_add_contact или unisender_send_email.
Ниже представлен полный список доступных инструментов.
Аккаунт и фоновые операции
- get_account — показывает профиль, тарифный план и лимиты контактов.
- whoami — показывает имя текущего пользователя Unisender.
- get_task_status — проверяет выполнение фоновой операции: экспорта, перемещения, удаления, изменения тегов и других массовых действий.
Контакты
- add_contact — создает один контакт с email и/или телефоном, полями, тегами и подпиской на списки.
- get_contact — показывает полную карточку контакта по ID: адреса, статусы, поля, списки и теги.
- update_contact — изменяет данные одного контакта, его поля, списки, теги и состояние «включен/отключен».
- search_contacts — поиск контактов по email, списку, сегменту, тегам и другим условиям. Возвращает найденные контакты и их общее количество.
- count_contacts — считает email-контакты во всем аккаунте или контакты, не состоящие ни в одном списке.
- delete_contacts — удаляет контакты из аккаунта либо исключает их из определенного списка. Удаление из аккаунта необратимо.
- disable_contacts — отключает выбранные контакты от рассылок, сохраняя их данные.
- enable_contacts — повторно включает ранее отключенные контакты. Не восстанавливает подписку тех, кто отписался самостоятельно.
- export_contacts — запускает экспорт всех или выбранных контактов в CSV либо XLSX.
Списки
- get_lists — показывает списки, их ID, названия, даты создания и счетчики контактов, включая доступных для отправки.
- create_list — создает пустой список контактов.
- update_list — переименовывает список, сохраняя его контакты и ID.
- delete_list — Удаляет список. По умолчанию контакты остаются в аккаунте.
- add_contacts_to_list — добавляет существующие контакты в другие списки, сохраняя участие в прежних
- move_contacts_to_list — перемещает контакты из одного списка в другой, исключая их из исходного.
Сегменты
- list_segments — возвращает сохраненные сегменты и их условия. По запросу также считает количество контактов.
- create_segment — создает сегмент по условиям, в определенном списке либо во всем аккаунте.
- update_segment — меняет название или условия сегмента. При изменении условий сегмент получает новый ID.
- delete_segment — удаляет сегмент, сохраняя сами контакты.
- list_segment_conditions — показывает доступные поля, операторы и значения для построения условий сегмента.
Теги
- list_tags — показывает существующие теги контактов и их ID.
- create_tag — создает новый тег.
- update_tag — переименовывает тег, сохраняя его на контактах.
- delete_tag — удаляет тег из аккаунта и снимает его со всех контактов.
Поля контактов
- list_contact_fields — показывает системные и пользовательские поля, их типы и коды для персонализации писем.
- create_contact_field — создает пользовательское поле. Его тип после создания изменить нельзя.
- update_contact_field — меняет название поля или код подстановки для персонализации.
- delete_contact_field — необратимо удаляет пользовательское поле вместе со значениями у всех контактов.
Письма и черновики
- list_letters — находит письма и черновики по теме, ID и другим параметрам.
- get_letter — возвращает содержимое письма, тему, отправителя, HTML и выбранную аудиторию.
- create_letter — создает письмо с содержимым и настройками. Возвращает ID; отправку не выполняет.
- update_letter — изменяет существующий черновик: тему, прехедер, содержимое, отправителя, получателей, UTM и отслеживание.
- copy_letter — создает копию письма, в том числе отправленного, для повторного использования и редактирования.
- archive_letter — переносит черновик в архив. Восстановление выполняется через кабинет.
- get_letter_edit_link — возвращает ссылку на страницу существующего черновика в кабинете.
- count_recipients — считает фактическое число получателей письма с учётом выбранных списков, сегментов и доступности контактов.
- send_test_letter — отправил тестовое письмо.
- check_letter_spam — запускает проверку письма через SpamAssassin, включая содержимое и почтовую аутентификацию. Для проверки письмо отправляется в проверочный ящик.
- get_spam_check_result — получает результат запущенной проверки: статус, оценку, обнаруженные проблемы и заключение.
Шаблоны
- list_templates — показывает сохраненные шаблоны аккаунта, позволяет искать их по названию и другим параметрам.
- get_template — возвращает один шаблон целиком, включая название, тему и HTML.
- create_template — сохраняет новый шаблон для последующего использования в письмах.
- update_template — меняет название, тему, язык или содержимое сохраненного шаблона.
- list_template_gallery — находит готовые дизайны в галерее, возвращает названия и ссылки на превью.
- list_gallery_categories — показывает категории и теги галереи, например тематики бизнеса и праздники.
- get_gallery_template — возвращает выбранный дизайн из галереи вместе с HTML для подготовки письма.
Отправка писем и отмена
- send_email — отправляет одно транзакционное письмо одному получателю. Это реальная отправка, а не создание черновика; в отчетах массовых кампаний она не отображается.
- send_test_letter — отправляет тестовую копию подготовленного письма на указанные проверочные адреса, а не всей аудитории.
- cancel_campaign — отменяет запланированную или еще выполняющуюся кампанию, если ее статус допускает отмену. Возобновить отмененную кампанию нельзя.
Важно
Send_email предназначен для одиночной отправки письма. Запустить массовую рассылку по списку напрямую из текущего набора инструментов пока нельзя. Кампанию можно подготовить через unisender_prepare_campaign и отправить из личного кабинета.
Кампании
- list_campaigns — показывает историю рассылок: ID кампаний, темы, статусы, даты, аудитории и основные показатели.
- get_campaign — возвращает настройки одной кампании: письмо, аудиторию, статус, расписание и счетчики.
- get_campaign_stats — показывает подробный отчёт: отправки, доставки, открытия, клики, отписки, жалобы, отказы и переходы по отдельным ссылкам.
- get_campaign_contacts — оказывает конкретных получателей по событиям: получили, открыли, перешли, отписались, пожаловались или получили отказ доставки.
- cancel_campaign — останавливает запланированную или идущую рассылку.
Отправители и домены
- list_senders — показывает адреса отправителей и статус их подтверждения.
- create_sender — добавляет адрес отправителя и отправляет на него письмо с подтверждением.
- resend_sender_confirmation — повторно отправляет письмо для подтверждения адреса отправителя.
- list_sender_domains — показывает зарегистрированные домены отправителей и состояние настройки DKIM.
- add_sender_domain — регистрирует домен для DKIM и возвращает TXT-запись, которую нужно разместить в DNS. Сам DNS не изменяет.