Where do I find my Aimtell API Key?

Log in to your Aimtell dashboard, navigate to **Settings** > **API Key**. You will find your unique authorization key there. It must be used in the `X-Authorization-Api-Key` header.

Can I send a notification to a specific segment?

Yes! Use the `send_one_off_notification` tool and specify the `segmentId`. Your agent will trigger the push alert to all subscribers currently in that segment.

Does this support tracking custom attributes?

Yes, you can use the `add_subscriber_attribute` tool to enrich subscriber profiles with custom data (like name or interests), which can then be used for dynamic content in notifications.

Aimtell MCP Server for OpenAI Agents SDK 10 tools — connect in under 2 minutes

Name: Aimtell
Availability: InStock
Author: Vinkius

openai.github.io/openai-agents-python/mcp

Built by Vinkius GDPR 10 Tools SDK

The OpenAI Agents SDK enables production-grade agent workflows in Python. Connect Aimtell through Vinkius and your agents gain typed, auto-discovered tools with built-in guardrails. no manual schema definitions required.

Get MCP Server for AI Agents

ASK AI ABOUT THIS MCP SERVER

Open in ChatGPT Open in Claude Open in Perplexity

Vinkius supports streamable HTTP and SSE.

python

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

async def main():
    # Your Vinkius token. get it at cloud.vinkius.com
    async with MCPServerStreamableHttp(
        url="https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    ) as mcp_server:

        agent = Agent(
            name="Aimtell Assistant",
            instructions=(
                "You help users interact with Aimtell. "
                "You have access to 10 tools."
            ),
            mcp_servers=[mcp_server],
        )

        result = await Runner.run(
            agent, "List all available tools from Aimtell"
        )
        print(result.final_output)

asyncio.run(main())

Fully ManagedVinkius Servers

60%Token savings

High SecurityEnterprise-grade

IAMAccess control

EU AI ActCompliant

DLPData protection

V8 IsolateSandboxed

Ed25519Audit chain

<40msKill switch

Stream every event to Splunk, Datadog, or your own webhook in real-time

* Every MCP server runs on Vinkius-managed infrastructure inside AWS - a purpose-built runtime with per-request V8 isolates, Ed25519 signed audit chains, and sub-40ms cold starts optimized for native MCP execution. See our infrastructure

About Aimtell MCP Server

Connect your Aimtell account to your AI agent to unlock professional web push notification management. From sending one-off alerts to specific subscribers to auditing segment criteria and monitoring real-time campaign analytics, your agent handles your re-engagement strategy through natural conversation.

The OpenAI Agents SDK auto-discovers all 10 tools from Aimtell through native MCP integration. Build agents with built-in guardrails, tracing, and handoff patterns. chain multiple agents where one queries Aimtell, another analyzes results, and a third generates reports, all orchestrated through Vinkius.

What you can do

Campaign Orchestration — List and manage push notification campaigns, including one-off, triggered, and API campaigns
Subscriber Management — Retrieve details for specific subscribers and update custom attributes for personalization
Segmentation Oversight — List and audit your subscriber segments to ensure your targeting is always precise
Real-time Analytics — Retrieve granular performance data (clicks, sends, conversions) for any campaign directly from chat
Multi-site Support — List and manage the different websites associated with your Aimtell account

The Aimtell MCP Server exposes 10 tools through the Vinkius. Connect it to OpenAI Agents SDK in under two minutes — no API keys to rotate, no infrastructure to provision, no vendor lock-in. Your configuration, your data, your control.

How to Connect Aimtell to OpenAI Agents SDK via MCP

Follow these steps to integrate the Aimtell MCP Server with OpenAI Agents SDK.

Install the SDK

Run pip install openai-agents in your Python environment

Replace the token

Replace [YOUR_TOKEN_HERE] with your Vinkius token from cloud.vinkius.com

Run the script

Save the code above and run it: python agent.py

Explore tools

The agent will automatically discover 10 tools from Aimtell

Why Use OpenAI Agents SDK with the Aimtell MCP Server

OpenAI Agents SDK provides unique advantages when paired with Aimtell through the Model Context Protocol.

Native MCP integration via `MCPServerSse`, pass the URL and the SDK auto-discovers all tools with full type safety

Built-in guardrails, tracing, and handoff patterns let you build production-grade agents without reinventing safety infrastructure

Lightweight and composable: chain multiple agents and MCP servers in a single pipeline with minimal boilerplate

First-party OpenAI support ensures optimal compatibility with GPT models for tool calling and structured output

Aimtell + OpenAI Agents SDK Use Cases

Practical scenarios where OpenAI Agents SDK combined with the Aimtell MCP Server delivers measurable value.

Automated workflows: build agents that query Aimtell, process the data, and trigger follow-up actions autonomously

Multi-agent orchestration: create specialist agents. one queries Aimtell, another analyzes results, a third generates reports

Data enrichment pipelines: stream data through Aimtell tools and transform it with OpenAI models in a single async loop

Customer support bots: agents query Aimtell to resolve tickets, look up records, and update statuses without human intervention

Aimtell MCP Tools for OpenAI Agents SDK (10)

These 10 tools become available when you connect Aimtell to OpenAI Agents SDK via MCP:

add_subscriber_attribute

Add custom data to subscriber

get_campaign_performance

Get campaign metrics

get_subscriber_details

Get subscriber metadata

list_api_campaigns

List API-triggered campaigns

list_campaigns

List push campaigns

list_segments

List subscriber segments

list_sites

List managed websites

list_subscribers

List site subscribers

list_triggered_campaigns

List automated campaigns

send_one_off_notification

Send an alert

Example Prompts for Aimtell in OpenAI Agents SDK

Ready-to-use prompts you can give your OpenAI Agents SDK agent to start working with Aimtell immediately.

"List all active segments in my Aimtell account."

"Show me the performance for campaign ID 12345."

"Send a one-off push to segment 9876 with title 'Special Offer' and body 'Get 20% off today only!'."

Troubleshooting Aimtell MCP Server with OpenAI Agents SDK

Common issues when connecting Aimtell to OpenAI Agents SDK through the Vinkius, and how to resolve them.

MCPServerStreamableHttp not found

Ensure you have the latest version: pip install --upgrade openai-agents

Agent not calling tools

Make sure your prompt explicitly references the task the tools can help with.

Aimtell + OpenAI Agents SDK FAQ

Common questions about integrating Aimtell MCP Server with OpenAI Agents SDK.

How does the OpenAI Agents SDK connect to MCP?

Use MCPServerSse(url=...) to create a server connection. The SDK auto-discovers all tools and makes them available to your agent with full type information.