How to integrate ActiveTrail MCP with Mastra AI

This guide walks you through connecting ActiveTrail to Mastra AI using the Composio tool router. By the end, you'll have a working ActiveTrail agent that can create a new email campaign for vip subscribers, add a contact to the 'newsletter' list, get open rates for last week's campaigns through natural language commands. This guide will help you understand how to give your Mastra AI agent real control over a ActiveTrail account through Composio's ActiveTrail MCP server. Before we dive in, let's take a quick look at the key ideas and tools involved.

Get started for freeGet a demo
ActiveTrail logoActiveTrail
Api Key

ActiveTrail is a user-friendly email marketing and automation platform. It helps you reach subscribers and automate campaigns with ease.

162 Tools

Introduction

This guide walks you through connecting ActiveTrail to Mastra AI using the Composio tool router. By the end, you'll have a working ActiveTrail agent that can create a new email campaign for vip subscribers, add a contact to the 'newsletter' list, get open rates for last week's campaigns through natural language commands.

This guide will help you understand how to give your Mastra AI agent real control over a ActiveTrail account through Composio's ActiveTrail MCP server.

Before we dive in, let's take a quick look at the key ideas and tools involved.

Also integrate ActiveTrail with

OpenAI Agents SDKClaude Agent SDKClaude CodeClaude CoworkCodexOpenClawHermesCLIGoogle ADKLangChainVercel AI SDKLlamaIndexCrewAI

TL;DR

Here's what you'll learn:
  • Set up your environment so Mastra, OpenAI, and Composio work together
  • Create a Tool Router session in Composio that exposes ActiveTrail tools
  • Connect Mastra's MCP client to the Composio generated MCP URL
  • Fetch ActiveTrail tool definitions and attach them as a toolset
  • Build a Mastra agent that can reason, call tools, and return structured results
  • Run an interactive CLI where you can chat with your ActiveTrail agent

What is Mastra AI?

Mastra AI is a TypeScript framework for building AI agents with tool support. It provides a clean API for creating agents that can use external services through MCP.

Key features include:

  • MCP Client: Built-in support for Model Context Protocol servers
  • Toolsets: Organize tools into logical groups
  • Step Callbacks: Monitor and debug agent execution
  • OpenAI Integration: Works with OpenAI models via @ai-sdk/openai

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

The ActiveTrail MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your ActiveTrail account. It provides structured and secure access so your agent can perform ActiveTrail operations on your behalf.

What is the Composio tool router, and how does it fit here?

What is Composio SDK?

Composio's Composio SDK helps agents find the right tools for a task at runtime. You can plug in multiple toolkits (like Gmail, HubSpot, and GitHub), and the agent will identify the relevant app and action to complete multi-step workflows. This can reduce token usage and improve the reliability of tool calls. Read more here: Getting started with Composio SDK

The tool router generates a secure MCP URL that your agents can access to perform actions.

How the Composio SDK works

The Composio SDK follows a three-phase workflow:

  1. Discovery: Searches for tools matching your task and returns relevant toolkits with their details.
  2. Authentication: Checks for active connections. If missing, creates an auth config and returns a connection URL via Auth Link.
  3. Execution: Executes the action using the authenticated connection.

Step-by-step Guide

Step by step09 STEPS
1

Prerequisites

Before starting, make sure you have:
  • Node.js 18 or higher
  • A Composio account with an active API key
  • An OpenAI API key
  • Basic familiarity with TypeScript
2

Getting API Keys for OpenAI and Composio

OpenAI API Key
  • Go to the OpenAI dashboard and create an API key.
  • You need credits or a connected billing setup to use the models.
  • Store the key somewhere safe.
Composio API Key
  • Log in to the Composio dashboard.
  • Go to Settings and copy your API key.
  • This key lets your Mastra agent talk to Composio and reach ActiveTrail through MCP.
3

Install dependencies

bash
npm install @composio/core @mastra/core @mastra/mcp @ai-sdk/openai dotenv

Install the required packages.

What's happening:

  • @composio/core is the Composio SDK for creating MCP sessions
  • @mastra/core provides the Agent class
  • @mastra/mcp is Mastra's MCP client
  • @ai-sdk/openai is the model wrapper for OpenAI
  • dotenv loads environment variables from .env
