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 with optional attributes, tags and order history; the non-atomic batch returns per-receiver outcomes, including any not attempted after a batch-wide failure.

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

List CleverReach account tags or supertags, optionally filtered by group.

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

Start with CleverReach.It takes 30 seconds.

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

Start building