Samotpravil MCP

io.github.dkanster由 GitHub 账号 dkanster 发布v1.8.0更新于 Oct 24, 2026

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

已验证STDIO仅桌面知识与记忆开发者工具沟通与协作

服务详情

标识符: io.github.dkanster/samotpravil-mcp
传输: STDIO
运行时: Desktop only
信任: Verified
发布于: Sep 16, 2026

安全提示

MCP 服务会接收对话中的工具调用请求，并可能执行外部操作。启用前请先了解该服务能做什么，并只授予它所需的权限。

注册中心已验证此条目所属的 GitHub 账号 dkanster。这并不表明该账号就是产品方。

SourceWeft 的检查只涵盖条目是否完整、端点是否响应；不审查服务器的代码，也不审查其工具的行为。

在 README 中添加徽章

向读者展示该 MCP 服务已收录于 SourceWeft，徽章链接到本页。

[![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)

概览

AI 生成的概览

面向 Samotpravil 邮件 API 的本地 MCP 服务器，让助手查阅 API 文档、发送邮件与群发包，并管理退订名单和域名。

可以做什么: 检索和阅读 Samotpravil API 文档：概览、接口列表、接口详情、文档搜索，并提供集成、发送和投递查询相关的资源与提示词，无需 API 密钥。发送事务邮件和群发包，并按 message_id 或 x_track_id 查询投递或群发状态。管理退订名单与允许域名：搜索、添加、移除地址，校验邮箱，列出允许域名。提供与 Python SDK 对齐的工具，如统计、外部状态、退订名单导出、添加域名和创建 authkey。通过通用请求工具或按接口自动生成的工具调用其他 API 方法。维护 Postman 集合：获取、同步本地快照、比对差异和搜索请求。
适用场景: 当你使用 Samotpravil 邮件投递服务，希望助手在对话中查阅其 API、发送事务邮件或群发包、管理退订名单和发件域名时使用。仅文档类工具即使没有 API 密钥也可用。
运行要求: 通过 npx（Node.js）或 Docker 在本机运行；默认 stdio，可选 HTTP 传输并配置主机、端口和 Bearer 令牌。API 工具需要 Samotpravil 账号及 SAMOTPRAVIL_API_KEY 中的 API 密钥；没有免费测试密钥，且需完成发件域名验证。POSTMAN_API_KEY 仅用于 Postman 维护工具。需要访问 Samotpravil API 和文档的网络连接。

安装前请注意

发送邮件和群发包是真实且可能计费的操作：批量正式发送默认关闭（SAMOTPRAVIL_ALLOW_SEND=0），READ_ONLY、ALLOW_MUTATIONS 和 ALLOW_GENERIC_API 可限制写操作。退订名单、域名和 authkey 工具会修改账号数据。密钥通过环境变量传入（SAMOTPRAVIL_API_KEY、POSTMAN_API_KEY、SAMOTPRAVIL_HTTP_AUTH_TOKEN）；README 称响应中会遮蔽密钥，但将 HTTP 传输暴露到本机之外前请先评估。

安装

在 SourceWeft 中

打开控制台中的 Samotpravil MCP，将其添加到工作区。
为需要使用其工具的对话启用该服务。

Desktop only，通过 STDIO。 STDIO 服务会启动本地进程，因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照仓库中的启动说明。

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

来源：README.md，提交 d55b156

工具

SourceWeft 尚未在沙箱中启动过该软件包，因此其工具未知。

版本历史

v1.8.0最新Sep 16, 2026

评分

已满足适用检查项的 50%

该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。

近 30 天内可连通25 分
请保持端点能够响应 MCP 握手；SourceWeft 每 30 天探测一次。
已声明认证方式10 分
请在注册中心条目中声明凭据请求头，或保持端点能够响应探测，以便判定其认证方式。
已列出工具15 分
请让服务器在无凭据时响应 tools/list，或发布可在沙箱中无凭据启动的软件包。
描述必需15 分
图标10 分
文档15 分
许可证10 分

Samotpravil MCP

概览

安装

在 SourceWeft 中

其他 MCP 客户端

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 в свой проект

Лицензия

工具

版本历史

评分

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

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