How to Use the ActiveTrail MCP in OpenAI Agents SDK

Q: Does this MCP Server support tracking for campaign drafting?

Yes, the listcampaigns tool returns both drafts and sent campaigns. Your agent can read these drafts, suggest edits, and prepare the next send run directly within your Python workflow.

Run safe, production-grade ActiveTrail email and SMS campaigns using the OpenAI Agents SDK.

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 OpenAI Agents SDK

Create your Vinkius account to connect ActiveTrail to OpenAI Agents SDK 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 OpenAI Agents SDK

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Safe subscriber sync and creation

The `create_contact` tool lets your OpenAI agents add new subscribers directly to your ActiveTrail lists. Instead of letting an agent run wild, you can wrap this tool in the SDK's built-in guardrails to verify the email address format before any API write action occurs. This MCP Server keeps your production pipelines clean. If a user inputs a bad email during a chat session, the agent catches it at the boundary before calling the server, preventing wasted API calls and maintaining database hygiene.

Multi-agent campaign audits via OpenAI Agents SDK

The `list_campaigns` tool exposes all active and draft marketing campaigns to your specialized agents. You can set up a routing architecture where one agent pulls the raw campaign data and hands it off to a specialized copywriter agent for optimization. All these handoffs and tool executions show up in your OpenAI tracing dashboard. You see exactly when the agent checked the drafts, what it changed, and how it decided to structure the next newsletter.

Targeted SMS alerts with built-in guardrails

The `send_sms` tool enables your agent to send urgent text notifications directly through the ActiveTrail gateway. By registering this MCP Server, your OpenAI agents can trigger time-sensitive alerts based on real-world triggers. Because you are running this in a production environment, you can cache the tool schema using the SDK's caching feature. This keeps your agent fast, responsive, and ready to text users without latency spikes.

Setup guide

Set up ActiveTrail MCP in OpenAI Agents SDK

Prerequisites

Python 3.10+ installed
openai-agents package (pip install openai-agents)
Active Vinkius subscription with a valid endpoint token

1

Install the SDK

Run pip install openai-agents to install the OpenAI Agents SDK. The MCP integration is built-in — no extra dependencies needed.
2

Connect via SSE transport

Use MCPServerSse with your Vinkius endpoint URL. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com. The SDK auto-discovers all ActiveTrail tools at runtime.
3

Create your Agent

Pass the MCP to Agent(mcp_servers=[server]). The agent receives ActiveTrail tools as native definitions — JSON schemas resolve automatically.
4

Run the agent

Call Runner.run(agent, prompt) to execute. The agent invokes the appropriate ActiveTrail tools and returns structured results. Copy the full example on the right to get started.

agent.py

import asyncio
from agents import Agent, Runner
from agents.mcp import MCPServerSse

async def main():
    async with MCPServerSse(
        url="https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    ) as server:
        agent = Agent(
            name="ActiveTrail Agent",
            instructions="You have access to ActiveTrail tools.",
            mcp_servers=[server],
        )
        result = await Runner.run(agent, "List recent transactions")
        print(result.final_output)

asyncio.run(main())

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 OpenAI Agents SDK

Use the MCPServerStreamableHttp class to point to your Vinkius endpoint and pass it to your Agent constructor. Make sure to set cacheToolsList=True to avoid fetching the tool list on every single turn.

Yes, you can control tool access at the SDK layer by filtering the discovered tools before passing them to the Agent. This prevents your agent from accidentally calling send_sms when it only needs to read drafts.

The SDK relies on your agent's retry logic and your Vinkius gateway configuration to handle API limits gracefully. When list_contacts returns a large payload, the agent processes the batch sequentially to avoid hitting ActiveTrail rate boundaries.

Yes, the list_campaigns tool returns both drafts and sent campaigns. Your agent can read these drafts, suggest edits, and prepare the next send run directly within your Python workflow.

Your subscriber emails and phone numbers are protected by Vinkius's zero-trust V8 sandbox. The SDK connects over an encrypted HTTP stream, meaning your customer database is never cached or stored on external servers.

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