Samotpravil MCP

NPM · SAMOTPRAVIL-MCP · SCANNED AUG 3

MCP server for Samotpravil API — docs, typed tools, Python SDK parity, safety flags.

Available components

+26 this week 71 71 Trust /100

Trust breakdown (6 categories)

How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. How we score →

Supply Chain Security86

No malware found by supply-chain analysis.Pass
Only part of the dependency tree could be resolved (94 of 98), so this covers what we could see, not the whole tree.Partial
No install/post-install scripts declared.Pass
Only part of the dependency tree could be resolved (94 of 98), so this covers what we could see, not the whole tree. View diagnostics → Partial

Provenance & Transparency71

Repository check failed: the declared repository URL redirects; it must resolve directly. See how to fix → View diagnostics → Fail
Cryptographically verified build provenance (signed, bound to dkanster/samotpravil-mcp). View diagnostics → Pass
Clear OSI-approved license (MIT).Pass
Actively maintained (last published 21 days ago).Pass
Disclosure check failed: no security disclosure policy was found in the source repository. See how to fix → Fail

Schema Quality & AI Usability67

100% of prompts and resources have a non-trivial description (not blank, and not just the item's name).Pass
AI-judged instruction clarity (fair).Partial
Tool/resource definitions use about 6071 tokens (~50/item across 121 items; 58 tools + 63 resources), lean.Pass
Usage-examples check failed: none of the tools include examples. See how to fix → Fail

Stability & Change Management27

Stability observed for 8 of 30 days with no destabilising changes; credit accrues until the full window elapses.Partial

Tool Coverage89

100% of tools have a non-trivial description (not blank, and not just the tool's name).Pass
68% of tool parameters carry a description.Partial

Capabilities100

Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.Pass

Install

Add this component to your MCP client. Where a client-specific snippet is available, pick your client below and copy it straight into your config; otherwise use the connection detail shown.

npm · samotpravil-mcp

Claude Codex opencode OpenClaw Hermes Other

# add to Claude Code

claude mcp add dkanster-samotpravil-mcp -- npx -y samotpravil-mcp

# add to Codex CLI

codex mcp add dkanster-samotpravil-mcp -- npx -y samotpravil-mcp

// opencode.json

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "dkanster-samotpravil-mcp": {
      "type": "local",
      "command": [
        "npx",
        "-y",
        "samotpravil-mcp"
      ],
      "enabled": true
    }
  }
}

# add to OpenClaw

openclaw mcp add dkanster-samotpravil-mcp --command npx --arg -y --arg samotpravil-mcp

# ~/.hermes/config.yaml

mcp_servers:
  dkanster-samotpravil-mcp:
    command: "npx"
    args: ["-y", "samotpravil-mcp"]

// mcp.json

{
  "mcpServers": {
    "dkanster-samotpravil-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "samotpravil-mcp"
      ]
    }
  }
}

Changelog

Every change we have recorded for this component, newest first. Security-relevant changes are always shown. ▲ marks a change for the better, ▼ a change for the worse; unmarked changes are neutral.

2 Aug 26 +51
- Known CVEs: unverified → partial ▲ security
- Malware scan: unverified → pass ▲ security
- Install scripts: unverified → pass ▲ security
- Provenance: unverified → pass ▲ security
- The attested source repository moved: dkanster/samotpravil-mcp security
- Tool coverage: 100 → unverified ▼ functional
- Schema quality: 100 → unverified ▼ functional
- Security disclosure: fail → unverified ▼ functional
- Stability: unverified → 0.23 ▲ functional
- MCP protocol: unverified → pass ▲ functional
- Dependency health: unverified → partial ▲ functional
- Schema quality: unverified → fair ▲ functional
- License: unverified → pass ▲ functional
- Maintenance: unverified → pass ▲ functional
- Licence: MIT functional
31 Jul 26 −7
- We updated how we score, so this day's move reflects our rubric, not a change to the server See what changed → functional
30 Jul 26 −18
- Malware scan: pass → unverified ▼ security
27 Jul 26 45

