How to integrate Unione MCP with Atomic Agent

Connect Atomic Agent to Unione MCP. Check your current unione email balance, cancel a scheduled email by job id, and more using natural language, with authentication handled for you.

Unione logoUnione
Api Key

UniOne is an email delivery service with a flexible Web API and SMTP API for transactional and marketing emails. It streamlines reliable, scalable email sending for developers and businesses.

32 Tools

Introduction

Atomic Agent is an open-source AI agent that runs on your machine and supports local models through llama.cpp. Connect it to 1,700+ apps through Composio, including Unione.

This guide uses Atomic Agent's built-in Composio integration. You need Atomic Agent v0.5.6 or later, your own Composio API key, and a Unione account. See the Atomic Agent documentation for installation instructions.

For exact tool slugs and parameter tables, see the tool catalog in the Composio docs.

Also integrate Unione with

How Atomic Agent connects to Unione

Atomic Agent connects to Composio's Tool Router over Streamable HTTP MCP. It discovers the tools needed for your request, and Composio handles account authentication.

Execution and account-connection tools follow Atomic Agent's configured approval policy. Review any approval prompt before allowing an action on your connected account.

Connect Unione to Atomic Agent

  1. Sign up or sign in to the Composio dashboard. Copy your API key.
  2. In Atomic Agent, open the Integrations tab and select Composio. Select API key, press e, paste the key, and press Enter. The tools become available immediately, without a restart.
  3. Ask Atomic Agent to do something in Unione. It searches Composio for the right tool.
  4. On first use, open the sign-in link returned in the chat. Connect your Unione account, then return to Atomic Agent to continue.

Headless setup

Add the following line to ~/.atomic-agent/.env, replacing YOUR_COMPOSIO_API_KEY with your key. Start Atomic Agent after saving the file.

bash
COMPOSIO_API_KEY=YOUR_COMPOSIO_API_KEY

What is the Unione MCP server, and what's possible with it?

The Unione MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your Unione account. It provides structured and secure access to your Unione email delivery service, so your agent can send transactional or marketing emails, manage sending domains, monitor delivery events, check account balance, and automate email operations on your behalf.

  • Automated email sending and scheduling: Have your agent send transactional or marketing emails and even schedule deliveries right from your Unione account.
  • Domain verification and management: Easily manage sender domains, trigger domain verifications, and handle DNS/DKIM checks to keep your emails deliverable.
  • Event monitoring and export: Let your agent fetch specific email events, retrieve delivery metrics, or export comprehensive email event logs for auditing and analytics.
  • Account balance and plan checks: Quickly access your current email balance and subscription plan details, ensuring you stay within your sending limits.
  • Email job and pricing insights: Retrieve detailed information about specific email jobs and get up-to-date pricing for cost management before sending campaigns.

Use Unione from Atomic Agent

With your account connected, ask Atomic Agent to work with Unione in natural language. You can connect more apps through the same Composio integration as you need them.

Visit the Atomic Agent website or inspect the Atomic Agent source code.

Troubleshooting

Why is my API key rejected?

Copy the key directly from the Composio dashboard. Atomic Agent requires ASCII characters because it sends the key in an HTTP header. Remove any extra characters introduced when copying.

Why are Composio tools unavailable after saving a key?

Check that you use Atomic Agent v0.5.6 or later and that Composio is enabled in your configuration. A "composio": { "enabled": false } setting disables the integration while keeping the saved key on disk.

Does Composio have a free plan?

The Hobby plan includes 100,000 tool calls per month. Composio-managed OAuth apps have a lower included allowance. See Composio pricing for the current limits that apply to your connection.

TOOLS

Supported Tools

Every Unione action and event your agent gets out of the box.

Delete Event Dump

Tool to delete an event dump file and remove it from the queue or storage.

Delete Template

Tool to delete a template by ID.

Delete Webhook

Tool to delete a webhook event notification handler by its URL.

UniOne Email Balance

Retrieves account information and billing-period email usage from UniOne, including emails included and sent.

Cancel Scheduled Email

Tool to cancel a scheduled transactional email by its job ID.

UniOne Email Domain Management

Manage UniOne sender domains: obtain DNS verification records, trigger ownership or DKIM checks, list domains, or delete a domain.

Get Email Event

Tool to retrieve details of a specific email event by its ID.

Get Email Send Job

Tool to retrieve detailed information about a specific email send job.

UniOne Email List (Export)

Tool to export email events within a specified time frame.

Resend Sent Email

Tool to resend a previously sent email by its job ID.

UniOne Email Resubscribe

Send a resubscription link to a previously unsubscribed recipient or one blocked due to complaints.

Resume Paused Email

Tool to resume a paused transactional email by its job ID.

UniOne Email SMTP Configuration

Construct SMTP configuration details from the connection's region and API key, including a derived host, ports, username and password.

UniOne Email Statistics

Retrieve daily and total email statistics for an inclusive date range, including sent, delivered, bounced, opened, and clicked counts.

UniOne Email Unsubscribe

Add an email address to the UniOne suppression list with an unsubscribed cause, suppressing future sends in the applicable account or project.

Batch Email Validation

Validates a list of email addresses using UniOne's single-address checks.

Remove Email from Suppression List

Remove deletable suppression records for an email address from the UniOne suppression list.

Retry Email Validation

Tool to retry an email validation request.

UniOne Email Webhook Types

Collects the distinct spam-block and email-status event types configured on the webhooks returned by one webhook-list request.

Create Event Dump

Tool to create an asynchronous CSV event dump.

UniOne Event Dump List

Tool to retrieve the full list of event dumps.

Get Event Dump

Retrieve an event dump's status and available download URLs by dump ID.

Get Email Suppression Details

Tool to check if an email is suppressed and retrieve the reason and date.

Get Template

Tool to get template properties by ID.

Get Webhook Configuration

Retrieves a UniOne webhook configuration by its URL.

Schedule Email

Tool to schedule a transactional email up to 24 hours ahead.

Suppression List

Tool to return the suppression list since a given date.

Delete Tag

Tool to delete a specific tag.

UniOne Tag List

Tool to retrieve all user-defined tags.

UniOne Template List

Tool to list email templates.

Set Template

Tool to set or update an email template.

Set Webhook

Tool to set or edit a webhook event notification handler.

FAQ

Frequently asked questions

Start with Unione.It takes 30 seconds.

Managed auth, hosted MCP servers, and every Unione tool your agent needs.Free to start.

Start building