How to Use the Cometly MCP in OpenAI Agents SDK

Track ad attribution and monitor campaigns directly inside 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 Cometly MCP to OpenAI Agents SDK

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Automate attribution tracking in OpenAI Agents SDK

The `track_event` tool sends conversion data directly to your Cometly dashboard from your OpenAI Agents SDK workflow. Your agent watches user actions in real-time and instantly registers purchases or sign-ups without manual API calls. By calling `track_purchase` and `track_lead`, the agent logs every conversion step. This gives you instant attribution mapping inside your production pipeline, keeping your marketing data fresh and accurate.

Extract campaign performance metrics instantly

The `get_campaign_stats` tool pulls raw performance data for any active ad campaign directly into your runtime. Your agent reads actual spend and conversion metrics to make immediate optimization decisions. Running `list_campaigns` lets the agent scan active campaigns across all connected platforms. It stops the guesswork by handing your agent the hard numbers it needs to compare ad sets.

Map customer journeys with Cometly MCP Server

The `list_contacts` tool retrieves complete customer journey paths and attributed contact histories for your agent to analyze. This exposes exactly which touchpoints drove the final sale. Your agent uses `list_ad_accounts` and `list_events` to map your entire marketing structure. It builds a complete picture of your ad setup without you writing custom database queries.

Setup guide

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

Create your Agent

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

Run the agent

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

Run pip install openai-agents and initialize the server using MCPServerStreamableHttp pointing to your Vinkius endpoint. Pass this instance into your Agent constructor within an async context manager.

Yes, you can set cacheToolsList=True to optimize tool discovery performance. This prevents your agents from repeatedly querying the server schema during high-frequency tracking loops.

You can set up a specialized tracking agent that only has access to track_event and track_purchase. When a lead converts, your main coordinator agent hands off the task to this tracking specialist.

Yes. The MCP Server provides built-in guardrails that let you validate and intercept tool calls like get_campaign_stats before they execute.

Your customer journey profiles and contact details are processed through secure, ephemeral V8 isolates on Vinkius. No attribution data is stored on the transport layer, keeping your raw customer contact details isolated.

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