4

Set up environment variables

bash
COMPOSIO_API_KEY=your_composio_api_key_here
COMPOSIO_USER_ID=your_user_id_here
OPENAI_API_KEY=your_openai_api_key_here

Create a .env file in your project root.

What's happening:

  • COMPOSIO_API_KEY authenticates your requests to Composio
  • COMPOSIO_USER_ID tells Composio which user this session belongs to
  • OPENAI_API_KEY lets the Mastra agent call OpenAI models
5

Import libraries and validate environment

typescript
import "dotenv/config";
import { openai } from "@ai-sdk/openai";
import { Agent } from "@mastra/core/agent";
import { MCPClient } from "@mastra/mcp";
import { Composio } from "@composio/core";
import * as readline from "readline";

import type { AiMessageType } from "@mastra/core/agent";

const openaiAPIKey = process.env.OPENAI_API_KEY;
const composioAPIKey = process.env.COMPOSIO_API_KEY;
const composioUserID = process.env.COMPOSIO_USER_ID;

if (!openaiAPIKey) throw new Error("OPENAI_API_KEY is not set");
if (!composioAPIKey) throw new Error("COMPOSIO_API_KEY is not set");
if (!composioUserID) throw new Error("COMPOSIO_USER_ID is not set");

const composio = new Composio({
  apiKey: composioAPIKey as string,
});
What's happening:
  • dotenv/config auto loads your .env so process.env.* is available
  • openai gives you a Mastra compatible model wrapper
  • Agent is the Mastra agent that will call tools and produce answers
  • MCPClient connects Mastra to your Composio MCP server
  • Composio is used to create a Tool Router session
6

Create a Tool Router session for ActiveTrail

typescript
async function main() {
  const session = await composio.create(
    composioUserID as string,
    {
      toolkits: ["active_trail"],
    },
  );

  const composioMCPUrl = session.mcp.url;
  console.log("ActiveTrail MCP URL:", composioMCPUrl);
What's happening:
  • create spins up a short-lived MCP HTTP endpoint for this user
  • The toolkits array contains "active_trail" for ActiveTrail access
  • session.mcp.url is the MCP URL that Mastra's MCPClient will connect to
7

Configure Mastra MCP client and fetch tools

typescript
const mcpClient = new MCPClient({
    id: composioUserID as string,
    servers: {
      nasdaq: {
        url: new URL(composioMCPUrl),
        requestInit: {
          headers: session.mcp.headers,
        },
      },
    },
    timeout: 30_000,
  });

console.log("Fetching MCP tools from Composio...");
const composioTools = await mcpClient.getTools();
console.log("Number of tools:", Object.keys(composioTools).length);
What's happening:
  • MCPClient takes an id for this client and a list of MCP servers
  • The headers property includes the x-api-key for authentication
  • getTools fetches the tool definitions exposed by the ActiveTrail toolkit
8

Create the Mastra agent

typescript
const agent = new Agent({
    name: "active_trail-mastra-agent",
    instructions: "You are an AI agent with ActiveTrail tools via Composio.",
    model: "openai/gpt-5",
  });
What's happening:
  • Agent is the core Mastra agent
  • name is just an identifier for logging and debugging
  • instructions guide the agent to use tools instead of only answering in natural language
  • model uses openai("gpt-5") to configure the underlying LLM
9

Set up interactive chat interface

typescript
let messages: AiMessageType[] = [];

console.log("Chat started! Type 'exit' or 'quit' to end.\n");

const rl = readline.createInterface({
  input: process.stdin,
  output: process.stdout,
  prompt: "> ",
});

rl.prompt();

rl.on("line", async (userInput: string) => {
  const trimmedInput = userInput.trim();

  if (["exit", "quit", "bye"].includes(trimmedInput.toLowerCase())) {
    console.log("\nGoodbye!");
    rl.close();
    process.exit(0);
  }

  if (!trimmedInput) {
    rl.prompt();
    return;
  }

  messages.push({
    id: crypto.randomUUID(),
    role: "user",
    content: trimmedInput,
  });

  console.log("\nAgent is thinking...\n");

  try {
    const response = await agent.generate(messages, {
      toolsets: {
        active_trail: composioTools,
      },
      maxSteps: 8,
    });

    const { text } = response;

    if (text && text.trim().length > 0) {
      console.log(`Agent: ${text}\n`);
        messages.push({
          id: crypto.randomUUID(),
          role: "assistant",
          content: text,
        });
      }
    } catch (error) {
      console.error("\nError:", error);
    }

    rl.prompt();
  });

  rl.on("close", async () => {
    console.log("\nSession ended.");
    await mcpClient.disconnect();
    process.exit(0);
  });
}

