How to Use the Loops MCP in OpenAI Agents SDK

Q: Can my OpenAI Agents SDK handle suppression checks with Loops?

Yes, the agent uses getcontactsuppression to check if an email address is blocked before executing any outbound steps. It prevents your agent from hitting hard bounces and hurting your sender score.

Q: How does OpenAI Agents SDK handle Loops event triggers?

The agent calls sendevent with a specific event name and user identifier to kick off automated marketing journeys. This lets you move users through onboarding sequences based on agent interactions.

Q: How can I verify that my API key is configured correctly?

Run the testapikey tool directly through your agent to verify connection status. It returns a simple pass or fail so you don't run into authentication errors mid-run.

Trigger Loops transactional emails and sync contact states directly from your production 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 Loops MCP to OpenAI Agents SDK

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Run Loops transactional emails through OpenAI Agents SDK

The `send_transactional_email` tool lets your agent dispatch template-driven emails right from your Python code block. When your production agent detects a completed onboarding step, it hits this endpoint with the exact template variables required. You don't write custom API wrapper logic. The OpenAI Agents SDK auto-discovers this tool, mapping validation constraints directly to your Loops transactional setup so the agent never sends malformed payload variables.

Maintain user lists using this specialized MCP Server

This MCP Server exposes contact-level control so your agent can track user preferences dynamically. Tools like `create_contact`, `update_contact`, and `delete_contact` let your system sync marketing states as conversations happen. The agent detects when a user wants to subscribe, pulls their details, and adds them to a specific list. It keeps your marketing database aligned with actual user intent during live chats.

Verify recipient status before sending

The `get_contact_suppression` tool checks if a recipient has opted out before your agent attempts to trigger an automated message. Your agent runs this check via the MCP interface to protect your domain reputation. Combining this with `find_contact` ensures your OpenAI Agents SDK doesn't waste API quota on inactive or blacklisted email records. The agent can route suppressed users to alternative channels instead of failing silently.

Setup guide

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

Create your Agent

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

Run the agent

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

Install the package with pip install openai-agents and create an MCPServerStreamableHttp instance using the target URL. Pass this instance in the mcp_servers list when initializing your Agent, and set cacheToolsList=True to speed up startup.

Yes, the agent uses `get_contact_suppression` to check if an email address is blocked before executing any outbound steps. It prevents your agent from hitting hard bounces and hurting your sender score.

The agent calls `send_event` with a specific event name and user identifier to kick off automated marketing journeys. This lets you move users through onboarding sequences based on agent interactions.

Run the `test_api_key` tool directly through your agent to verify connection status. It returns a simple pass or fail so you don't run into authentication errors mid-run.

The server only processes the raw email addresses and contact metadata you pass to tools like `create_contact`. All traffic runs over encrypted HTTPS, and the Vinkius sandbox ensures no customer data is ever persisted locally.

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