# 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](/mcp/samotpravil-mcp).

## Most discussed

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

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

## Статус
Репозиторий готов к transfer в org `samotpravil` (dry-run проверен).

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

## Чеклист
- [x] npm run org-migration-preflight — green
- [x] apply-org-migration dry-run
- [x] 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](https://github.com/dkanster/samotpravil-api-mcp/issues/65) · 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](https://github.com/dkanster/samotpravil-mcp/blob/main/docs/official/MCP_INSTALL_BLOCK.html) в Postman collection «СамОтправил 

[Read the thread](https://github.com/dkanster/samotpravil-api-mcp/issues/51) · 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](https://github.com/dkanster/samotpravil-api-mcp/issues/35) · 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](https://github.com/dkanster/samotpravil-api-mcp/issues/34) · 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](https://github.com/dkanster/samotpravil-api-mcp/issues/33) · 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](https://github.com/dkanster/samotpravil-api-mcp/issues/32) · 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](https://github.com/dkanster/samotpravil-mcp/blob/main/docs/API_WISHLIST.md#31-шаблоны-писем)

[Read the thread](https://github.com/dkanster/samotpravil-api-mcp/issues/31) · 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](https://github.com/dkanster/samotpravil-mcp/blob/main/docs/API_WISHLIST.md#21-tickets-api)

[Read the thread](https://github.com/dkanster/samotpravil-api-mcp/issues/30) · 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](https://github.com/dkanster/samotpravil-api-mcp/issues/36) · 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](https://github.com/dkanster/samotpravil-mcp/blob/main/docs/API_WISHLIST.md#23-webhook-management)

[Read the thread](https://github.com/dkanster/samotpravil-api-mcp/issues/29) · 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](https://github.com/dkanster/samotpravil-api-mcp/issues/27) · 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](https://github.com/dkanster/samotpravil-api-mcp/issues/26) · 2026-07-12 · open · outside contributor · 0 comments

The remaining reports are on [the project's issue tracker](https://github.com/dkanster/samotpravil-mcp/issues).