How to Use the ActiveTrail MCP in Mastra AI

Q: How do I connect Mastra AI to the ActiveTrail MCP Server?

Install @mastra/mcp@latest via npm. Initialize a new client with your Vinkius URL and pass the returned tools directly to your agent.

Q: Can Mastra AI pull my subscriber lists from ActiveTrail?

Yes, it can. Agents use the listcontacts operation to fetch the complete directory. Workflows feed that data into subsequent steps.

Build resilient marketing workflows with Mastra AI and the ActiveTrail MCP Server.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect ActiveTrail MCP to Mastra AI

Create your Vinkius account to connect ActiveTrail to Mastra AI and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup ActiveTrail with Mastra AI

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Branch logic for ActiveTrail campaigns

Hardcoding marketing logic breaks when APIs fail. Mastra AI lets you build a workflow that tries to read segments using `list_groups`. If the call times out, the framework's built-in engine applies exponential backoff and tries again. You can route the flow based on the result. Finding a specific segment might trigger the `list_campaigns` tool, while a missing group routes the agent to notify an admin.

Add subscribers with automatic retries

Dropping a lead because of a network blip costs money. When your agent calls `create_contact`, Mastra handles the execution through a resilient layer. It requires an email address, but workflows can pass full personal details. This framework auto-detects the transport layer for the MCP Server. Developers just spread `mcpClient.listTools()` into the agent configuration and deploy to their cloud provider in one command.

Require approval for Mastra AI texts

Sending automated text messages carries risk. Managers configure the `send_sms` tool with `requireToolApproval` so a human reviews the phone number and body text before anything leaves the gateway. Agents prepare the payload based on user activity. Execution pauses until a real person clicks approve, ensuring no rogue notifications hit your customer base.

Setup guide

Set up ActiveTrail MCP in Mastra AI

Prerequisites

Node.js 18+ and a TypeScript project
@mastra/mcp + @mastra/core packages
Active Vinkius subscription with a valid endpoint token

1

Install dependencies
Run npm install @mastra/mcp @mastra/core plus your preferred model provider (e.g. @ai-sdk/openai).
2

Configure the MCPClient
Create an MCPClient with your Vinkius endpoint as a URL object. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com.
3

Discover and inject tools
Call mcpClient.listTools() and spread the result into your agent's tools object. All ActiveTrail tools become native Mastra tools.
4

Run with any model
Swap openai("gpt-4o") for any AI SDK-compatible provider. Call agent.generate() and the agent routes tool calls through MCP automatically.

agent.ts

import { MCPClient } from "@mastra/mcp";
import { Agent } from "@mastra/core/agent";
import { openai } from "@ai-sdk/openai";

const mcpClient = new MCPClient({
  id: "activetrail-mcp-client",
  servers: {
    "activetrail-mcp": {
      url: new URL(
        "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
      ),
    },
  },
});

const agent = new Agent({
  name: "ActiveTrail Agent",
  model: openai("gpt-4o"),
  instructions: "You have access to ActiveTrail tools.",
  tools: {
    ...(await mcpClient.listTools()),
  },
});

const result = await agent.generate(
  "List recent ActiveTrail transactions"
);
console.log(result.text);

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by ActiveTrail. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect ActiveTrail now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about ActiveTrail MCP in Mastra AI

Install `@mastra/mcp@latest` via npm. Initialize a new client with your Vinkius URL and pass the returned tools directly to your agent.

Yes, it can. Agents use the `list_contacts` operation to fetch the complete directory. Workflows feed that data into subsequent steps.

Mastra automatically detects whether the endpoint uses SSE or Streamable HTTP. Configuration happens under the hood for this MCP Server.

Built-in engines catch the error and trigger an automatic retry. Custom backoff intervals prevent hammering the endpoint during an outage.

Campaign metrics and subscriber emails stay isolated. Vinkius runs the execution inside a zero-trust sandbox that destroys the environment after the run finishes.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript