Samotpravil MCP
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| SAMOTPRAVIL_API_KEY | No | API key for Samotpravil API, needed only for api_request tool |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
| prompts | {
"listChanged": true
} |
| resources | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| get_overviewC | Обзор API СамОтправил. |
| list_endpointsC | Список методов API. |
| search_docsC | Поиск по документации API. |
| get_endpointC | Документация по методу API. |
| api_requestB | Generic HTTP к api.samotpravil.ru (safety flags, dry_run). Отключается через SAMOTPRAVIL_ALLOW_GENERIC_API=0. |
| send_emailD | POST /api/v1/smtp_send |
| send_mail_v2D | POST /api/v2/mail/send |
| get_delivery_statusC | GET /api/v2/issue/status по x_track_id |
| get_package_statusD | GET /api/v2/package/status |
| search_stop_listA | Поиск email в стоп-листах |
| add_stop_list_emailA | Добавить email в стоп-лист |
| remove_stop_list_emailB | Удалить email из стоп-листа |
| validate_emailD | POST /api/v2/emails/validate/ |
| list_allowed_domainsC | GET /api/v2/blist/domains |
| send_packageC | POST /api/v1/add_json_package — массовая отправка (Python SDK parity) |
| send_package_xmlC | GET /api/v1/add_package — XML-пакет по URL (Python SDK parity) |
| stop_packageC | GET /api/v1/package_stop — остановить пакет (Python SDK parity) |
| get_ext_statusC | GET /api/v2/issue/ext_status — полная история статусов (Python SDK parity) |
| get_statisticsD | GET /api/v2/issue/statistics (Python SDK parity) |
| get_non_delivery_by_dateC | GET /api/v2/blist/report/non-delivery (Python SDK parity) |
| get_non_delivery_by_issueD | GET /api/v2/issue/report/non-delivery (Python SDK parity) |
| get_fbl_report_by_dateC | GET /api/v2/blist/report/fbl (Python SDK parity) |
| get_fbl_report_by_issueD | GET /api/v2/issue/report/fbl (Python SDK parity) |
| get_unsubscribe_by_dateC | GET /api/v2/blist/report/unsubscribe (Python SDK parity) |
| get_unsubscribe_by_issueD | GET /api/v2/issue/report/unsubscribe (Python SDK parity) |
| get_issue_statD | GET /api/v1/get_issue_stat (Python SDK parity) |
| stop_list_unsubscribeC | GET /api/v2/stop-list/unsubscribe (Python SDK parity) |
| stop_list_fblC | GET /api/v2/stop-list/fbl (Python SDK parity) |
| stop_list_failedD | GET /api/v2/stop-list/failed (Python SDK parity) |
| stop_list_export_createC | POST /api/v2/stop-list/export — создать задачу экспорта (Python SDK parity) |
| stop_list_export_tasksC | GET /api/v2/stop-list/export — список задач экспорта (Python SDK parity) |
| stop_list_export_downloadC | GET /api/v2/stop-list/export/{token} (Python SDK parity) |
| stop_list_export_deleteC | DELETE /api/v2/stop-list/export/{token} (Python SDK parity) |
| domain_addC | POST /api/v2/blist/domains/add (Python SDK parity) |
| domain_removeC | POST /api/v2/blist/domains/remove (Python SDK parity) |
| domain_check_verificationD | POST /api/v2/blist/domains/verify (Python SDK parity) |
| get_blistC | GET /api/v2/blist — WhiteLabel (Python SDK parity) |
| create_blistC | POST /api/v2/blist/create — WhiteLabel (Python SDK parity) |
| update_blistC | POST /api/v2/blist/update — WhiteLabel (Python SDK parity) |
| get_ip_infoC | GET /api/v2/ip — WhiteLabel (Python SDK parity) |
| get_authkeyB | GET /api/v2/authkey — WhiteLabel (Python SDK parity) |
| create_authkeyD | POST /api/v2/authkey/create — WhiteLabel (Python SDK parity) |
| api_get_v2_stop_list_export_tokenC | GET /api/v2/stop-list/export/:token — Скачать стоп-лист |
| api_delete_v2_stop_list_export_tokenB | DELETE /api/v2/stop-list/export/:token — Удалить задачу |
| api_post_v2_email_checkC | POST /api/v2/email/check — Проверить верстку |
| api_post_v2_emails_cleanC | POST /api/v2/emails/clean/ — Стандартизация |
| api_get_v2_email_activityC | GET /api/v2/email/activity — Активность |
| api_get_v2_ticketsB | GET /api/v2/tickets — Список обращений |
| api_get_v2_tickets_idA | GET /api/v2/tickets/:id/ — Отдельное обращение |
| api_post_v2_ticketsC | POST /api/v2/tickets — Создать обращение |
| api_post_v2_tickets_ipA | POST /api/v2/tickets — Создать обращение на выделенный IP |
| api_post_v2_tickets_idB | POST /api/v2/tickets/:id/ — Обновить обращение |
| api_get_v1_get_smtp_issue_statC | GET /api/v1/get_smtp_issue_stat — Сводный отчет за сутки v1 |
| api_get_v1_get_fbl_reportC | GET /api/v1/get_fbl_report — Отчёт о пожаловавшихся v1 |
| api_get_v1_get_stop_reportC | GET /api/v1/get_stop_report — Отчёт о недоставках v1 |
| api_get_v1_package_reportC | GET /api/v1/package_report — Недоставки пакетной отправки v1 |
| api_get_v1_package_report_fblC | GET /api/v1/package_report_fbl — Жалобы пакетной отправки v1 |
| api_get_v1_package_statusC | GET /api/v1/package_status — Статус отправки v1 |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
| integration_overview | Обзор интеграции с СамОтправил: SMTP, HTTP API, auth, лимиты |
| send_transactional | Чеклист отправки одного транзакционного письма через API |
| stop_list_workflow | Workflow работы со стоп-листами |
| check_delivery | Проверка статуса доставки по X-Track-ID или номеру выпуска |
| python_sdk_parity | Маппинг Python SDK samotpravil → MCP tools |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
| overview | Обзор API: auth, SMTP, лимиты, категории |
| endpoints-index | Индекс всех API-методов со ссылками на endpoint resources |
| errors | Популярные ошибки доставки и API |
| integration | SMTP, X-Track-ID, трекинг, лимиты, SDK |
| sdk-mapping | Маппинг Python SDK samotpravil → MCP typed tools |
| changelog | Последние изменения samotpravil-mcp (фрагмент CHANGELOG) |
| rate-limits | Лимиты API, отправки и пакетов |
| api-wishlist | Предложения по развитию HTTP API СамОтправил (фрагмент) |
| Отправка через SMTP | SMTP api.samotpravil.ru:1126 |
| Отправка через API | POST https://api.samotpravil.ru/api/v1/smtp_send |
| Отправка XML v1 | GET https://api.samotpravil.ru/api/v1/add_package?url=https://example.com/xml_package.xml |
| Отправка JSON v1 | POST https://api.samotpravil.ru/api/v1/add_json_package |
| Остановить отправку | GET https://api.samotpravil.ru/api/v1/package_stop?pack_id=66677 |
| Статус пакета | GET https://api.samotpravil.ru/api/v2/package/status?issuen=123456 |
| Статус доставки | GET https://api.samotpravil.ru/api/v2/issue/status?x_track_id=299_20230621_135411 |
| Все статусы | GET https://api.samotpravil.ru/api/v2/issue/ext_status?x_track_id=299_20230621_135411 |
| Недоставки за период | GET https://api.samotpravil.ru/api/v2/blist/report/non-delivery?date_from=2024-02-20&date_to=2024-02-20&limit=5&cursor_next=12345&order=asc |
| Недоставки по выпуску | GET https://api.samotpravil.ru/api/v2/issue/report/non-delivery?issuen=123456&issuen=678901&limit=5&cursor_next=12345&order=asc |
| Жалобы за период | GET https://api.samotpravil.ru/api/v2/blist/report/fbl?date_from=2024-02-20&date_to=2024-02-20&limit=5&cursor_next=12345 |
| Жалобы на выпуск | GET https://api.samotpravil.ru/api/v2/issue/report/fbl?issuen=123456&issuen=678901&limit=5&cursor_next=12345 |
| Отписки за период | GET https://api.samotpravil.ru/api/v2/blist/report/unsubscribe?date_from=2024-02-20&date_to=2024-02-20&limit=5&cursor_next=12345&order=asc |
| Отписки по выпуску | GET https://api.samotpravil.ru/api/v2/issue/report/unsubscribe?issuen=123456&issuen=678901&limit=5&cursor_next=12345&order=asc |
| Отчет за период | GET https://api.samotpravil.ru/api/v2/issue/statistics?date_from=2023-11-01&date_to=2023-11-07×tamp_from=1706795600×tamp_to=1706831999&limit=5&cursor_next=563825&blist_id=1234 |
| Отчет по выпуску | GET https://api.samotpravil.ru/api/v1/get_issue_stat?id=66633&id=66634 |
| Webhook Единичная отправка | POST your-webhook-url.com/endpoint |
| Webhook Пакетная отправка | POST your-webhook-url.com/endpoint |
| Webhook о деактивации рассылки | POST your-webhook-url.com/endpoint |
| Поиск имейла | GET https://api.samotpravil.ru/api/v2/stop-list/search?email=example@domain.com |
| Удалить имейл | POST https://api.samotpravil.ru/api/v2/stop-list/remove?mail_from=info@samotpravil.ru&email=example@domain.com |
| Добавить имейл | POST https://api.samotpravil.ru/api/v2/stop-list/add?mail_from=info@samotpravil.ru&email=example@domain.com |
| Список отписавшихся | GET https://api.samotpravil.ru/api/v2/stop-list/unsubscribe?cursor_next=12345&limit=5 |
| Список FBL | GET https://api.samotpravil.ru/api/v2/stop-list/fbl?cursor_next=12345&limit=5 |
| Список Недоставок | GET https://api.samotpravil.ru/api/v2/stop-list/failed?cursor_next=12345&limit=5 |
| Создать задачу на экспорт | POST https://api.samotpravil.ru/api/v2/stop-list/export |
| Скачать стоп-лист | GET https://api.samotpravil.ru/api/v2/stop-list/export/:token |
| Список задач | GET https://api.samotpravil.ru/api/v2/stop-list/export?q=failed |
| Удалить задачу | DELETE https://api.samotpravil.ru/api/v2/stop-list/export/:token |
| Список разрешенных доменов | GET https://api.samotpravil.ru/api/v2/blist/domains |
| Добавить домен | POST https://api.samotpravil.ru/api/v2/blist/domains/add |
| Удалить домен | POST https://api.samotpravil.ru/api/v2/blist/domains/remove |
| Проверка верификации | POST https://api.samotpravil.ru/api/v2/blist/domains/verify |
| Информация о рассылке | GET https://api.samotpravil.ru/api/v2/blist?id=123 |
| Создать рассылку | POST https://api.samotpravil.ru/api/v2/blist/create |
| Обновить рассылку | POST https://api.samotpravil.ru/api/v2/blist/update |
| Информация об IP-адресе | GET https://api.samotpravil.ru/api/v2/ip |
| Получить информацию об API-ключе | GET https://api.samotpravil.ru/api/v2/authkey |
| Создать API-ключ | POST https://api.samotpravil.ru/api/v2/authkey/create |
| Проверить верстку | POST https://api.samotpravil.ru/api/v2/email/check |
| Валидация | POST https://api.samotpravil.ru/api/v2/emails/validate/ |
| Стандартизация | POST https://api.samotpravil.ru/api/v2/emails/clean/ |
| Активность | GET https://api.samotpravil.ru/api/v2/email/activity?email=example@mail.ru |
| Список обращений | GET https://api.samotpravil.ru/api/v2/tickets |
| Отдельное обращение | GET https://api.samotpravil.ru/api/v2/tickets/:id/ |
| Создать обращение | POST https://api.samotpravil.ru/api/v2/tickets |
| Создать обращение на выделенный IP | POST https://api.samotpravil.ru/api/v2/tickets |
| Обновить обращение | POST https://api.samotpravil.ru/api/v2/tickets/:id/ |
| Сводный отчет за сутки v1 | GET https://api.samotpravil.ru/api/v1/get_smtp_issue_stat?key=XXX&date=2024-01-28 |
| Отчёт о пожаловавшихся v1 | GET https://api.samotpravil.ru/api/v1/get_fbl_report?key=XXX&date=2023-04-15 |
| Отчёт о недоставках v1 | GET https://api.samotpravil.ru/api/v1/get_stop_report?key=XXX&date=2023-06-21 |
| Недоставки пакетной отправки v1 | GET https://api.samotpravil.ru/api/v1/package_report?key=XXX&id=12345 |
| Жалобы пакетной отправки v1 | GET https://api.samotpravil.ru/api/v1/package_report_fbl?key=XXX&pack_id=12345 |
| Статус отправки v1 | GET https://api.samotpravil.ru/api/v1/package_status?key=XXX&pack_id=12345 |
| Отправка через API v2 | POST https://api.samotpravil.ru/api/v2/mail/send |
TDQS
Scored across 58 tools
Multiple tools have overlapping or identical purposes (e.g., send_email vs send_mail_v2, stop_list_export_delete vs api_delete_v2_stop_list_export_token, api_post_v2_tickets vs api_post_v2_tickets_ip). The presence of both SDK-parity and raw API wrapper functions creates redundant paths for the same operation, making it very difficult for an agent to determine which tool to use.
The naming is a mix of descriptive snake_case (get_delivery_status), versioned names (send_mail_v2), and raw API-style names with HTTP verbs and version prefixes (api_get_v2_tickets_id). There is no consistent verb_noun pattern; the api_* group breaks the otherwise somewhat consistent snake_case convention, and versioning is applied haphazardly.
With 58 tools, this server is severely overloaded. The count includes many redundant wrappers, meta-tools for documentation (list_endpoints, get_endpoint, search_docs), and near-duplicates of the same endpoint. This far exceeds a usable tool surface for an email delivery API, overwhelming agents with unnecessary choices.
The tool set covers a wide range of the email API domain: sending (email, packages), delivery status, stop-list management, reports, tickets, domain whitelist, IP info, and email validation. While there are some potential gaps (e.g., missing update for packages, no bulk update operations), the core lifecycle is well represented and an agent can accomplish most tasks without hitting dead ends.