UniOne and Unisender Go MCP server

mcp-unione

An MCP server for UniOne and Unisender Go transactional email, with a send guard against accidental sends and an offline API knowledge base

  • 0 ★ on the repository
  • Last commit
  • MIT
MCP server

Extended access

Why this level

  • Can send real mail to recipients, but only after explicit confirm_send=true
  • Can delete templates, webhooks, domains and suppression list entries
All reasons and checks
Russian stack

karimou5/mcp-unione

Install

Services

Manual install

uv sync && uv run mcp-unione

Installs and runs the server over stdio from source.

Access and checks

How we review

Extended accessThe tool runs code or makes network calls and only reads external data.

  • Can send real mail to recipients, but only after explicit confirm_send=true
  • Can delete templates, webhooks, domains and suppression list entries

This is third-party code. Review the repository files before installing.

What it does

The server wraps UniOne's transactional web API (also known as Unisender Go) with 32 typed tools across ten areas: sending mail and subscription requests, address validation, templates, webhooks, suppression lists, domain and DKIM verification, event dumps, tags and projects. It also has four documentation tools: full-text search over a bundled knowledge base of about 4000 lines of docs, fetching a live docs page, explaining a UniOne error code with its cause and fix, and explaining a delivery status. Its main safeguard: unione_send_email does not send by default, returning a preview of recipients, subject and engine instead; a real send requires the explicit confirm_send=true parameter, and sandbox=true routes the message through a test domain with no real delivery.

Who it is for. For developers setting up transactional email through UniOne or Unisender Go who want to do it safely through an agent.

Good fit when

  • You want to assemble and preview an email before sending it with no risk of a real send
  • You need to understand why a message did not arrive by its error code or delivery status
  • You want to set up a domain, DKIM, webhooks or templates without reading UniOne's full documentation

Not a fit when

  • You do not have a UniOne API key, though the docs and knowledge-base tools work even without one
  • You need bulk marketing mail to large lists: the service and server are focused on transactional email

Example request

Compose a transactional order-confirmation email via UniOne and show me a preview before sending

MCP

Transport
stdio
Authentication
key is optional

Environment variables

UNIONE_API_KEY secret
UniOne API key, needed only for real calls; documentation tools work without it.
UNIONE_REGION
API region: eu, us or global, defaults to eu.

Limitations

The project has a single author but solid engineering: semver releases, an image published to the GitHub Container Registry, and 67 tests with mocked HTTP requests. Sending without skip_unsubscribe adds an unsubscribe footer that Gmail sometimes reads as marketing and files under Promotions. The skip_unsubscribe option must first be enabled on the UniOne account itself.

How to disable. Remove the unione entry from your MCP client config or stop the Docker container.

FAQ

Can the agent accidentally send an email?

No, unione_send_email without confirm_send=true only shows a preview and sends nothing, a deliberate guard against accidental sends.

Do the tools work without an API key?

Yes, knowledge-base search, docs reading and error lookups work without a key; it is only needed for real API calls.

Discussion

No questions or reviews yet.

Russian stack

A monorepo of MCP servers for Russian and CIS APIs: payments, CRM, marketplaces, delivery, HR and reference data

MCP serverBroad access38Repository stars
Official

Official Mailtrap MCP server: send email, test in the sandbox, read delivery logs, manage templates, contacts and domains

MCP serverBroad access66Repository stars
Official

The official Postmark MCP server: 24 tools to send email, manage templates, search messages and diagnose delivery.

MCP serverBroad access64Repository stars

Open Agent Email — a self-hosted mail server for AI agents: inboxes, in-thread replies, human approval, webhooks and an MCP endpoint with 96 tools

MCP serverBroad access2.1KRepository stars
Official

Resend's official MCP server: send and read email, manage contacts, broadcasts, domains and webhooks from your agent

MCP serverBroad access580Repository stars
Official

The Atomic Mail MCP server: an agent creates its own atomicmail.ai inbox and works with mail through JMAP with no human involved.

MCP serverBroad access256Repository stars

README in short

The English README describes a quick start via uv and Docker, environment variable configuration with API regions, the send guard safeguard with a detailed explanation of the unsubscribe footer and its effect on Promotions placement, tables of 32 tools across ten domains, 20 knowledge-base resources and two guided prompts, and an automated release process.

README badge

Report a problem