How to integrate CleverReach MCP with Atomic Agent

Connect Atomic Agent to CleverReach MCP. List cleverreach subscriber groups needing cleanup, create a cleverreach campaign for new subscribers, and more using natural language, with authentication handled for you.

CleverReach logoCleverReach
Oauth2

CleverReach is an email marketing platform for managing subscribers, campaigns, reports, and signup forms. It helps teams run targeted email campaigns and track their results in one place.

86 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,500+ apps through Composio, including CleverReach.

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 CleverReach account. See the Atomic Agent documentation for installation instructions.

Also integrate CleverReach with

How Atomic Agent connects to CleverReach

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 CleverReach 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 CleverReach. It searches Composio for the right tool.
  4. On first use, open the sign-in link returned in the chat. Connect your CleverReach 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 CleverReach MCP server, and what's possible with it?

The CleverReach MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your CleverReach account. It provides structured and secure access to your subscriber groups, email campaigns, reports, forms, and marketing data, so your agent can manage subscribers, organize audiences, create campaign content, review performance, and maintain email lists on your behalf.

  • Subscriber and group management: Have your agent create, update, bulk upsert, clone, tag, filter, and delete subscribers across CleverReach groups.
  • Audience segmentation: Let the agent create reusable filters, find subscribers that match specific rules, count contacts by tags, and review group statistics.
  • Campaign and content creation: Direct your agent to create mailing campaigns, reusable mailing templates, and reusable content items for your CleverReach marketing work.
  • Marketing performance and records: Instruct your agent to retrieve campaign details, group statistics, filter metrics, receiver events, and subscriber order history.
  • List protection and signup forms: Have your agent check, add, or remove blacklist entries and retrieve embeddable HTML, JavaScript, and CSS for existing CleverReach forms.

Use CleverReach from Atomic Agent

With your account connected, ask Atomic Agent to work with CleverReach 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 CleverReach action and event your agent gets out of the box.

Add Blacklist Entries

Add email addresses to the account-wide CleverReach blacklist in one provider batch request.

Add Blacklist Entry

Add one email address to the global blacklist when group_id is omitted, or to a group-specific blacklist when it is supplied.

Add Group Receiver Tags

IRREVERSIBLE AUTOMATION WARNING: add tags to one receiver through a specific group route.

Add Receiver Tags

Add tags to one receiver through the account-wide receiver route.

Bulk Update Receivers

Update existing receivers in one provider batch for a group.

Bulk Upsert Receivers

Create or update receivers in one provider batch for a group.

Change Receiver Email

Change one receiver's email address.

Clone Receiver

Copy a receiver to a target group under a new email address.

Count Receivers By Tags

Count receivers with one tag using a GET query, or with a tag constellation using a read-like POST.

Create Attribute

Create a global or group-local CleverReach receiver attribute.

Create Filter

Create a reusable CleverReach filter or segment in one receiver group.

Create Group

Create a CleverReach receiver group and return its group ID for subsequent subscriber operations.

Create Mailing

Create a CleverReach mailing campaign definition.

Create Mailing Template

Create a reusable CleverReach mailing template.

Create My Content

Create a reusable CleverReach "My Content" item that references a URL.

Create Receiver

Create a subscriber in one CleverReach group.

Create Receiver Event

IRREVERSIBLE: permanently add an event to one CleverReach receiver.

Create Receiver Order

MUTATES ORDER HISTORY: add an order to one CleverReach receiver globally or within a group.

Create Receivers

Create up to 50 subscribers in one CleverReach group and return a separate success or failure result for each receiver.

Delete Attribute

Permanently delete a CleverReach global or group-local attribute.

Delete Blacklist Entries

Permanently delete 1-50 exact email addresses sequentially from the global account blacklist, or only from one group's blacklist when group_id is supplied.

Delete Blacklist Entry

Permanently remove one email address from the global CleverReach blacklist, or from a group blacklist when group_id is supplied.

Delete Filter

Permanently delete a CleverReach filter or segment.

Delete Group

Permanently delete one CleverReach receiver group by ID.

Delete Mailing Channel

Permanently delete one CleverReach mailing channel/category.

Delete My Content

Permanently delete one CleverReach "My Content" item by exact ID.

Delete Receiver Account-Wide

Permanently delete one exact receiver at account level.

Delete Receiver Order

IRREVERSIBLE: permanently delete one CleverReach receiver order globally or within a group using its internal id from LIST_RECEIVER_ORDERS, not the caller-defined order_id.

Delete Receivers Account-Wide

Permanently delete a non-empty explicit list of exact receivers account-wide.

Delete Report

Permanently and irreversibly delete one report and its historical analytics by exact report or mailing ID.

Filter Receivers

Return one bounded page of receivers matching temporary CleverReach filter rules.

Get Attribute

Return one CleverReach global attribute by ID.

Get Attribute Limits

Show the attribute limits applied to the connected CleverReach account.

Get Blacklist Entry

Check whether an exact email address is on the account-wide CleverReach blacklist and return its blacklist details when present.

Get Filter

Get one CleverReach group filter or segment.

Get Filter Metrics

Return statistics or a receiver count for one CleverReach group filter.

Get Form Embed Code

Return embeddable HTML, JavaScript, and CSS for an existing legacy CleverReach form, with optional branding controls.

Get Group

Return one receiver group by its CleverReach group ID.

Get Group Stats

Return either standard or advanced CleverReach statistics for one receiver group.