main().catch((err) => {
  console.error("Fatal error:", err);
  process.exit(1);
});
What's happening:
  • messages keeps the full conversation history in Mastra's expected format
  • agent.generate runs the agent with conversation history and ActiveTrail toolsets
  • maxSteps limits how many tool calls the agent can take in a single run
  • onStepFinish is a hook that prints intermediate steps for debugging

Complete Code

Here's the complete code to get you started with ActiveTrail and Mastra AI:

typescript
import "dotenv/config";
import { openai } from "@ai-sdk/openai";
import { Agent } from "@mastra/core/agent";
import { MCPClient } from "@mastra/mcp";
import { Composio } from "@composio/core";
import * as readline from "readline";

import type { AiMessageType } from "@mastra/core/agent";

const openaiAPIKey = process.env.OPENAI_API_KEY;
const composioAPIKey = process.env.COMPOSIO_API_KEY;
const composioUserID = process.env.COMPOSIO_USER_ID;

if (!openaiAPIKey) throw new Error("OPENAI_API_KEY is not set");
if (!composioAPIKey) throw new Error("COMPOSIO_API_KEY is not set");
if (!composioUserID) throw new Error("COMPOSIO_USER_ID is not set");

const composio = new Composio({ apiKey: composioAPIKey as string });

async function main() {
  const session = await composio.create(composioUserID as string, {
    toolkits: ["active_trail"],
  });

  const composioMCPUrl = session.mcp.url;

  const mcpClient = new MCPClient({
    id: composioUserID as string,
    servers: {
      active_trail: {
        url: new URL(composioMCPUrl),
        requestInit: {
          headers: session.mcp.headers,
        },
      },
    },
    timeout: 30_000,
  });

  const composioTools = await mcpClient.getTools();

  const agent = new Agent({
    name: "active_trail-mastra-agent",
    instructions: "You are an AI agent with ActiveTrail tools via Composio.",
    model: "openai/gpt-5",
  });

  let messages: AiMessageType[] = [];

  const rl = readline.createInterface({
    input: process.stdin,
    output: process.stdout,
    prompt: "> ",
  });

  rl.prompt();

  rl.on("line", async (input: string) => {
    const trimmed = input.trim();
    if (["exit", "quit"].includes(trimmed.toLowerCase())) {
      rl.close();
      return;
    }

    messages.push({ id: crypto.randomUUID(), role: "user", content: trimmed });

    const { text } = await agent.generate(messages, {
      toolsets: { active_trail: composioTools },
      maxSteps: 8,
    });

    if (text) {
      console.log(`Agent: ${text}\n`);
      messages.push({ id: crypto.randomUUID(), role: "assistant", content: text });
    }

    rl.prompt();
  });

  rl.on("close", async () => {
    await mcpClient.disconnect();
    process.exit(0);
  });
}

main();

Conclusion

You've built a Mastra AI agent that can interact with ActiveTrail through Composio's Tool Router. You can extend this further by:
  • Adding other toolkits like Gmail, Slack, or GitHub
  • Building a web-based chat interface around this agent
  • Using multiple MCP endpoints to enable cross-app workflows
TOOLS

Supported Tools

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

Add Group Member

Tool to add a member to a group in ActiveTrail.

Get Contact Growth

Tool to retrieve executive report on contact growth showing daily active and inactive contact growth.

Create or Update Group Member

Tool to create or update a member in a group.

Create a New Group

Tool to create a new group in ActiveTrail.

Create Contact

Tool to create a new contact in ActiveTrail.

Create Content Category

Tool to create a new content category in ActiveTrail account.

Create New Mailing List

Tool to create a new mailing list in ActiveTrail.

Create Order

