SIGN UPLOG IN
X (Twitter)LinkedInGitHubDiscordYouTube

CleverReach MCP server for AI agents and assistants

Securely connect your AI agents and chatbots (Claude, ChatGPT, Cursor, etc) with CleverReach MCP or direct API to manage subscriber groups, create campaigns, review reports, and update forms through natural language.

Get started for freeGet a demo
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

Try CleverReach now

Type what you want done — sign in and watch it run live in the Tool Router playground.

TOOL ROUTER PLAYGROUND
CleverReach
Try asking
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.

SETUP GUIDE

Connect CleverReach MCP Tool with your Agent

1

Install Composio

typescript
npm install @composio/core ai @ai-sdk/mcp @ai-sdk/openai
Install the Composio SDK and your agent framework
2

Create a session with MCP enabled

typescript
import { Composio } from "@composio/core";

const composio = new Composio();
const { mcp } = await composio.create("your-user-id", {
  toolkits: ["cleverreach"],
  mcp: true,
});
Create a session scoped to CleverReach and read its MCP URL and headers
3

Connect your agent to the MCP server

typescript
import { createMCPClient } from "@ai-sdk/mcp";
import { openai } from "@ai-sdk/openai";
import { generateText, stepCountIs } from "ai";

const client = await createMCPClient({
  transport: { type: "http", url: mcp.url, headers: mcp.headers },
});

const { text } = await generateText({
  model: openai("gpt-5.6-sol"),
  tools: await client.tools(),
  prompt: "List all subscriber groups in my CleverReach account",
  stopWhen: stepCountIs(10),
});

console.log(text);
await client.close();
Pass the session's MCP URL and headers to your agent and run a CleverReach request
SETUP GUIDE

Connect CleverReach API Tool with your Agent

1

Install Composio

typescript
npm install @composio/core @composio/openai openai
Install the Composio SDK, the OpenAI provider, and the OpenAI SDK
2

Create a Composio session

typescript
import OpenAI from "openai";
import { Composio } from "@composio/core";
import { OpenAIResponsesProvider } from "@composio/openai";

const composio = new Composio({ provider: new OpenAIResponsesProvider() });
const client = new OpenAI();

const session = await composio.create("your-user-id", { toolkits: ["cleverreach"] });
const tools = await session.tools();
Initialize Composio with the OpenAI Responses provider and create a session scoped to CleverReach
3

Run CleverReach tools with your agent

typescript
let response = await client.responses.create({
  model: "gpt-5.6-sol",
  tools,
  input: [{ role: "user", content: "List all subscriber groups in my CleverReach account" }],
});

while (response.output.some((o) => o.type === "function_call")) {
  const outputs = await composio.provider.handleToolCalls(session, response.output);
  response = await client.responses.create({
    model: "gpt-5.6-sol",
    tools,
    previous_response_id: response.id,
    input: outputs,
  });
}

console.log(response.output_text);
Send a request, execute the CleverReach tool calls through the session, and print the final answer

Why Use Composio?

AI Native CleverReach Integration

  • Supports both CleverReach MCP and direct API based integrations
  • Structured, LLM-friendly schemas for reliable tool execution
  • Rich coverage for reading, writing, and querying your CleverReach data

Managed Auth

  • Built-in OAuth handling with automatic token refresh and rotation
  • Central place to manage, scope, and revoke CleverReach access
  • Per user and per environment credentials instead of hard-coded keys

Agent Optimized Design

  • Tools are tuned using real error and success rates to improve reliability over time
  • Comprehensive execution logs so you always know what ran, when, and on whose behalf

Enterprise Grade Security

  • Fine-grained RBAC so you control which agents and users can access CleverReach
  • Scoped, least privilege access to CleverReach resources
  • Full audit trail of agent actions to support review and compliance
FRAMEWORKS

Use CleverReach with any AI Agent Framework

Choose a Framework you want to connect CleverReach with

ChatGPT logo

ChatGPT

Use CleverReach MCP with ChatGPT

Claude Cowork logo

Claude Cowork

Use CleverReach MCP with Claude Cowork

Hermes logo

Hermes

Use CleverReach MCP with Hermes

Atomic Agent logo

Atomic Agent

Use CleverReach MCP with Atomic Agent

Rolling this out across your team?

Give your team centralized access control across every framework with Composio’s MCP Gateway.

EXPLORE MCP GATEWAY
FAQ

Frequently asked questions

CleverReach requires connections to go through your own OAuth app. You register it once with CleverReach, add its client ID and secret in the Composio dashboard, and from then on everyone connects by signing in to CleverReach as usual. Composio handles the rest of the flow and the token refresh.

Yes! Composio's Tool Router enables agents to use multiple toolkits. Learn more.

Yes. Composio is SOC 2 Type II compliant and is built to keep your CleverReach connection and credentials secure. OAuth tokens and API keys are encrypted, and sensitive customer data is protected at rest and in transit.

Composio also undergoes independent security testing and continuously monitors its systems for security threats. You can review the latest reports and policies in the Composio Trust Center.

Composio maintains and updates all toolkit integrations automatically, so your agents always work with the latest API versions.

When you connect a CleverReach account through Composio, every action runs under that account, so anything the agent creates, sends, or changes shows up in CleverReach as done by you. Keep an approval step in your prompt for actions with side effects, such as sending or deleting, and have the agent draft first.

Exactly the ones CleverReach lists on its consent screen when you connect. Review that screen before approving. If you connect a work account, your CleverReach administrator may need to approve the app first, and you can revoke the access inside CleverReach whenever you want.

Yes. Composio supports multiple connected accounts for the same app, and that works in Claude, ChatGPT, or any other assistant you connect through Composio. Give each CleverReach connection a name such as work or personal, and the assistant uses the one you mention in the request. Each account keeps its own credentials and nothing is merged.

Composio refreshes CleverReach tokens automatically, so day to day you do nothing. If you revoke access inside CleverReach, or CleverReach invalidates the session, the connection shows as expired in Composio and the agent stops acting on that account until you reconnect it, which is a single sign-in.

Composio's free Hobby plan includes 100,000 tool calls per month with no credit card, which covers most personal CleverReach use. Paid plans add higher limits and team features. Your CleverReach plan and its API limits still apply as usual.

Built-in connectors usually give one AI access to a limited set of apps. Many people use Composio because it lets their AI connect to more apps than it normally supports, or connect to multiple accounts for the same app (e.g. connect Claude to multiple CleverReach accounts).

With Composio, you connect CleverReach once and then use it across different AI assistants without setting it up separately in each one. Connect your apps to Composio once, then connect Composio to whichever AI you use, whether that's Claude, ChatGPT, Hermes, or your own custom assistant.

Start with CleverReach.It takes 30 seconds.

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

Start building