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 |
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/dkanster/samotpravil-api-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server