Tool to create new orders in ActiveTrail commerce system.

Create Smart Code Site

Tool to create a new Smart Code site in ActiveTrail.

Create Webhook

Tool to create a new webhook for event notifications in ActiveTrail.

Delete content category

Tool to delete a specific content category by ID.

Delete group member

Tool to delete a group member by ID.

Delete Automations

Tool to delete one or more automations from Active Trail.

Delete Campaign

Tool to remove a campaign from ActiveTrail account.

Delete Contact

Tool to remove a contact from the ActiveTrail account.

Delete group by ID

Tool to delete a group by ID.

Delete Group Member

Tool to remove a member from a group in ActiveTrail.

Delete Mailing List

Tool to remove a mailing list from ActiveTrail account.

Delete Mailing List Member

Tool to remove a member from a mailing list in ActiveTrail.

Delete Smart Code Site

Tool to remove a Smart Code site from ActiveTrail.

Delete Template

Tool to remove a template from ActiveTrail account.

Delete template category

Tool to delete a template category by ID.

Delete webhook parameter

Tool to delete a given webhook parameter from your account's webhook configuration.

Get Account Balance

Tool to retrieve email and SMS credit balance for the account.

Get specific content category

Tool to retrieve specific category details by ID.

Get ActiveCommerce Integration Data

Tool to retrieve the account's ActiveCommerce integration data.

Get Account Merge Status

Tool to check if the account has awaited merges.

Get List of All SMS Campaign Clickers

Tool to retrieve all contacts who clicked on links in an SMS campaign.

Get All Campaign Reports

Tool to retrieve a full overview of all campaign reports with comprehensive metrics.

Get All Groups

Tool to retrieve the full list of account groups with pagination and filtering.

Get All Sent Campaigns

Tool to retrieve campaigns with optional filtering by date, mailing list, and search criteria.

Get SMS Campaign Delivered List

Tool to get a specific SMS campaign's delivered list data.

Get SMS Campaign Recipient Data

Tool to get a specific SMS campaign's 'sent to' data as a list.

Get SMS Campaign Unsubscribed List

Tool to get a specific SMS campaign's unsubscribed data as a list.

Get Automation Log

Tool to track contacts through automation journey by retrieving detailed logs.

Get Automation Queue Logs

Tool to retrieve contacts that did not finish a specific automation.

Get Automation SMS Campaign Summary Report

Tool to retrieve SMS campaigns' summary reports for a specific automation.

Get Automations

Tool to list account automations with filtering and pagination.

Get Automation Details

Tool to retrieve detailed configuration of a specific automation excluding step-by-step execution details.

Get Automation Email Campaign Steps

Tool to retrieve all email campaign steps in an automation workflow.

Get Automation SMS Campaign Steps

Tool to retrieve all SMS campaign steps in an automation workflow.

Get Automation Trigger Types

Tool to retrieve all available start trigger options for automations.

Get Campaign Bounces

Tool to retrieve bounce details by domain for a specific campaign.

Get Campaign Click-Through Data

Tool to access click-through data for a specific campaign.

Get Campaign Complaints

Tool to retrieve contacts who reported a specific campaign as spam.

Get Campaign Design

Tool to retrieve campaign design configuration including visual layout and HTML content.

Get Campaign Domains Report

Tool to retrieve a report by domain for a specific campaign.

Get Campaign Opens

Tool to retrieve contacts who opened a specific campaign.

Get Campaign Report

Tool to retrieve an overview report for a specific campaign.

Get Campaign Bounced Emails by Type

Tool to retrieve bounced email details filtered by bounce type for a specific campaign.

Get Campaign Click Details Report

Tool to retrieve click details report for a specific campaign.

Get Campaign Spam Complaints

Tool to retrieve contacts who reported a specific campaign as spam.

Get Campaign Email Activity Report

Tool to retrieve all contacts' activity on a specific campaign.

Get Campaign Sent Emails

Tool to retrieve contacts who received a specific campaign email.

Get Campaign Unopened Contacts

Tool to retrieve contacts who did not open a specific campaign.

Get Campaign Scheduling

Tool to retrieve campaign schedule configuration including timing and delivery settings.

Get Campaign by ID

Tool to retrieve complete campaign information including send settings, design, template, and A/B test configuration.

