How to Use the Zenvia Conversion MCP in OpenAI Agents SDK

Q: Can I get a list of prospects using Zenvia Conversion and OpenAI Agents SDK?

Yes, the listprospects tool handles that. You simply invoke it to retrieve every prospect currently tracked in your account. It's a straightforward call that gives you an immediate directory.

Q: Does this MCP Server support message templating for Zenvia Conversion and OpenAI Agents SDK?

Absolutely. The sendtemplate tool allows your agent to send standardized messages (HSM) to any prospect, ensuring brand consistency every time.

Use Zenvia Conversion with OpenAI Agents SDK for production-grade lead management.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Zenvia Conversion MCP to OpenAI Agents SDK

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Manage Leads and Contacts

The `create_lead` tool lets you build new leads by accepting contact details and an initial message. You can also keep track of existing contacts using `get_prospect` to pull detailed information about any specific person. This server exposes several key tools, including `list_prospects`, which retrieves a list of everyone in your account. It's perfect for building agents that need an overview before taking action.

Message and Interaction History

Need to communicate with prospects? Use the `send_message` tool to send direct messages, or use `send_template` if you're sending out a standardized message (HSM). You can also check past communications by calling `list_interactions` for any given prospect. This lets your agent build a full record. The tools support managing labels via `list_labels`, so you know exactly how to categorize every interaction.

Account and Group Oversight

The MCP Server gives your AI client visibility into the account structure itself. Call `get_account` for high-level account details, or use `list_agents` to see who's on the team. It also keeps tabs on internal organization by listing available agent groups via `list_groups`. This is critical when your agent needs context about permissions before it can run a task.

Setup guide

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

Create your Agent

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

Run the agent

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

You pass the server instance to the Agent constructor. Your agent will auto-discover all available tools, so you don't have to hardcode anything. The built-in guardrails validate actions before they run.

Yes, the `list_prospects` tool handles that. You simply invoke it to retrieve every prospect currently tracked in your account. It's a straightforward call that gives you an immediate directory.

This MCP Server primarily deals with contact details and messages. You are managing leads, prospects, and interaction records within the Zenvia Conversion system.

Absolutely. The `send_template` tool allows your agent to send standardized messages (HSM) to any prospect, ensuring brand consistency every time.

The unique power here is the built-in guardrails. They validate agent actions before execution, which means you get safety constraints for your deployed product.

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