Reported issues for Samotpravil MCP

Pod holds 12 of 12 problems reported by people outside the maintainer team. Issues filed by the project's own owners, members and collaborators are excluded entirely — a maintainer's release checklist is not a warning to a prospective user.

Back to Samotpravil MCP.

Most discussed

[Org migration] Pre-flight complete — awaiting GitHub org

Фаза

Подготовка (pre-flight)

Статус

Репозиторий готов к transfer в org samotpravil (dry-run проверен).

npm run org-migration-preflight
# 161 replacements in 18 files (dry-run)

Чеклист

npm run org-migration-preflight — green
apply-org-migration dry-run
scaffolds for upstream wishlist
GitHub org создан
Repo transferred → samotpravil/samotpravil-mcp
apply-org-migration --write
npm publish @samotpravil/mcp

Runbook: docs/ORG_MIGRATI

Read the thread · 2026-07-13 · open · outside contributor · 0 comments

[Docs promo] v1.7.0 MCP block для documentation.samotpravil.ru

Фаза

Публикация на documentation.samotpravil.ru

Контекст

Release samotpravil-mcp@1.7.0 опубликован на npm и MCP Registry.

58 MCP tools, 9 resources, 5 prompts
npm: https://www.npmjs.com/package/samotpravil-mcp/v/1.7.0
Release: https://github.com/dkanster/samotpravil-mcp/releases/tag/v1.7.0

Задачи

Вставить HTML-блок из MCP_INSTALL_BLOCK.html в Postman collection «СамОтправил

Read the thread · 2026-07-13 · open · outside contributor · 0 comments

[API P4] DX: /me, health, live OpenAPI, rate limits

Родительский Epic: #26

Требуемые эндпоинты

Метод	Путь	Назначение
GET	/api/v2/me	Проверка ключа, account, plan, blist_id
GET	/api/v2/health	Healthcheck
GET	/api/v2/openapi.json	Живая OpenAPI
GET	/api/v2/events	Единый лог по x_track_id

Заголовки на всех методах

X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset

См. [API_WISHLIST §4](https://github.com/dkanster/samotpravil-mcp/blob/main/docs/API_WISHLIST.m

Read the thread · 2026-07-12 · open · outside contributor · 0 comments

[API P3] API кампаний: планирование и отмена

Родительский Epic: #26

Проблема

Нет API для отложенной отправки. Есть только issuen и статус пакета.

Требуемые эндпоинты

POST /api/v2/campaigns
GET /api/v2/campaigns/{id}
POST /api/v2/campaigns/{id}/schedule (ISO 8601 datetime)
POST /api/v2/campaigns/{id}/cancel

Read the thread · 2026-07-12 · open · outside contributor · 0 comments

[API P3] Bulk status, квоты, вложения, отписка

Родительский Epic: #26

Требуемые эндпоинты

Bulk и квоты:

POST /api/v2/issue/status/bulk
POST /api/v2/stop-list/add/bulk
GET /api/v2/quota

Вложения:

POST /api/v2/attachments
GET /api/v2/attachments/{id}

Unsubscribe (GDPR):

POST /api/v2/unsubscribe
GET /api/v2/unsubscribe/settings

API keys:

GET/POST /api/v2/api-keys
DELETE /api/v2/api-keys/{id} (scopes: send/read/admin)

См. [API_WISHLIST §3.2–3.5](https://github.com/dkanster/samotpravil-m

Read the thread · 2026-07-12 · open · outside contributor · 0 comments

[API P3] CRUD списков подписчиков и сегментов

Родительский Epic: #26

Проблема

Получатели передаются inline в каждом пакете. Нет API для аудитории.

Требуемые эндпоинты

GET/POST /api/v2/lists
GET/PATCH/DELETE /api/v2/lists/{id}
POST /api/v2/lists/{id}/subscribers — bulk-импорт
GET/DELETE /api/v2/lists/{id}/subscribers/{email}
POST /api/v2/lists/{id}/segments

Критерии приёмки

Связь списка с send_package (list_id вместо inline users[])
MCP prompt: импорт → валидация → отправка

Read the thread · 2026-07-12 · open · outside contributor · 0 comments

[API P3] CRUD шаблонов писем

Родительский Epic: #26

Проблема

В smtp_send есть template_id (Mailganer), HTTP CRUD шаблонов не описан.

Требуемые эндпоинты

GET/POST /api/v2/templates
GET/PATCH/DELETE /api/v2/templates/{id}
POST /api/v2/templates/{id}/preview

См. API_WISHLIST §3.1

Read the thread · 2026-07-12 · open · outside contributor · 0 comments

[API P2] Стабилизировать tickets + email intelligence

Родительский Epic: #26

Методы (доработать контракт + включить в SDK)

GET/POST /api/v2/tickets, GET/POST /api/v2/tickets/{id}/
POST /api/v2/emails/validate/, clean/, activity/
POST /api/v2/email/check

Критерии приёмки

Единый формат ответа { valid, reason, suggestions }
Все методы в Python SDK
MCP typed tools (не только auto)

См. API_WISHLIST §2.1–2.2

Read the thread · 2026-07-12 · open · outside contributor · 0 comments

Most recent

[MCP] Синхронизация samotpravil-mcp после релизов API

Родительский Epic: #26

Чеклист после каждого релиза API

Опубликовано в Postman documenter
npm run sync-docs → обновлён snapshot
Typed tools для частых методов (не только auto)
Python SDK обновлён на PyPI
MCP Prompts: bulk campaign, webhook setup, template workflow
CHANGELOG + примеры в docs/EXAMPLES.md

Текущие пробелы MCP

emails/clean, activity, email/check — auto-only
tickets — auto-only
v1 legacy reports — auto-only
Нет prompt для bulk camp

Read the thread · 2026-07-12 · open · outside contributor · 0 comments

[API P2] Webhooks management API

Родительский Epic: #26

Проблема

Webhook настраивается только через blist/create и blist/update.

Требуемые эндпоинты

GET/POST /api/v2/webhooks
GET/PATCH/DELETE /api/v2/webhooks/{id}
POST /api/v2/webhooks/{id}/test

События

delivered, bounced, complained, unsubscribed · HMAC-SHA256

См. API_WISHLIST §2.3

Read the thread · 2026-07-12 · open · outside contributor · 0 comments

[API P1] Стабилизировать v2 отправку и пакетные рассылки

Родительский Epic: #26

Проблема

POST /api/v2/mail/send помечен deprecated
Пакеты только в v1: add_json_package, GET add_package, package_stop

Требуемые эндпоинты

POST /api/v2/mail/send — единичная отправка (паритет v1)
POST /api/v2/mail/package — JSON-пакет
POST /api/v2/mail/package/xml — пакет по URL
POST /api/v2/mail/package/{id}/stop — остановка
GET /api/v2/mail/package/{id} — статус + метаданные

Критерии приёмки

Снят deprecated с v2 send
[

Read the thread · 2026-07-12 · open · outside contributor · 0 comments

[API Epic] Развитие HTTP API СамОтправил для интеграторов рассыльщиков и MCP

Контекст

Разработчики, встраивающие рассыльщик в свои продукты (SaaS, CRM, маркетплейсы), используют HTTP API api.samotpravil.ru и MCP samotpravil-mcp.

Текущее покрытие (~51 HTTP-метод): единичная и пакетная отправка, статусы, аналитика, стоп-листы, домены, валидация, WhiteLabel-конфиг.

Главная проблема: v1 и v2 сосуществуют без единого стабильного контракта. Отсутствуют сущности, критичные для продуктовых рассыльщиков: списки подписчиков, шаблоны, webhooks, планирование, квоты

Read the thread · 2026-07-12 · open · outside contributor · 0 comments

The remaining reports are on the project's issue tracker.