Get Campaign Details

Tool to retrieve detailed campaign information including name, subject, and settings.

Get Campaign by ID (Copy)

Tool to retrieve complete campaign information including send settings, design, template, and A/B test configuration.

Get Campaign Segment Settings

Tool to retrieve campaign sending settings including target groups and sending restrictions.

Get Sent Campaigns

Tool to retrieve a list of all sent campaigns from ActiveTrail.

Get Campaign Template

Tool to retrieve template details associated with a specific campaign.

Get Campaign Unopened Contacts

Tool to retrieve contacts who did not open a specific campaign.

Get Campaign Unsubscribed Contacts

Tool to retrieve contacts who unsubscribed from a specific email campaign.

Get Click Details by Link ID

Tool to retrieve click details for a specific link within a campaign.

Get Contact Activity

Tool to retrieve contact's email engagement history including opens and clicks.

Get Contact Bounces

Tool to retrieve bounce activity for a specific contact by contact ID.

Get Contact Fields

Tool to retrieve account contact fields filtered by type.

Get Contact Groups

Tool to retrieve all groups associated with a specific contact.

Get Contact List

Tool to retrieve account contacts filtered by status and date range.

Get Contact's Errors

Tool to retrieve bounce and error history for a specific contact.

Get Contact's Mailing Lists

Tool to retrieve all mailing lists associated with a specific contact.

Get Contacts Merges

Tool to retrieve contacts experiencing merge conflicts with filtering options.

Get Contacts Subscription All Contacts

Tool to get contacts' subscription status and the source of their status (if known).

Get Contacts Subscription Status

Tool to get statistics of contacts' statuses from specific dates.

Get Contacts Subscription Unsubscribers

Tool to retrieve all contacts who unsubscribed and the source of their unsubscription status.

Get Contacts Unsubscribers SMS

Tool to retrieve all contacts who unsubscribed from receiving SMS messages.

Get Contacts With SMS State

Tool to retrieve account's contacts list with SMS subscription state.

Get Content Categories

Tool to retrieve all content categories from the ActiveTrail account.

Get Customer Stats for Transactional Message

Tool to retrieve customer interaction statistics for a specific transactional message.

Get Executive Report

Tool to retrieve executive performance reports for the ActiveTrail account.

Get Group Details

Tool to retrieve detailed information about a specific group by its unique identifier.

Get Group by ID

Tool to retrieve detailed information about a specific group by its unique identifier.

Get Group Contents by ID

Tool to retrieve all group members by group ID with pagination and filtering.

Get Group Information for Contact

Tool to retrieve all groups that a specific contact belongs to by contact ID.

Get Group Events

Tool to retrieve all events for a specific group with optional filtering by event type, event date, and subscriber creation date.

Get Landing Pages

Tool to retrieve landing pages from the ActiveTrail account with pagination support.

Get Mailing List

Tool to retrieve detailed information about a specific mailing list by its unique identifier.

Get Mailing List Members

Tool to retrieve all members belonging to a specific mailing list.

Get Mailing Lists

Tool to retrieve all mailing lists from the ActiveTrail account.

Get Order

Tool to retrieve complete details of a specific order from ActiveTrail commerce system.

Get Push Campaign Opens

Tool to retrieve contacts who opened a specific push notification campaign.

Get Push Campaign Delivered Report

Tool to retrieve contacts who successfully received a specific push notification campaign.

Get Push Campaign Failed Delivery Report

Tool to retrieve the failed delivery report for a specific push campaign.

Get Push Campaign Reports

Tool to retrieve push notification campaign performance metrics and reports.

Get Push Campaign Sent Report

Tool to retrieve contacts who were sent a specific push notification campaign.

Get Push Campaign Report Summary

Tool to retrieve summary report information of Push campaigns by dates.

Get Push Campaigns

Tool to retrieve push notification campaigns with optional filtering by date, campaign ID, and search criteria.

Get Segmentation Rule Field Types

Tool to retrieve dictionary of rule field types for segmentation.

Get Segmentation Rule Operations

Tool to retrieve dictionary of rule operations for segmentation.

Get Segmentation Rule Types

Tool to retrieve dictionary of segmentation rule types for automation.

