Unione MCP server

Connect Unione to Claude, ChatGPT, Cursor, Claude Code, Codex, Gemini, GitHub Copilot and any other MCP client, for your whole team. Metorial adds security, governance, and tracing, and gives everyone one Magic MCP URL to connect.

What you can do with the Unione MCP server

Ask your agent in plain language. Each of these maps to a real tool on the server.

  • Use the get template tool in Unione
  • Use the delete suppression tool in Unione
  • Use the get suppression tool in Unione
  • Use the list event dumps tool in Unione
  • Use the delete tag tool in Unione
  • Use the send email tool in Unione

Supported Tools

get_template

Get Template

Retrieve a single email template by its ID. Returns the full template configuration including body, subject, sender info, and all settings.

delete_suppression

Delete Suppression

Remove an email address from the suppression list, allowing it to receive emails again. Only user-deletable suppressions can be removed.

get_suppression

Get Suppression

Check suppression status of a specific email address. Returns all suppression records for the address including cause, source, and whether the suppression can be removed.

list_event_dumps

List Event Dumps

List all existing event dump requests with their statuses and download URLs.

delete_tag

Delete Tag

Delete a user-defined email tag. This removes the tag from the system but does not affect previously sent emails that used this tag.

send_email

Send Email

Send transactional or marketing emails to one or more recipients. Supports HTML, plaintext, and AMP email bodies with per-recipient personalization through substitutions/merge tags. Can reference a stored template by ID, include attachments, schedule delivery up to 24 hours ahead, and track opens/clicks.

delete_template

Delete Template

Delete an email template by its ID. This action is permanent and cannot be undone.

delete_project

Delete Project

Delete a project and its associated data. UniOne moves the project to its trash before permanent deletion; contact support for restoration. Requires a user-level API key. Call list_projects to discover project IDs.

delete_domain

Delete Domain

Remove a sender domain from the account. This is permanent and the domain will no longer be usable for sending.

get_system_info

Get System Info

Retrieve account or project information including user ID, email, accounting period details, and email counters. Useful for checking account status and usage.

get_domain_dns_records

Get Domain DNS Records

Register a sender domain and generate its verification TXT value and raw DKIM public key, or retrieve the existing values if the domain is already registered. Use this as the first step when setting up a sender domain.

create_project

Create Project

Create a new project to isolate domains, templates, webhooks, suppression lists, and sending data. Each project gets its own API key. Requires a user-level API key.

list_templates

List Templates

List all email templates in the account or project. Returns template metadata including name, subject, sender, and creation date. Supports pagination via limit and offset.

validate_domain

Validate Domain

Trigger validation of a sender domain's DNS records. Validates the verification TXT record and/or DKIM record. Use after adding the required DNS records to your domain's DNS configuration.

list_projects

List Projects

List all projects in the account. Requires a user-level API key.

validate_email

Validate Email

Validate a single email address to determine if it is valid, invalid, suspicious, or unknown. Returns a validity score (0-100), the cause of any issues (e.g., disposable, spamtrap, mailbox not found), and a suggested correction for typos. Best used for real-time form validation, not bulk validation.

list_domains

List Domains

List registered sender domains with their verification and DKIM status. Use limit and offset to paginate, or domain to check one sender domain.

delete_event_dump

Delete Event Dump

Delete an event dump by dumpReference from create_event_dump or list_event_dumps, or by a legacy numeric dumpId.

update_project

Update Project

Update an existing project's settings. Requires a user-level API key.

list_suppressions

List Suppressions

List suppressed email addresses with optional filtering by cause, source, and date. Returns suppression records with cursor-based pagination.

resubscribe_email

Resubscribe Email

Send a re-subscribe email to a recipient who previously unsubscribed or was blocked due to complaints. The recipient will receive an email with a link to restore their subscription.

create_event_dump

Create Event Dump

Request a historical event data export for a given time period. The dump is generated asynchronously; use **Get Event Dump** to check its status and retrieve the download URL. Events can be filtered by job ID, status, recipient, sender, domain, or campaign.

add_suppression

Add Suppression

Add an email address to the suppression list to block it from receiving emails. Specify the cause of suppression (e.g., unsubscribed, complained).

list_tags

List Tags

List all user-defined tags used to categorize outgoing emails. Tags are assigned when sending emails (up to 4 per email) and can be used to filter and analyze delivery statistics.

upsert_template

Create or Update Template

Create a new email template or update an existing one. Templates store reusable email content including body, subject, sender info, and attachments. When sending emails, reference a template by ID to pre-fill fields. To update an existing template, provide its **templateId**. Omitted name and sender values are retrieved from that template. To create a new template, omit templateId and provide name and fromEmail.

get_event_dump

Get Event Dump

Check an event dump and download available CSV files, including files completed while the export is still processing. Use dumpReference returned by create_event_dump or list_event_dumps.

list_confirmed_emails

List Confirmed Emails

List confirmed and unconfirmed email addresses registered for sandbox-domain sending.

delete_confirmed_email

Delete Confirmed Email

Remove an email address from the sandbox-domain confirmed email list. This may prevent future sandbox messages involving that address.

create_confirmed_email

Confirm Email for Sandbox Sending

Register an email address for sandbox-domain sending and request a confirmation link. Use list_confirmed_emails to check its confirmation status.

