How to Use the No2Bounce MCP in OpenAI Agents SDK

Build production-ready email validation agents with No2Bounce and the 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 No2Bounce MCP to OpenAI Agents SDK

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Push massive lists through OpenAI Agents

The `validate_bulk` tool accepts raw email arrays directly from your Python agent and returns a tracking ID. You pass the dirty list, and the OpenAI Agents SDK automatically maps the tool call to the No2Bounce MCP Server. The SDK includes built-in guardrails, so you can enforce hard limits on list sizes before the agent even attempts the request. That means no runaway API costs or blocked accounts when dealing with massive datasets.

Track validation progress asynchronously

The `get_validation_status` tool lets your agent check on the background validation job using the provided tracking ID. It pulls back the exact status, telling your system whether the list is still processing or ready for export. You don't have to write custom polling logic. You configure your agent to hand off the tracking ID to a specialized monitoring agent, which handles the status checks while your main process continues working.

Trace every bounce and clean result

The `validate_bulk` and `get_validation_status` tools generate complete execution logs in the OpenAI dashboard. You see exactly what the first tool received and what the second tool returned. This visibility is critical when debugging why a specific email got flagged as a hard bounce. You get a complete paper trail of the MCP execution without digging through server logs.

Setup guide

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

Create your Agent

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

Run the agent

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

Install the openai-agents package via pip. Create an MCPServerStreamableHttp object pointing to the Vinkius endpoint, and pass it into your agent's mcp_servers array.

Yes. You can define safety constraints that prevent the agent from calling the bulk validation tool if the input data lacks required formatting or exceeds your defined batch size.

Yes. The agent grabs the tracking ID from the first tool and knows it needs to use the status tool later to fetch the final results.

The server handles the tool definitions and types automatically. You set cacheToolsList=True and your agent instantly understands how to validate emails without custom wrapper code.

Your raw email addresses are processed in memory within a V8 Isolate Sandbox. The server reads the addresses, checks their domain records, and drops the data the moment the job completes. No persistent storage.

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