Get Segmentations

Tool to retrieve all segmentations from the ActiveTrail account.

Get Sending Profiles

Tool to retrieve account email sending profiles.

Get Signup Form

Tool to retrieve detailed information about a specific signup form by its unique identifier.

Get Signup Forms

Tool to retrieve all signup forms from the ActiveTrail account.

Get Smart Code Sites

Tool to retrieve all Smart Code sites from the ActiveTrail account.

Get SMS Campaign by ID

Tool to retrieve detailed information about a specific SMS campaign by its unique identifier.

Get SMS Campaign Clickers

Tool to access link click data for SMS campaigns.

Get SMS Campaign Delivered Report

Tool to retrieve delivery confirmations for a specific SMS campaign.

Get SMS Operational Message by ID

Tool to retrieve operational SMS message details by unique identifier.

Get SMS Campaign Report Clicks

Tool to retrieve SMS clicks (on links) reports for a specific campaign.

Get SMS Campaign Failed Delivery Report

Tool to retrieve the failed delivery report for a specific SMS campaign.

Get SMS Campaign Reports

Tool to retrieve SMS campaign performance metrics and reports with filtering options.

Get SMS Campaign Sent Contacts Report

Tool to retrieve all contacts that an SMS campaign was sent to.

Get SMS Campaign Report Summary

Tool to retrieve summary report information of SMS campaigns by dates.

Get SMS Campaign Unsubscribed Contacts

Tool to retrieve contacts who unsubscribed from a specific SMS campaign.

Get SMS Sending Profiles

Tool to retrieve SMS sending profiles configured for the account.

Get Template

Tool to retrieve detailed information about a specific template from the account's saved templates.

Get Template Content

Tool to retrieve HTML content of a specific template.

Get Templates

Tool to retrieve saved templates from the ActiveTrail account.

Get Template Categories

Tool to retrieve all template categories from 'my templates' section.

Get Transactional Messages Classification

Tool to retrieve all classification options for operational/transactional messages.

Get Transactional SMS Message

Tool to retrieve detailed information about a specific transactional SMS message by its unique identifier.

Get Two-Way SMS Replies

Tool to retrieve virtual number SMS replies with filtering options.

Get Automation Update Actions

Tool to retrieve all types of actions that can update a contact in an automation.

Get User Bounces by Campaign ID

Tool to retrieve specific user details of users that got a bounce by Campaign ID, filtered by bounce type.

Get User Social Accounts

Tool to retrieve social media accounts connected to the ActiveTrail account.

Get Webhook by ID

Tool to retrieve detailed information about a specific webhook by its unique identifier.

Get Webhooks

Tool to list account webhooks with optional filtering.

Get Webhook Parameters

Tool to retrieve webhook parameters for a specified webhook ID.

Import New Contacts

Tool to import new contacts into a group in ActiveTrail.

List Landing Pages

Tool to retrieve landing pages from ActiveTrail.

List Mailing Lists

Tool to list mailing lists from ActiveTrail account.

List Members Of A Mailing List

Tool to get all information of your mailing list members by page, limited to 50 contacts each time.

List Sign-Up Forms

Tool to retrieve signup forms from the ActiveTrail account.

List SMS Campaigns

Tool to retrieve SMS campaigns with optional filtering by date, search term, and type.

Get Specific SMS Campaign

Tool to retrieve a specific SMS campaign by ID including full details like content, status, targeting, and scheduling.

List Transactional SMS Messages

Tool to retrieve all SMS transactional messages with pagination support.

Create Campaign from Template

Tool to create a campaign using a specific template.

Create Template Category

Tool to create a new template category in ActiveTrail.

Update Webhook Parameter

Tool to update a given webhook parameter configuration in your ActiveTrail account.

Send Test Webhook Request

Tool to send a test webhook request with configurable URL and parameters.

Update content category

Tool to update a specific content category by ID.

Update Campaign Details

Tool to update campaign details in ActiveTrail.

Update Campaign Segment Settings

Tool to update campaign sending settings including groups and sending restrictions.

Remove Contact from Mailing List

Tool to remove a contact from a mailing list in ActiveTrail.

Remove external contacts from group

Tool to remove contacts from a group via external ID.

Test Webhook

