How to Use the Aimtell MCP in OpenAI Agents SDK

Q: Can my OpenAI Agents SDK system run campaigns based on subscriber traits?

Yes. Your agent uses listsegments to find the right audience and then modifies traits with addsubscriberattribute. This lets the agent dynamically group users based on their behavior.

Q: How do I list active push campaigns?

Your agent invokes listcampaigns or listtriggeredcampaigns to get a clean list of all active push templates. This allows the model to select the best campaign for a specific user segment.

Trigger push campaigns and manage subscribers directly within your OpenAI Agents SDK production pipelines.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Aimtell MCP to OpenAI Agents SDK

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Target users with OpenAI Agents SDK guardrails

`add_subscriber_attribute` updates subscriber profiles with custom tags based on live chat conversations. Your agent parses user intent, then applies these traits to segment your audience. This MCP Server runs within your sandbox, keeping client interactions safe. You prevent rogue updates by validating attributes before committing them to your push database.

Track push performance in real time

`get_campaign_performance` pulls click rates and delivery stats straight into your agent's runtime. Instead of manually checking dashboards, your agent monitors active campaigns and flags underperforming notifications. Tracing via the OpenAI dashboard lets you see exactly when and why an agent requested these metrics. You get clear visibility into every API call without guessing which agent triggered the request.

Send targeted alerts automatically

`send_one_off_notification` pushes urgent updates to specific subscriber segments when critical events occur. Your agent evaluates current user data, selects the right segment, and fires the notification instantly. Using the OpenAI Agents SDK means you can hand off the task from a general triage agent to a specialized marketing agent. This division of labor keeps your notification logic clean and easy to debug.

Setup guide

Set up Aimtell 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 Aimtell tools at runtime.
3

Create your Agent

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

Run the agent

Call Runner.run(agent, prompt) to execute. The agent invokes the appropriate Aimtell 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="Aimtell Agent",
            instructions="You have access to Aimtell 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 Aimtell. 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 Aimtell 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 Aimtell MCP in OpenAI Agents SDK

Install the OpenAI agents package and register the MCP Server URL in your agent configuration. The SDK automatically discovers the tools and exposes them to your agent.

Yes. Your agent uses `list_segments` to find the right audience and then modifies traits with `add_subscriber_attribute`. This lets the agent dynamically group users based on their behavior.

Yes, the SDK provides built-in guardrails that intercept tool calls before they run. You can inspect the parameters for `send_one_off_notification` before the agent fires the push.

Your agent invokes `list_campaigns` or `list_triggered_campaigns` to get a clean list of all active push templates. This allows the model to select the best campaign for a specific user segment.

All traffic passes through a secure V8 isolate sandbox on Vinkius. Your API keys and subscriber details are never exposed to the LLM or stored outside your session.

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