First indexed and scored.

Show 2 earlier entries Hide earlier entries

Diagnostics

Diagnostic detail from the automated scan of this channel: what the scanner observed at each step, so you can see exactly where a check passed or failed. It is informational only and never changes the trust score.

Captured 3 Aug 2026 · Analysed npm/[email protected]

Provenance verified

Ecosystem: npm · Outcome: verified

Reason: verified

Source repo:: dkanster/samotpravil-mcp
Certificate issuer:: https://token.actions.githubusercontent.com
Certificate SAN:: https://github.com/dkanster/samotpravil-mcp/.github/workflows/publish.yml@refs/tags/v1.8.0
Rekor log index:: 2160565328
Predicate type:: https://slsa.dev/provenance/v1
Subject digest:: sha512:f9804a2d5e44d45c75a6255a02ee651041db8c2231adc733cd313df9ba5fd404c7722081e67f7a77fb43d057e0ea183f8567e609d7c338f79aa1a332a
Discovery method:: attestation_endpoint

Dependencies 94 packages

94 packages in the resolved dependency tree · 94 deprecated · 29 stale.

The dependency tree was only partially resolved, so these counts may be incomplete.

MCP tools — 58 exposed · ~4,133 tokens

The tools this component advertises to a client, with an estimated token cost for each. Expand a tool to see its parameters and schema. The per-tool counts are indicative and are not scored directly; the schema's total context footprint is one signal in Schema Quality & AI Usability.

Tool Tokens

add_stop_list_email ~81

Добавить email в стоп-лист

Input Output Examples

Name	Type	Req	Description
domain	string	—	Домен отправителя (как в Python SDK: info@domain)
dry_run	boolean	—	Показать запрос без отправки на API
email	string	yes	Email в стоп-листе
mail_from	string	—	Email отправителя (mail_from)

No output schema declared.

No examples provided.

api_delete_v2_stop_list_export_token ~49

DELETE /api/v2/stop-list/export/:token — Удалить задачу

Input Output Examples

Name	Type	Req	Description
dry_run	boolean	—	Показать запрос без отправки на API

No output schema declared.

No examples provided.

api_get_v1_get_fbl_report ~89

GET /api/v1/get_fbl_report — Отчёт о пожаловавшихся v1

Input Output Examples

Name	Type	Req	Description
date	string	—	Query-параметр (пример: 2023-04-15)
dry_run	boolean	—	Показать запрос без отправки на API
key	string	—	Query-параметр (пример: XXX)

No output schema declared.

No examples provided.

api_get_v1_get_smtp_issue_stat ~90

GET /api/v1/get_smtp_issue_stat — Сводный отчет за сутки v1

Input Output Examples

Name	Type	Req	Description
date	string	—	Query-параметр (пример: 2024-01-28)
dry_run	boolean	—	Показать запрос без отправки на API
key	string	—	Query-параметр (пример: XXX)

No output schema declared.

No examples provided.

api_get_v1_get_stop_report ~87

GET /api/v1/get_stop_report — Отчёт о недоставках v1

Input Output Examples

Name	Type	Req	Description
date	string	—	Query-параметр (пример: 2023-06-21)
dry_run	boolean	—	Показать запрос без отправки на API
key	string	—	Query-параметр (пример: XXX)

No output schema declared.

No examples provided.

api_get_v1_package_report ~81

GET /api/v1/package_report — Недоставки пакетной отправки v1

Input Output Examples

Name	Type	Req	Description
dry_run	boolean	—	Показать запрос без отправки на API
id	string	—	Query-параметр (пример: 12345)
key	string	—	Query-параметр (пример: XXX)

No output schema declared.

No examples provided.

api_get_v1_package_report_fbl ~85

