Samotpravil MCP

io.github.dkansterPublished by GitHub account dkansterv1.8.0Updated Oct 24, 2026

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

VerifiedSTDIODesktop onlyKnowledge & Memory Developer Tools Communication & Collaboration

Server details

Identifier: io.github.dkanster/samotpravil-mcp
Transport: STDIO
Runtime: Desktop only
Trust: Verified
Published: Sep 16, 2026

Security note

MCP servers receive tool arguments from a conversation and may perform external actions. Review what a server can do before you enable it, and give it only the access it needs.

The registry verified the GitHub account dkanster for this listing. That does not show the account is the product's maker.

SourceWeft's checks cover whether the listing is complete and the endpoint answered; they do not review the server's code or what its tools do.

Add a badge to your README

Show readers this MCP server is listed on SourceWeft. The badge links to this page.

[![Listed on SourceWeft](https://sourceweft.com/badge/mcp/io.github.dkanster%2Fsamotpravil-mcp.svg)](https://sourceweft.com/mcp/io.github.dkanster%2Fsamotpravil-mcp?utm_source=readme&utm_medium=badge)

Overview

AI-generated overview

Local MCP server for the Samotpravil email API: lets an assistant read the API docs, send email and packages, and manage stop lists and domains.

What you can do: Search and read Samotpravil API documentation: overview, endpoint list, endpoint details, doc search, plus resources and prompts for integration, sending and delivery checks, without an API key. Send transactional email and packages, and check delivery or package status by message ID or track ID. Manage stop lists and allowed domains: search, add and remove addresses, validate emails, list allowed domains. Run Python SDK parity tools such as statistics, external status, stop-list export, domain add and authkey creation. Call any other API method through a generic request tool or auto-generated per-endpoint tools. Maintain the Postman collection: fetch it, sync a local snapshot, diff it and,
When to use it: Use it when you work with the Samotpravil email delivery service and want an assistant to look up its API, send transactional mail or packages, or manage stop lists and sender domains from the chat. The docs-only tools are useful even without an API key.
Requirements: Runs locally via npx (Node.js) or Docker; stdio by default, optional HTTP transport with host, port and bearer token settings. A Samotpravil account and API key in SAMOTPRAVIL_API_KEY are needed for API tools; there is no free test key, and sender domain verification is required. POSTMAN_API_KEY is only for the Postman maintainer tools. Network access to the Samotpravil API and documentation is required.

Before you install

Sending email and packages is a real, billable action: batch production sending is off by default (SAMOTPRAVIL_ALLOW_SEND=0), and READ_ONLY, ALLOW_MUTATIONS and ALLOW_GENERIC_API flags restrict writes. Stop-list, domain and authkey tools change account data. Secrets are passed by environment variable (SAMOTPRAVIL_API_KEY, POSTMAN_API_KEY, SAMOTPRAVIL_HTTP_AUTH_TOKEN); the README says secrets are masked in responses, but review before exposing the HTTP transport beyond localhost.

Installation

In SourceWeft

Open Samotpravil MCP in the dashboard and add it to a workspace.
Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

Samotpravil MCP

[CI] [npm] [License: MIT]

MCP-сервер вокруг документации API СамОтправил и HTTP API api.samotpravil.ru.

Версия: 1.8.0 · npm: samotpravil-mcp · MCP Registry: io.github.dkanster/samotpravil-api-mcp · Smithery: smithery.yaml · Cursor Directory: .mcp.json

Хостинг: репозиторий временно в dkanster/samotpravil-api-mcp.
Планируется: переезд в org Samotpravil → @samotpravil/mcp — docs/ORG_MIGRATION.md.

Сервер подтягивает Postman-коллекцию с documenter (live + offline snapshot) и даёт агенту tools для поиска методов, вызова API и безопасных пресетов (READ_ONLY, dry_run). Имена typed tools совпадают с Python SDK samotpravil.

Экосистема: Postman → snapshot → MCP / OpenAPI / Docusaurus — docs/ECOSYSTEM.md · live preview: https://dkanster.github.io/samotpravil-api-mcp/

Быстрый старт

Cursor — .cursor/mcp.json:

json

{  "mcpServers": {    "samotpravil": {      "command": "npx",      "args": ["-y", "samotpravil-mcp@latest"],      "env": {        "SAMOTPRAVIL_API_KEY": "your_api_key_here",        "SAMOTPRAVIL_READ_ONLY": "1",        "SAMOTPRAVIL_ALLOW_SEND": "0"      }    }  }}

{  "mcpServers": {    "samotpravil": {      "command": "npx",      "args": ["-y", "samotpravil-mcp@latest"],      "env": {        "SAMOTPRAVIL_API_KEY": "your_api_key_here",        "SAMOTPRAVIL_READ_ONLY": "1",        "SAMOTPRAVIL_ALLOW_SEND": "0"      }    }  }}

SAMOTPRAVIL_API_KEY опционален для docs-only tools. После правок: Settings → MCP → Reload.

Бесплатного тестового ключа нет: регистрация в ЛК → верификация домена отправителя → ключ в env. Пакетную боевую отправку по умолчанию не открываем (SAMOTPRAVIL_ALLOW_SEND=0).

Экосистема (рядом с MCP)

Артефакт	Ссылка
Спека OpenAPI	https://spec.samotpravil.ru/openapi.yaml
Node-клиент API	`npm i samotpravil`
Пример SaaS (два ключа TX/MKT)	dkanster/samotpravil-example
Python MCP (pip)	`mailganer-samotpravil-mcp`
Smithery	daniil-kozemiakin/samotpravil
Cursor Directory	samotpravil-api-mcp

Для SaaS сразу два API-ключа (разные стоп-листы и webhook URL) — см. пример выше.

Сценарии и конфиги для Claude / VS Code: docs/EXAMPLES.md

Cursor Directory

Каталог сообщества cursor.directory автодетектит MCP из корневого .mcp.json (дубль: mcp.json, манифест plugin.json). Первая отправка: cursor.directory/plugins/new → URL этого репозитория (вход GitHub/Google). В листинг не входят swagger-mcp и Postman maintainer.

Дальше править код и карточку — docs/PUBLISH.md § «Cursor Directory»: релиз npm по tag v*; карточку Directory не слать второй раз (дубли). Add to Cursor у уже поставивших сам не обновляется.

Что внутри

Компонент	Кол-во	Нужен ключ
Docs tools	4	нет
Core typed API	9 + `api_request`	`SAMOTPRAVIL_API_KEY`
Python SDK parity	28	`SAMOTPRAVIL_API_KEY`
Auto tools (`api_*`)	~16	`SAMOTPRAVIL_API_KEY`
Postman maintainer	4	`POSTMAN_API_KEY`
MCP Resources	9	нет
MCP Prompts	5	нет

Итого: ~59 tools ( +4 postman при POSTMAN_API_KEY).

Инструменты

Документация (без API-ключа)

Tool	Описание
`get_overview`	Авторизация, SMTP, лимиты, категории
`list_endpoints`	Список всех методов API
`search_docs`	Поиск по документации
`get_endpoint`	Подробности по методу

Typed API (нужен `SAMOTPRAVIL_API_KEY`)

Tool	Описание
`send_email`	POST `/api/v1/smtp_send`
`send_mail_v2`	POST `/api/v2/mail/send`
`get_delivery_status`	GET `/api/v2/issue/status` (`message_id` или `x_track_id`)
`get_package_status`	GET `/api/v2/package/status`
`search_stop_list`	Поиск email в стоп-листах
`add_stop_list_email` / `remove_stop_list_email`	Стоп-лист (`mail_from` или `domain`)
`validate_email`	POST `/api/v2/emails/validate/`
`list_allowed_domains`	GET `/api/v2/blist/domains`
`api_request`	Generic escape hatch

Python SDK parity (v1.3+)

Typed tools с именами как в PyPI-пакете samotpravil: send_package, get_statistics, get_ext_status, stop_list_export_create, domain_add, get_blist, create_authkey и др.

Полный список и маппинг: docs/EXAMPLES.md#python-sdk-parity · prompt python_sdk_parity

Postman maintainer (нужен `POSTMAN_API_KEY`)

Tool	Описание
`postman_get_collection`	Коллекция из Postman API
`postman_sync_snapshot`	Postman API → `data/collection.snapshot.json`
`postman_diff_snapshot`	Diff Postman vs локальный snapshot
`postman_search_requests`	Поиск запросов в коллекции

Подробнее: docs/EXAMPLES.md#postman-tools

Auto tools

api_{method}_{path} — для HTTP-методов, не покрытых typed tools (legacy v1, tickets, email check/clean и т.д.).

MCP Prompts

Prompt	Описание
`integration_overview`	Обзор SMTP + HTTP + лимиты
`send_transactional`	Чеклист отправки письма
`stop_list_workflow`	Работа со стоп-листами
`check_delivery`	Статус по X-Track-ID / выпуску
`python_sdk_parity`	Python SDK → MCP tools

MCP Resources

URI	Содержимое
`samotpravil://overview`	Обзор API
`samotpravil://endpoints`	Индекс методов
`samotpravil://endpoint/{slug}`	Один метод
`samotpravil://errors`	Популярные ошибки
`samotpravil://integration`	SMTP, X-Track-ID, трекинг
`samotpravil://sdk-mapping`	Python SDK → MCP tools
`samotpravil://changelog`	Фрагмент CHANGELOG пакета
`samotpravil://rate-limits`	Лимиты API и отправки
`samotpravil://api-wishlist`	Предложения по HTTP API (фрагмент)

Безопасность

Env	Эффект
`SAMOTPRAVIL_READ_ONLY=1`	Только GET/HEAD
`SAMOTPRAVIL_ALLOW_SEND=0`	Блок send/package
`SAMOTPRAVIL_ALLOW_MUTATIONS=0`	Блок stop-list, доменов, authkey
`SAMOTPRAVIL_ALLOW_GENERIC_API=0`	Отключить `api_request`
`SAMOTPRAVIL_DOCS_MODE`	`auto` \| `live` \| `snapshot`
`dry_run: true`	Preview запроса без отправки

Секреты (api_key, key= в query) маскируются в ответах MCP.

Транспорты и интеграции

HTTP transport

Env: SAMOTPRAVIL_HTTP_HOST, SAMOTPRAVIL_HTTP_PORT, SAMOTPRAVIL_HTTP_AUTH_TOKEN, SAMOTPRAVIL_HTTP_JSON_LOG=1 (structured logs).

bash

docker build -t samotpravil-mcp .docker run --rm -p 3000:3000 -e SAMOTPRAVIL_API_KEY=... -e SAMOTPRAVIL_HTTP_AUTH_TOKEN=... samotpravil-mcp

docker build -t samotpravil-mcp .docker run --rm -p 3000:3000 -e SAMOTPRAVIL_API_KEY=... -e SAMOTPRAVIL_HTTP_AUTH_TOKEN=... samotpravil-mcp

OpenAPI + Swagger-MCP

bash

npm run export-openapi        # → data/openapi.yamlnpm run upload-swaggerhub     # SwaggerHub (нужен .env.swaggerhub)npm run prepare-swagger-mcp   # Vizioz/Swagger-MCP

npm run export-openapi        # → data/openapi.yamlnpm run upload-swaggerhub     # SwaggerHub (нужен .env.swaggerhub)npm run prepare-swagger-mcp   # Vizioz/Swagger-MCP

Спека: mailganer/[email protected] · docs/SWAGGERHUB.md

Docusaurus preview

Live: https://dkanster.github.io/samotpravil-api-mcp/ · docs/DOCS_SITE.md

Discovery

Площадка	Ссылка
npm	https://www.npmjs.com/package/samotpravil-mcp
MCP Registry	https://registry.modelcontextprotocol.io
Smithery	`smithery.yaml` в корне — docs/PUBLISH.md
Официальный promo	docs/official/

Конфигурация

Шаблон: .env.samotpravil.example

env

SAMOTPRAVIL_API_KEY=your_key_here# POSTMAN_API_KEY=...          # maintainer tools# SAMOTPRAVIL_READ_ONLY=1

SAMOTPRAVIL_API_KEY=your_key_here# POSTMAN_API_KEY=...          # maintainer tools# SAMOTPRAVIL_READ_ONLY=1

Ключ API: https://samotpravil.ru/get-access

Полный список env: docs/EXAMPLES.md

Разработка

bash

git clone https://github.com/dkanster/samotpravil-api-mcp.gitcd samotpravil-api-mcpnpm install && npm test && npm run devnpm run setup-hooks   # optional: pre-commit (lint + test)npm run lint          # ESLintnpm run pre-publish-check   # перед npm tagnpm run release-prepare      # pre-flight перед npm tagnpm run generate-tool-catalognpm run scaffold-typed-tool send_package

git clone https://github.com/dkanster/samotpravil-api-mcp.gitcd samotpravil-api-mcpnpm install && npm test && npm run devnpm run setup-hooks   # optional: pre-commit (lint + test)npm run lint          # ESLintnpm run pre-publish-check   # перед npm tagnpm run release-prepare      # pre-flight перед npm tagnpm run generate-tool-catalognpm run scaffold-typed-tool send_package

Security: SECURITY.md
Contributing: CONTRIBUTING.md
Changelog: CHANGELOG.md
Publish: docs/PUBLISH.md
Roadmap: docs/ROADMAP_v1.6.md · Release: docs/RELEASE_v1.7.0.md
Org migration: docs/ORG_MIGRATION_RUNBOOK.md · npm run plan-org-migration
API v1→v2: docs/MIGRATION_V1_TO_V2.md
API wishlist (предложения для HTTP API продукта): docs/API_WISHLIST.md

Источник документации

Live: https://documentation.samotpravil.ru/
Offline: data/collection.snapshot.json
Обновить: npm run sync-docs или postman_sync_snapshot
API: https://api.samotpravil.ru · SMTP: api.samotpravil.ru:1126 / :1127

Из git clone в свой проект

Лицензия

MIT

Source: README.md at commit d55b156

Tools

SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

v1.8.0LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

Reached in the last 30 days25 pts
Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.
Auth declared10 pts
Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.
Tools listed15 pts
Answer tools/list without a credential, or ship a package that starts in a sandbox without one.
DescriptionRequired15 pts
Logo10 pts
Documentation15 pts
License10 pts

Samotpravil MCP

Overview

Installation

In SourceWeft

Other MCP clients

README

Samotpravil MCP

Быстрый старт

Экосистема (рядом с MCP)

Cursor Directory

Что внутри

Инструменты

Документация (без API-ключа)

Typed API (нужен SAMOTPRAVIL_API_KEY)

Python SDK parity (v1.3+)

Postman maintainer (нужен POSTMAN_API_KEY)

Auto tools

MCP Prompts

MCP Resources

Безопасность

Транспорты и интеграции

HTTP transport

OpenAPI + Swagger-MCP

Docusaurus preview

Discovery

Конфигурация

Разработка

Источник документации

Из git clone в свой проект

Лицензия

Tools

Version history

Score

Typed API (нужен `SAMOTPRAVIL_API_KEY`)

Postman maintainer (нужен `POSTMAN_API_KEY`)