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`)