How to Use the Cordial MCP in OpenAI Agents SDK

Q: How does the OpenAI Agents SDK trace Cordial API calls?

Every tool execution, such as calling getsubscriberprofile, is tracked inside your OpenAI developer dashboard. You can inspect the exact payload sent and the JSON response returned from the Cordial platform.

Control Cordial marketing campaigns safely in production with OpenAI Agents SDK auto-discovering your audience tools.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Cordial MCP to OpenAI Agents SDK

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Safe Audience Updates with OpenAI Agents SDK

Your OpenAI Agents SDK can modify Cordial subscriber records without risking database corruption. When your agent accesses this MCP Server to call `upsert_subscriber`, the SDK runs built-in guardrails to validate the email or device token formats before hitting the Cordial API. If your OpenAI agent tries to push a bad contact, the SDK halts execution. You get full visibility of these validation steps on your OpenAI tracing dashboard, keeping your Cordial contact segments clean.

Automated Campaign Routing via Agent Handoffs

Let a specialized OpenAI agent handle Cordial campaign queries while another handles subscriber data. The SDK routes tasks like `search_campaigns_by_name` and `list_marketing_campaigns` to the right sub-agent. One agent can look up active performance metrics, then hand off the data to an OpenAI copywriter agent. This second agent drafts follow-ups based on the active automated message workflows found by `list_automation_messages` in Cordial.

Dynamic Personalization with Zero-Config Tools

The OpenAI Agents SDK auto-discovers every tool in this Cordial MCP Server instantly. Your agent gains immediate access to `list_supplementary_data` to pull custom external tables for Cordial message personalization. You do not need to write manual tool definitions for your OpenAI agent. The agent reads the available metadata and immediately knows how to query `list_audience_segments` to target the right Cordial user groups.

Setup guide

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

Create your Agent

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

Run the agent

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

Just pass the MCP Server streamable HTTP URL into your agent initialization code. The SDK automatically registers tools like `list_contacts` and `get_account_details` without manual schema mapping.

Yes, you can set boundaries by configuring agent-level system instructions or wrapping the server endpoint. This prevents your OpenAI agent from running destructive updates via `upsert_subscriber` while still allowing read-only actions.

Every tool execution, such as calling `get_subscriber_profile`, is tracked inside your OpenAI developer dashboard. You can inspect the exact payload sent and the JSON response returned from the Cordial platform.

Absolutely, you can set up one agent to find active campaigns with `list_marketing_campaigns` and another to manage subscriber lists. The SDK manages the handoff between these specialized agents smoothly.

All subscriber profile data, including email addresses and device tokens fetched via `get_subscriber_profile`, is processed in a zero-trust sandbox. The SDK communicates directly with the API, and your raw customer identifiers are never cached or stored on Vinkius 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