Tool to send a test request for a given webhook by its ID.

Update Campaign

Tool to update draft campaigns in ActiveTrail.

Update Campaign Design

Tool to update the design and HTML content of an email campaign in ActiveTrail.

Update Campaign Scheduling

Tool to configure send schedule for draft campaigns.

Update Campaign Details

Tool to update a campaign's details by ID in ActiveTrail.

Update Campaign Template

Tool to update the template associated with an email campaign in ActiveTrail.

Update Contact

Tool to update an existing contact's information by ID.

Update Contact Details

Tool to update an existing contact's information in ActiveTrail.

Update Group

Tool to update an existing group by ID.

Rename Group

Tool to rename a group's name in ActiveTrail.

Update Order

Tool to modify existing orders in ActiveTrail commerce system.

Update Smart Code Site

Tool to update an existing Smart Code site in ActiveTrail.

Update Template

Tool to update an existing template in ActiveTrail account.

Update Template Content

Tool to update the HTML content of an email template in ActiveTrail.

Update Webhook

Tool to update an existing webhook configuration in ActiveTrail.

FRAMEWORKS

How to build ActiveTrail MCP Agent with another framework

OpenAI Agents SDK logo

OpenAI Agents SDK

Use ActiveTrail MCP with OpenAI Agents SDK

Claude Agent SDK logo

Claude Agent SDK

Use ActiveTrail MCP with Claude Agent SDK

Claude Code logo

Claude Code

Use ActiveTrail MCP with Claude Code

Claude Cowork logo

Claude Cowork

Use ActiveTrail MCP with Claude Cowork

Codex logo

Codex

Use ActiveTrail MCP with Codex

OpenClaw logo

OpenClaw

Use ActiveTrail MCP with OpenClaw

Hermes logo

Hermes

Use ActiveTrail MCP with Hermes

CLI logo

CLI

Use ActiveTrail MCP with CLI

Google ADK logo

Google ADK

Use ActiveTrail MCP with Google ADK

LangChain logo

LangChain

Use ActiveTrail MCP with LangChain

Vercel AI SDK logo

Vercel AI SDK

Use ActiveTrail MCP with Vercel AI SDK

LlamaIndex logo

LlamaIndex

Use ActiveTrail MCP with LlamaIndex

CrewAI logo

CrewAI

Use ActiveTrail MCP with CrewAI

FAQ

Frequently asked questions

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

Yes, you can. Mastra AI 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 ActiveTrail tools.

Yes, absolutely. You can configure which ActiveTrail 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 ActiveTrail data and credentials are handled as safely as possible.

Start with ActiveTrail.It takes 30 seconds.

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

Start building
Customer stories

Teams ship real agents on Composio

GET STARTED FOR FREEBOOK A DEMO
agent.aiZoomLettaGleanHubSpotAWSWabi

Karan skipped his own birthday party to fix our critical issue. It was 10pm and he diverted his Waymo to help us instead. This really sets the bar — it shows the commitment you need when users rely on your software.

Harsha Gaddipati
Harsha Gaddipati
Co-founder, Slashy

A lot of students tell us that the moment their connected tools start talking to each other inside Opennote feels almost magical. The agent just knows them, and it's immensely helped keep new users on the platform.

Abhi Arya
Abhi Arya
Co-founder, Opennote

We chose Composio over Pipedream because it delivered depth where it mattered — niche tools and tricky edge cases other platforms simply ignored. That gave us confidence to scale without compromising.

Nirman Dave
Nirman Dave
CEO, Zams

As a solo builder, shipping fast is life or death. The only way I can outcompete incumbents is by outmanoeuvring them. Getting bogged down managing agent auth would have been a death sentence.

Ryan Yu
Ryan Yu
Founder, Extra Thursday

Before Composio, adding tool integrations was slow and resource-intensive. Each one could take weeks of engineering time, and maintaining them meant constantly keeping up with API changes.

Tomisin Jenrola
Tomisin Jenrola
Founder & CEO, SwarmZero

With hands-on help from their founder, we integrated Gmail and Google Drive in just 30 minutes. This level of personal support and commitment is exactly what startups should strive for.

Jerome Leclanche
Jerome Leclanche
Co-Founder, Ingram Technologies