GET /api/v1/package_report_fbl — Жалобы пакетной отправки v1

Input Output Examples

Name	Type	Req	Description
dry_run	boolean	—	Показать запрос без отправки на API
key	string	—	Query-параметр (пример: XXX)
pack_id	string	—	Query-параметр (пример: 12345)

No output schema declared.

No examples provided.

api_get_v1_package_status ~80

GET /api/v1/package_status — Статус отправки v1

Input Output Examples

Name	Type	Req	Description
dry_run	boolean	—	Показать запрос без отправки на API
key	string	—	Query-параметр (пример: XXX)
pack_id	string	—	Query-параметр (пример: 12345)

No output schema declared.

No examples provided.

api_get_v2_stop_list_export_token ~48

GET /api/v2/stop-list/export/:token — Скачать стоп-лист

Input Output Examples

Name	Type	Req	Description
dry_run	boolean	—	Показать запрос без отправки на API

No output schema declared.

No examples provided.

api_get_v2_tickets ~42

GET /api/v2/tickets — Список обращений

Input Output Examples

Name	Type	Req	Description
dry_run	boolean	—	Показать запрос без отправки на API

No output schema declared.

No examples provided.

api_get_v2_tickets_id ~47

GET /api/v2/tickets/:id/ — Отдельное обращение

Input Output Examples

Name	Type	Req	Description
dry_run	boolean	—	Показать запрос без отправки на API

No output schema declared.

No examples provided.

api_post_v2_email_check ~112

POST /api/v2/email/check — Проверить верстку

Input Output Examples

