# Unione — how to use (mcp.ai)

Connect your Unione account and use 32 tools for transactional email straight from your AI agent. Connect with your own API key. UniOne is an email delivery service offering a versatile Web API and SMTP API for sending transactional and marketing emails.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_unione?ms=1787291400000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `unione_delete_event_dump`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/unione`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/unione/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/unione/delete/event/dump` — Tool to delete an event dump file and remove it from the queue or storage. Use when you need to clean up an existing event dump by its dump_id.
  - body: { dump_id: string }
- `POST https://api.mcp.ai/api/unione/delete/template` — Tool to delete a template by ID. Use when you need to permanently remove a template from the account.
  - body: { id: string }
- `POST https://api.mcp.ai/api/unione/delete/webhook` — Tool to delete a webhook event notification handler by its URL. Use when you need to stop receiving callback notifications for a specific webhook.
  - body: { url: string }
- `POST https://api.mcp.ai/api/unione/email/balance` — Tool to retrieve current account balance. Use when you need to check your email usage and limits before sending large campaigns.
- `POST https://api.mcp.ai/api/unione/email/cancel` — Tool to cancel a scheduled transactional email by its job ID. Use when you need to stop a pending email send before it's dispatched.
  - body: { job_id: string }
- `POST https://api.mcp.ai/api/unione/email/domain` — Tool to manage sender domains in UniOne. Use when you need DNS records for verification, trigger verification or DKIM checks, list domains, or delete a domain.
  - body: { limit?: integer, domain?: string, offset?: integer, operation: string }
- `POST https://api.mcp.ai/api/unione/email/event/get` — Tool to retrieve details of a specific email event by its ID. Use when you need event information for auditing or diagnostics.
  - body: { event_id: string }
- `POST https://api.mcp.ai/api/unione/email/get` — Tool to retrieve detailed information about a specific email send job. Use when you need its delivery metrics and history.
  - body: { job_id: string }
- `POST https://api.mcp.ai/api/unione/email/list` — Tool to export email events within a specified time frame. It creates an asynchronous event dump which can later be downloaded and parsed using UNIONE_EVENT_DUMP_GET.
  - body: { email?: string, limit?: integer, domain?: string, format?: string, status?: string, date_to?: string, aggregate?: string, date_from: string, delimiter?: string, from_email?: string, campaign_id?: string, dump_fields?: string[], delivery_status?: string }
- `POST https://api.mcp.ai/api/unione/email/resend` — Tool to resend a previously sent email by its job ID. Use when you need to trigger a resend of an email that has already been sent and you have the original job ID.
  - body: { job_id: string }
- `POST https://api.mcp.ai/api/unione/email/resubscribe` — Tool to resubscribe a recipient who previously unsubscribed. Use when you need to restore a user's subscription status after they opt in again.
  - body: { to_email: string, from_name: string, from_email: string }
- `POST https://api.mcp.ai/api/unione/email/resume` — Tool to resume a paused transactional email by its job ID. Use when you need to restart a paused pending email send.
  - body: { job_id: string }
- `POST https://api.mcp.ai/api/unione/email/smtp` — Tool to retrieve SMTP server details and credentials. Use when you need to configure your mail client or library for SMTP sending.
- `POST https://api.mcp.ai/api/unione/email/statistics` — Tool to retrieve email sending statistics over a specified time range. This action uses UniOne's event-dump aggregate API under the hood to compute daily statistics.
  - body: { date_to: string, date_from: string }
- `POST https://api.mcp.ai/api/unione/email/unsubscribe` — Tool to unsubscribe an email from future emails. Use when you need to stop all further transactional emails.
  - body: { cause: string, email: string, created?: string }
- `POST https://api.mcp.ai/api/unione/email/validate/batch` — Tool to validate multiple email addresses in a batch. Use when you need to verify deliverability for a list of emails at once.
  - body: { emails: string[] }
- `POST https://api.mcp.ai/api/unione/email/validate/delete` — Tool to remove an email from the suppression list. Use when you need to re-enable sending emails to an address that was previously unsubscribed or suppressed.
  - body: { email: string }
- `POST https://api.mcp.ai/api/unione/email/validate/retry` — Tool to retry an email validation request. Updated to re-run validation via the official single validation endpoint using the provided email address.
  - body: { id: string }
- `POST https://api.mcp.ai/api/unione/email/webhook/types` — Tool to retrieve supported email webhook event types. Use when configuring your webhook callbacks.
- `POST https://api.mcp.ai/api/unione/event/dump/create` — Tool to create an asynchronous CSV event dump. Use when you need to export transactional email events for a specified time window.
  - body: { limit?: integer, filter?: object, format?: string, end_time?: string, aggregate?: string, delimiter?: string, start_time: string, dump_fields?: string[], all_projects?: boolean }
- `POST https://api.mcp.ai/api/unione/event/dump/list` — Tool to retrieve the full list of event dumps. Use when you need to view all existing event-dump tasks.
- `POST https://api.mcp.ai/api/unione/get/event/dump` — Tool to retrieve the status and download URLs of an event dump. Use when you need to check if a dump is ready and get its files.
  - body: { dump_id: string }
- `POST https://api.mcp.ai/api/unione/get/suppression` — Tool to check if an email is suppressed and retrieve the reason and date. Use when verifying why an email cannot receive messages.
  - body: { email: string, all_projects?: boolean }
- `POST https://api.mcp.ai/api/unione/get/template` — Tool to get template properties by ID. Use when you need to retrieve the full template configuration and content for a specific template.
  - body: { id: string }
- `POST https://api.mcp.ai/api/unione/get/webhook` — Tool to retrieve webhook configuration by its URL. Use when you need to check the current settings of an event notification handler.
  - body: { url: string }
- `POST https://api.mcp.ai/api/unione/schedule/email` — Tool to schedule a transactional email up to 24 hours ahead. Use when you need to send an email at a specific future time.
  - body: { message: object }
- `POST https://api.mcp.ai/api/unione/suppression/list` — Tool to return the suppression list since a given date. Use when auditing bounced, unsubscribed, or blocked recipients.
  - body: { cause?: string, limit?: integer, cursor?: string, source?: string, start_time?: string }
- `POST https://api.mcp.ai/api/unione/tag/delete` — Tool to delete a specific tag. Use when you have confirmed the tag ID you wish to remove.
  - body: { tag_id: integer }
- `POST https://api.mcp.ai/api/unione/tag/list` — Tool to retrieve all user-defined tags. Use when you need to fetch the full list of tags after authentication.
- `POST https://api.mcp.ai/api/unione/template/list` — Tool to list email templates. Use when you need to retrieve available templates for transactional emails.
  - body: { limit?: integer, offset?: integer }
- `POST https://api.mcp.ai/api/unione/template/set` — Tool to set or update an email template. Use when you need to create or modify transactional email templates before sending messages.
  - body: { template: object }
- `POST https://api.mcp.ai/api/unione/webhook/set` — Tool to set or edit a webhook event notification handler. Use when you need to configure your webhook for event callbacks.
  - body: { url: string, events?: object, status?: string, event_format?: string, max_parallel?: integer, single_event?: integer, delivery_info?: integer }

## Example prompts
- "What can I do in Unione?"
- "Show me a summary of my Unione account"

## More
- Page: https://mcp.ai/unione
- Agent spec (llms.txt): https://mcp.ai/unione/llms.txt
- Postman collection: https://mcp.ai/unione/postman.json