Get Mailing

Return one CleverReach mailing campaign by its mailing ID.

Get Mailing Channel

Return one CleverReach mailing channel or category by ID.

Get My Content

Return one CleverReach "My Content" item by ID.

Get Random Mailing Receiver

Return a random receiver from a CleverReach mailing audience for preview purposes.

Get Receiver

Return one receiver by ID or exact email address.

Get Receiver Attributes

Get attribute values for a CleverReach receiver, optionally in one group.

Get Receiver Tags

Return all tags currently set on one receiver, optionally filtered by origin.

Get Report

Return one mailing report by report or mailing ID, including split-test versions when present.

Get Report Stats

Return one selected statistics view for a mailing report, such as links, countries, clients, traffic, or daily activity.

List Attributes

Return a locally bounded set of global attributes or local attributes for one CleverReach group.

List Blacklist Entries

Return a locally bounded set of entries on the global CleverReach blacklist, or on a specific group blacklist when group_id is supplied.

List Bounced Receivers

Return one bounded page of receivers with a bounce date and an opaque cursor for the next page.

List Bounces

Return one page of up to 500 account-wide CleverReach bounce records.

List Filter Receivers

Return one bounded page of receivers matching a saved CleverReach filter.

List Filters

Return a locally bounded set of CleverReach filters or segments for one receiver group.

List Forms

Return a locally bounded set of legacy CleverReach forms globally or for a supplied group.

List Groups

Return a locally bounded set of receiver groups (lists) in the connected CleverReach account, optionally ordered by creation or change time.

List Mailing Channels

Return a locally bounded set of CleverReach mailing channels, also called categories.

List Mailing Links

Return the links CleverReach recorded for one mailing.

List Mailing Orders

Return a locally bounded set of orders attributed to a CleverReach report or mailing.

List Mailings

Return campaigns filtered by delivery state, channel, or the state's time window.

List Mailing Templates

Return locally bounded categories and either agency-managed or user-owned CleverReach templates.

List My Content

Return a locally bounded set of reusable CleverReach "My Content" items.

List Receiver Events

Return a locally bounded set of events recorded for one CleverReach receiver, either account-wide or in a specific group.

List Receiver Groups

Return a locally bounded set of group IDs to which a receiver is allocated, filtered by membership state.

List Receiver Orders

Return a locally bounded set of orders recorded for one CleverReach receiver, globally or in a specific group.

List Receivers

Return one page of receivers in a CleverReach group, optionally filtered by subscription state, email addresses, or receiver IDs.

List Receiver Tags

Return a locally bounded set of receiver tags already used in the account, optionally filtered by origin.

List Report Receivers

Return one page of receivers in a report for a delivery or engagement state such as opened, clicked, bounced, or unsubscribed.

List Reports

Return one page of mailing reports filtered by date range, group, or channel.

List Tags

Return one page of account tags or the account's supertags.

Remove Receiver From Group

Remove one exact receiver from one specified group.

Remove Receivers From Group

Remove a non-empty explicit list of exact receivers from one specified group.

Remove Receiver Tags

Remove specified tags from one receiver.

Send Mailing Preview

Immediately deliver a preview email for one mailing to the specified CleverReach account-user addresses.

Set Receiver Attribute

Update one attribute value on a CleverReach receiver at account or group scope.

Set Receiver Status

Activate or deactivate one receiver in a CleverReach group, changing whether the subscriber is active for mailings.

Update Attribute

Update a CleverReach global or group-local attribute.

Update Blacklist Entry

Update the comment on one account-wide CleverReach blacklist entry, identified by its email address.

Update Filter

Update a CleverReach filter or segment in one receiver group.

Update Group

Update the name, notes, lock setting, or backup setting of an existing CleverReach receiver group.

Update Mailing

Update the content, audience, sender, tracking settings, or tags of an existing CleverReach mailing campaign without sending it.

Update My Content

Update supplied fields of one CleverReach "My Content" item.

Update Receiver

Update lifecycle timestamps, profile attributes, tags, or orders for one receiver in a CleverReach group without changing the email.

Update Receiver Order

IRREVERSIBLE MUTATION: replace the documented details of one CleverReach order item by its internal id from LIST_RECEIVER_ORDERS, not by the caller-defined order_id.

Validate Blacklist Emails

Filter up to 1000 email addresses against the global or group CleverReach blacklist without changing blacklist state.

Validate Receiver Emails

Submit up to 1000 email addresses and return CleverReach's valid-address result.

FAQ

Frequently asked questions

With a standalone CleverReach MCP server, the agents and LLMs can only access a fixed set of CleverReach tools tied to that server. However, with the Composio Tool Router, agents can dynamically load tools from CleverReach and many other apps based on the task at hand, all through a single MCP endpoint.

Yes, you can. Atomic Agent fully supports MCP integration. You get structured tool calling, message history handling, and model orchestration while Tool Router takes care of discovering and serving the right CleverReach tools.

Yes, absolutely. You can configure which CleverReach scopes and actions are allowed when connecting your account to Composio. You can also bring your own OAuth credentials or API configuration so you keep full control over what the agent can do.

All sensitive data such as tokens, keys, and configuration is fully encrypted at rest and in transit. Composio is SOC 2 Type 2 compliant and follows strict security practices so your CleverReach data and credentials are handled as safely as possible.

Start with CleverReach.It takes 30 seconds.

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

Start building