Name	Type	Req	Description
body	—	—	Поле тела (пример: "HTML content")
checks	—	—	Поле тела (пример: [{"category":"missingAltText"},{"category":"missingImageLink"},{"category":"missingCopyLink"},{"category":"overageImageWeight","limit":500},{"category":"unreachableWebLink"},{"cate…
dry_run	boolean	—	Показать запрос без отправки на API

No output schema declared.

No examples provided.

api_post_v2_emails_activity ~59

POST /api/v2/emails/activity/ — Активность

Input Output Examples

Name	Type	Req	Description
dry_run	boolean	—	Показать запрос без отправки на API
email	—	—	Поле тела (пример: "[email protected]")

No output schema declared.

No examples provided.

api_post_v2_emails_clean ~62

POST /api/v2/emails/clean/ — Стандартизация

Input Output Examples

Name	Type	Req	Description
dry_run	boolean	—	Показать запрос без отправки на API
email	—	—	Поле тела (пример: "example@mail,ru")

No output schema declared.

No examples provided.

api_post_v2_tickets ~96

POST /api/v2/tickets — Создать обращение

Input Output Examples

Name	Type	Req	Description
client_email	—	—	Поле тела (пример: "[email protected]")
client_name	—	—	Поле тела (пример: "Иван")
dry_run	boolean	—	Показать запрос без отправки на API
message	—	—	Поле тела (пример: "")
subject	—	—	Поле тела (пример: "")

No output schema declared.

No examples provided.

api_post_v2_tickets_id ~101

POST /api/v2/tickets/:id/ — Обновить обращение

Input Output Examples

Name	Type	Req	Description
client_email	—	—	Поле тела (пример: "[email protected]")
client_name	—	—	Поле тела (пример: "Иван")
dry_run	boolean	—	Показать запрос без отправки на API
message	—	—	Поле тела (пример: "")
subject	—	—	Поле тела (пример: "")

No output schema declared.

No examples provided.

api_post_v2_tickets_ip ~117

POST /api/v2/tickets — Создать обращение на выделенный IP

Input Output Examples

Name	Type	Req	Description
cooment	—	—	Поле тела (пример: "")
dry_run	boolean	—	Показать запрос без отправки на API
region	—	—	Поле тела (пример: "ru")
speed	—	—	Поле тела (пример: "standard")
subject	—	—	Поле тела (пример: "Заявка на выделенный IP")
type	—	—	Поле тела (пример: "standard")

No output schema declared.

No examples provided.

api_request ~110

Generic HTTP к api.samotpravil.ru (safety flags, dry_run). Отключается через SAMOTPRAVIL_ALLOW_GENERIC_API=0.

Input Output Examples

Name	Type	Req	Description
body	—	—	JSON-тело запроса
dry_run	boolean	—	Показать запрос без отправки на API
method	string	yes	HTTP-метод
path	string	yes	Путь API, например /api/v1/smtp_send
query	object	—	Query-параметры

No output schema declared.

No examples provided.

create_authkey ~67

POST /api/v2/authkey/create — WhiteLabel (Python SDK parity)

Input Output Examples

Name	Type	Req	Description
allowed_ips	array	—	—
blist_id	integer	yes	—
check_ips	boolean	—	—
dry_run	boolean	—	Показать запрос без отправки на API

No output schema declared.

No examples provided.

create_blist ~98

POST /api/v2/blist/create — WhiteLabel (Python SDK parity)

Input Output Examples

Name	Type	Req	Description
check_stop_list	boolean	—	—
dry_run	boolean	—	Показать запрос без отправки на API
name	string	yes	—
web_hook_send_accepted_delivered	boolean	—	—
webhook_active	boolean	—	—
webhook_send_xml_failed_global	boolean	—	—
webhook_url	string	—	—

No output schema declared.

No examples provided.

domain_add ~47

POST /api/v2/blist/domains/add (Python SDK parity)

Input Output Examples

Name	Type	Req	Description
domain	string	yes	—
dry_run	boolean	—	Показать запрос без отправки на API

No output schema declared.

No examples provided.

domain_check_verification ~50

POST /api/v2/blist/domains/verify (Python SDK parity)

Input Output Examples

Name	Type	Req	Description
domain	string	yes	—
dry_run	boolean	—	Показать запрос без отправки на API

No output schema declared.

No examples provided.

domain_remove ~47

POST /api/v2/blist/domains/remove (Python SDK parity)

Input Output Examples

Name	Type	Req	Description
domain	string	yes	—
dry_run	boolean	—	Показать запрос без отправки на API

No output schema declared.

No examples provided.

get_authkey ~41

GET /api/v2/authkey — WhiteLabel (Python SDK parity)

Input Output Examples

Name	Type	Req	Description
dry_run	boolean	—	Показать запрос без отправки на API

No output schema declared.

No examples provided.

get_blist ~48

GET /api/v2/blist — WhiteLabel (Python SDK parity)

Input Output Examples

Name	Type	Req	Description
blist_id	—	yes	—
dry_run	boolean	—	Показать запрос без отправки на API

No output schema declared.

No examples provided.

get_delivery_status ~65

GET /api/v2/issue/status по x_track_id

Input Output Examples

Name	Type	Req	Description
dry_run	boolean	—	Показать запрос без отправки на API
message_id	string	—	Message-ID системы
x_track_id	string	—	X-Track-ID отправки

No output schema declared.

No examples provided.

get_endpoint ~36

Документация по методу API.

Input Output Examples

Name	Type	Req	Description
name_or_path	string	yes	Название метода или часть URL, например smtp_send

No output schema declared.

No examples provided.

get_ext_status ~63

GET /api/v2/issue/ext_status — полная история статусов (Python SDK parity)

Input Output Examples

Name	Type	Req	Description
dry_run	boolean	—	Показать запрос без отправки на API
message_id	string	—	—
x_track_id	string	—	—

No output schema declared.

No examples provided.

get_fbl_report_by_date ~97

GET /api/v2/blist/report/fbl (Python SDK parity)

Input Output Examples

Name	Type	Req	Description
cursor_next	integer	—	Пагинация
date_from	string	yes	Дата YYYY-MM-DD
date_to	string	yes	Дата YYYY-MM-DD
dry_run	boolean	—	Показать запрос без отправки на API
limit	integer	—	Лимит объектов (default 100)

No output schema declared.

No examples provided.

get_fbl_report_by_issue ~65

GET /api/v2/issue/report/fbl (Python SDK parity)

Input Output Examples

Name	Type	Req	Description
cursor_next	integer	—	—
dry_run	boolean	—	Показать запрос без отправки на API
issuen	—	yes	—
limit	integer	—	—

No output schema declared.

No examples provided.

get_ip_info ~40

GET /api/v2/ip — WhiteLabel (Python SDK parity)

Input Output Examples

Name	Type	Req	Description
dry_run	boolean	—	Показать запрос без отправки на API

No output schema declared.

No examples provided.

get_issue_stat ~52

GET /api/v1/get_issue_stat (Python SDK parity)

Input Output Examples

Name	Type	Req	Description
dry_run	boolean	—	Показать запрос без отправки на API
ids	array	yes	ID пакетов из send_package

No output schema declared.

No examples provided.

get_non_delivery_by_date ~97

GET /api/v2/blist/report/non-delivery (Python SDK parity)

Input Output Examples

Name	Type	Req	Description
cursor_next	integer	—	Пагинация
date_from	string	yes	Дата YYYY-MM-DD
date_to	string	yes	Дата YYYY-MM-DD
dry_run	boolean	—	Показать запрос без отправки на API
limit	integer	—	Лимит объектов (default 100)

No output schema declared.

No examples provided.

get_non_delivery_by_issue ~65

GET /api/v2/issue/report/non-delivery (Python SDK parity)

Input Output Examples

Name	Type	Req	Description
cursor_next	integer	—	—
dry_run	boolean	—	Показать запрос без отправки на API
issuen	—	yes	—
limit	integer	—	—

No output schema declared.

No examples provided.

get_overview ~17

Обзор API СамОтправил.

Input Output Examples

Input schema present but exposes no named parameters.

No output schema declared.

No examples provided.

get_package_status ~48

GET /api/v2/package/status

Input Output Examples

Name	Type	Req	Description
dry_run	boolean	—	Показать запрос без отправки на API
issuen	string	yes	Номер выпуска / пакета

No output schema declared.

No examples provided.

get_statistics ~92

GET /api/v2/issue/statistics (Python SDK parity)

Input Output Examples

Name	Type	Req	Description
cursor_next	integer	—	Пагинация
date_from	string	yes	Дата YYYY-MM-DD
date_to	string	yes	Дата YYYY-MM-DD
dry_run	boolean	—	Показать запрос без отправки на API
limit	integer	—	Лимит объектов (default 100)

No output schema declared.

No examples provided.

get_unsubscribe_by_date ~103

GET /api/v2/blist/report/unsubscribe (Python SDK parity)

Input Output Examples

Name	Type	Req	Description
cursor_next	integer	—	Пагинация
date_from	string	yes	Дата YYYY-MM-DD
date_to	string	yes	Дата YYYY-MM-DD
dry_run	boolean	—	Показать запрос без отправки на API
limit	integer	—	Лимит объектов (default 100)
order	string	—	—

No output schema declared.

No examples provided.

get_unsubscribe_by_issue ~71

GET /api/v2/issue/report/unsubscribe (Python SDK parity)

Input Output Examples

Name	Type	Req	Description
cursor_next	integer	—	—
dry_run	boolean	—	Показать запрос без отправки на API
issuen	—	yes	—
limit	integer	—	—
order	string	—	—

No output schema declared.

No examples provided.

list_allowed_domains ~36

GET /api/v2/blist/domains

Input Output Examples

Name	Type	Req	Description
dry_run	boolean	—	Показать запрос без отправки на API

No output schema declared.

No examples provided.

list_endpoints ~43

Список методов API.

Input Output Examples

Name	Type	Req	Description
category	string	—	Фильтр по категории (частичное совпадение)
limit	integer	—	Максимум результатов

No output schema declared.

No examples provided.

remove_stop_list_email ~82

Удалить email из стоп-листа

Input Output Examples

Name	Type	Req	Description
domain	string	—	Домен отправителя (как в Python SDK: info@domain)
dry_run	boolean	—	Показать запрос без отправки на API
email	string	yes	Email в стоп-листе
mail_from	string	—	Email отправителя (mail_from)

No output schema declared.

No examples provided.

search_docs ~46

Поиск по документации API.

Input Output Examples

Name	Type	Req	Description
limit	integer	—	Максимум результатов
query	string	yes	Поисковый запрос: метод, путь, ключевое слово

No output schema declared.

No examples provided.

search_stop_list ~50

Поиск email в стоп-листах

Input Output Examples

Name	Type	Req	Description
dry_run	boolean	—	Показать запрос без отправки на API
email	string	yes	Email для поиска в стоп-листах

No output schema declared.

No examples provided.

send_email ~165

POST /api/v1/smtp_send

Input Output Examples

Name	Type	Req	Description
check_local_stop_list	boolean	—	—
dry_run	boolean	—	Показать запрос без отправки на API
email_from	string	yes	Отправитель: Имя <[email protected]>
email_to	string	yes	Email получателя
message_text	string	—	HTML-тело письма (если нет template_id)
params	object	—	Переменные для подстановки
subject	string	yes	Тема письма
template_id	integer	—	ID шаблона Mailganer
track_click	boolean	—	—
track_domain	string	—	—
track_open	boolean	—	—
x_track_id	string	—	—

No output schema declared.

No examples provided.

send_mail_v2 ~114

POST /api/v2/mail/send

Input Output Examples

Name	Type	Req	Description
dry_run	boolean	—	Показать запрос без отправки на API
email_from	string	yes	—
email_to	string	yes	—
message_text	string	—	—
params	object	—	—
subject	string	yes	—
template_id	integer	—	—
track_click	boolean	—	—
track_domain	string	—	—
track_open	boolean	—	—
x_track_id	string	—	—

No output schema declared.

No examples provided.

send_package ~173

POST /api/v1/add_json_package — массовая отправка (Python SDK parity)

Input Output Examples

Name	Type	Req	Description
check_global_stop_list	boolean	—	—
check_local_stop_list	boolean	—	—
dry_run	boolean	—	Показать запрос без отправки на API
email_from	string	yes	—
headers	object	—	—
html_prettify	boolean	—	—
is_moderate	boolean	—	—
message_text	string	yes	—
message_text_amp	string	—	—
name_from	string	yes	—
subject	string	yes	—
track_click	boolean	—	—
track_domain	string	—	—
track_open	boolean	—	—
users	array	yes	Список получателей; каждый объект должен содержать emailto

No output schema declared.

No examples provided.

send_package_xml ~57

GET /api/v1/add_package — XML-пакет по URL (Python SDK parity)

Input Output Examples

Name	Type	Req	Description
dry_run	boolean	—	Показать запрос без отправки на API
url	string	yes	URL XML-пакета

No output schema declared.

No examples provided.

stop_list_export_create ~47

POST /api/v2/stop-list/export — создать задачу экспорта (Python SDK parity)

Input Output Examples

Name	Type	Req	Description
dry_run	boolean	—	Показать запрос без отправки на API

No output schema declared.

No examples provided.

stop_list_export_delete ~51

DELETE /api/v2/stop-list/export/{token} (Python SDK parity)

Input Output Examples

Name	Type	Req	Description
dry_run	boolean	—	Показать запрос без отправки на API
token	string	yes	—

No output schema declared.

No examples provided.

On this page

Handy links

Scoring key

80+ high trust
60–79 medium
below 60 low

How we score

Score history · last 30 days

27 Jul 3 Aug