Connect Unione to your AI client

Every client uses the same Magic MCP URL, and so does any other MCP client. Add it once and sign in with SSO.

  1. Enable Unione in Metorial. In your Metorial portal, enable the Unione MCP server and sign in with the account that owns the data. Access stays governed by your team policies.
  2. Add a custom connector. Open Customize, then Connectors. Select Add, then Custom, then Web.
  3. Paste your Metorial MCP URL. Name it Metorial, paste your Magic MCP URL (<your-magic-mcp-url>) and continue.
  4. Sign in. Select Add and sign in to load Unione tools.

Run Unione through the Metorial gateway

One governed layer for every app your agents reach, not a separate connector per tool.

  • Give Unione and every other app to your whole team through one MCP gateway, behind your SSO.
  • Scope which teams and agents can use Unione tools with role-based access control, and trace every call.
  • Prefer to run it yourself? Metorial is open source and self-hostable.

More integrations teams use with Unione

Slack

Slack: connect with bot OAuth or user OAuth to work with messages, conversations, search, files, Canvases, Lists, profiles, reactions, reminders, and workspace productivity settings.

Salesforce

Manage CRM data including Accounts, Contacts, Leads, Opportunities, Cases, and custom objects. Create, read, update, and delete records. Query data using SOQL and search across objects using SOSL. Perform bulk data operations for large-scale imports, exports, and migrations. Execute composite requests to batch multiple operations in a single API call. Access analytics, reports, and dashboards. Manage files and attachments associated with records. Interact with Chatter feeds, posts, and groups for social collaboration. Manage org metadata including custom objects, fields, layouts, and workflows. Query data using GraphQL for precise data retrieval across related objects.

Apolloio

Search and prospect B2B contacts and companies from a database of over 275 million people and 70 million organizations. Enrich people and company data with emails, phone numbers, and firmographic details. Create and manage contacts, accounts, deals, and tasks. Add contacts to email sequences and manage sequence statuses. Log and search call records. Perform bulk operations for contact creation, account creation, task creation, and data enrichment.

Sharepoint

Manage SharePoint sites, document libraries, lists, and files. Create, read, update, and delete lists and list items with custom columns. Resolve site users to numeric Person/Group LookupId values. Upload, download, move, copy, and version files in document libraries. Search across sites, files, folders, lists, and list items using Microsoft Search. Manage permissions at site, list, and item levels with granular access control. Define and manage content types and site columns. Retrieve site properties and search for sites across Microsoft 365.

Microsoft Outlook

Send, read, reply to, forward, and manage email messages in user mailboxes. Organize messages into folders, apply categories, flags, and importance levels. Manage file and item attachments. Create, update, delete, and respond to calendar events and meetings. Find available meeting times, manage attendees, handle recurrence, and work with shared or delegated calendars. Create, read, update, and delete contacts, organize them into contact folders, and manage contact photos. Manage tasks and task lists via Microsoft To Do, including due dates, reminders, recurrence, and checklist items. Support for Focused Inbox, @-mentions, mail tips, send-on-behalf, and send-as capabilities.

Hubspot

Create, read, update, and delete CRM objects including contacts, companies, deals, tickets, and custom objects. Manage associations between CRM records. Track engagements such as calls, emails, meetings, notes, and tasks. Send transactional and marketing emails, manage campaigns, and handle subscription preferences. Build and manage marketing workflows, sequences, and automation actions. Manage CMS content including blog posts, landing pages, and HubDB tables. Handle commerce data including products, orders, invoices, quotes, and payments. Create and manage contact lists for segmentation. Configure deal, ticket, and order pipelines with custom stages. Search and filter CRM records. Bulk import and export CRM data. Manage users, teams, and account settings.

Technical notes for Unione

Send transactional and marketing emails to up to 500 recipients per request with HTML, plaintext, and AMP support. Create and manage reusable email templates with substitution/merge tag engines (simple, velocity, liquid). Validate email addresses in real-time for correctness and deliverability. Manage suppression lists to control blocked recipients by cause (unsubscribed, bounced, complained). Register and verify sender domains with DNS records (DKIM, SPF). Track email delivery events including opens, clicks, bounces, unsubscribes, and spam complaints via webhooks. Export historical event data as CSV dumps filtered by status, recipient, sender, or campaign. Manage tags for categorizing and analyzing email delivery statistics. Create and manage isolated projects with separate API keys, domains, and sending limits. Schedule emails up to 24 hours in advance and handle subscription management with re-subscribe flows.

Frequently asked questions

Common questions about connecting Unione to AI agents with Metorial.

  1. How many tools does the Unione MCP server have?
    The Unione MCP server exposes 29 tools, including Get Template, Delete Suppression, Get Suppression. Each one is governed and traced through Metorial.
  2. Unione exposes tools your agents call on demand; it does not publish event triggers yet. Everything still runs through one governed MCP URL.
  3. Any MCP client, including VS Code, Windsurf, Zed, OpenCode and Grok. Each one reaches the Unione MCP server through the same Metorial URL.
  4. Use role-based access control to decide which teams, users, and agents can use Unione and which of its tools they can call.
  5. Yes. Metorial is open source, so you can run the Unione MCP server yourself or use the hosted gateway.

Connect Unione to production AI agents

See how Metorial gives your team governed access to Unione, with tracing and security controls built in.