Samotpravil MCP Server

MCP server for Samotpravil SMTP API — documentation search, typed API tools, and safety flags.

Local serverstdioPython

What is the Samotpravil MCP MCP server?

If you already use Samotpravil MCP, the samotpravil mcp mcp server is the piece that lets your assistant work with it directly. MCP server for Samotpravil SMTP API — documentation search, typed API tools, and safety flags.

What the server does

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

Installation

The server ships on npm as samotpravil-mcp, so your MCP client can launch it on demand — there is no separate build step. Add the server block to your client's configuration, restart it, and the tools register themselves.

Available tools

The toolset is worth reading before you wire it up, because it tells you what the integration is really for:

  • get_overview — Авторизация, SMTP, лимиты, категории
  • list_endpoints — Список всех методов API
  • search_docs — Поиск по документации
  • get_endpoint — Подробности по методу
  • 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 в стоп-листах
  • validate_email — POST /api/v2/emails/validate/
  • list_allowed_domains — GET /api/v2/blist/domains
  • api_request — Generic escape hatch

Credentials and setup notes

Configuration is passed through the environment: SAMOTPRAVIL_API_KEY, SAMOTPRAVIL_READ_ONLY, SAMOTPRAVIL_ALLOW_SEND, POSTMAN_API_KEY, SAMOTPRAVIL_HTTP_HOST, SAMOTPRAVIL_HTTP_AUTH_TOKEN. Treat anything key-shaped as a real credential — scope it to the minimum the server needs, and rotate it if it ever lands in a shared config.

Worth knowing first

  • It runs with your machine's permissions. That is convenient and also the reason to think about what you point it at before you approve a tool call.
  • With 14 tools registered it takes up a noticeable share of the context window; turn it off in projects that never touch Samotpravil MCP.
  • Missing credentials fail quietly in some clients — if no tools show up, check the environment block first.
  • Keep per-call confirmation enabled while you learn its behaviour; it is the cheapest safeguard you have.

Where it fits

This sits in the team communication group, where several servers overlap in what they claim to do but differ sharply once you actually set them up. Samotpravil MCP's toolset — get_overview, list_endpoints, search_docs and 11 more — is a fair guide to whether it matches your workflow. It is maintained by dkanster; worth a glance at recent repository activity before you build anything load-bearing on it.

This entry was verified against Samotpravil MCP's own documentation before publication; SyncDev keeps the directory reviewed rather than auto-generated.

Available tools

ToolWhat it does
get_overviewАвторизация, SMTP, лимиты, категории
list_endpointsСписок всех методов API
search_docsПоиск по документации
get_endpointПодробности по методу
send_emailPOST /api/v1/smtp_send
send_mail_v2POST /api/v2/mail/send
get_delivery_statusGET /api/v2/issue/status (message_id или x_track_id)
get_package_statusGET /api/v2/package/status
search_stop_listПоиск email в стоп-листах
validate_emailPOST /api/v2/emails/validate/
list_allowed_domainsGET /api/v2/blist/domains
api_requestGeneric escape hatch
postman_get_collectionКоллекция из Postman API
postman_sync_snapshotPostman API → data/collection.snapshot.json

How to install the Samotpravil MCP MCP server

**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"
      }
    }
  }
}

Configuration as documented by the project. Restart the client after saving.

Configuration

VariableDescriptionRequired
SAMOTPRAVIL_API_KEYCredential the server authenticates with.Yes
SAMOTPRAVIL_READ_ONLYConfiguration value read at startup.Optional
SAMOTPRAVIL_ALLOW_SENDConfiguration value read at startup.Optional
POSTMAN_API_KEYCredential the server authenticates with.Yes
SAMOTPRAVIL_HTTP_HOSTEndpoint or connection string the server talks to.Optional
SAMOTPRAVIL_HTTP_AUTH_TOKENCredential the server authenticates with.Yes

Example prompts to try

  • Use Samotpravil MCP to get overview.
  • Use Samotpravil MCP to list endpoints.
  • Use Samotpravil MCP to search docs.

Frequently asked questions

It connects Samotpravil MCP to MCP-compatible AI assistants such as Claude and Cursor, exposing 14 tools (get_overview, list_endpoints, search_docs, and more) that the assistant can call on your behalf. Instead of copying data back and forth by hand, the assistant works with Samotpravil MCP directly.