How to Use the Zenvia Conversion MCP in Vercel AI SDK

Q: How do I search for Zenvia Conversion leads using Vercel AI SDK?

You can use the listprospects tool. Your agent client calls this and streams the results, letting you display all existing leads in real time on your page.

Q: Can Zenvia Conversion messages be sent with Vercel AI SDK?

Yup. You can send a direct message using sendmessage or blast out an official template via sendtemplate. The result streams right into your Next.js component.

Q: How do I get detailed info on a specific prospect using Vercel AI SDK?

You call getprospect and pass in the necessary ID. The agent processes this request, making the full profile details appear live on your frontend.

Q: Does Zenvia Conversion support listing labels with Vercel AI SDK?

Yes, you can run listlabels to fetch all available label types. This helps your agent categorize leads accurately as they appear in the UI.

Real-time AI actions for your Next.js frontend using Vercel AI SDK.

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 Vercel AI SDK

Create your Vinkius account to connect Zenvia Conversion to Vercel AI 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 Vercel AI SDK

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Create and Manage Leads

Need to capture a new contact? Use `create_lead` to add fresh details and an initial message directly into Zenvia Conversion. Your user's agent handles the full process, letting you stream that data straight into your React UI. You can also check out who you're dealing with by running `get_prospect`. This gives you detailed information on a specific lead without needing a dedicated page load.

View Account and Prospect Info

Start by checking the overall status of your account using `get_account`. It's a quick call that brings core details to your frontend. You can also pull a list of all existing leads with `list_prospects`. This gives you context right away, letting your agent build out more complex interactions in real time.

Communicate with Clients

Sending messages is simple. You can talk to a prospect using `send_message`. Better yet, if it's a standard announcement, use `send_template` to fire off an HSM message. The result streams into your UI instantly. Want to see what happened before? Run `list_interactions` to get a full history for any given prospect.

Setup guide

Set up Zenvia Conversion MCP in Vercel AI SDK

Prerequisites

Node.js 18+ and a TypeScript project
ai + @modelcontextprotocol/sdk packages
Active Vinkius subscription with a valid endpoint token

1

Install dependencies

Run npm install ai @modelcontextprotocol/sdk plus your preferred model provider (e.g. @ai-sdk/openai).
2

Create the Streamable HTTP transport

Use StreamableHTTPClientTransport with your Vinkius endpoint URL. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com.
3

Discover and use tools

Call mcpClient.tools() to auto-discover all Zenvia Conversion tools. Pass them directly to generateText() or streamText() — no manual schema definitions needed.
4

Works with any model provider

Swap openai("gpt-4o") for any AI SDK provider — Anthropic, Google, Mistral. The MCP tools work identically across all supported models.

index.ts

import { experimental_createMCPClient as createMCPClient } from "ai";
import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp";
import { generateText } from "ai";
import { openai } from "@ai-sdk/openai";

const transport = new StreamableHTTPClientTransport(
  new URL("https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp")
);

const mcpClient = await createMCPClient({ transport });
const tools = await mcpClient.tools();

const { text } = await generateText({
  model: openai("gpt-4o"),
  tools,
  prompt: "List recent Zenvia Conversion transactions",
});

console.log(text);
await mcpClient.close();

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 Vercel AI SDK

You can use the `list_prospects` tool. Your agent client calls this and streams the results, letting you display all existing leads in real time on your page.

Yup. You can send a direct message using `send_message` or blast out an official template via `send_template`. The result streams right into your Next.js component.

This server primarily handles contact details, prospect profiles, and message history. Specifically, it manages the data types related to leads and communications within Zenvia Conversion.

You call `get_prospect` and pass in the necessary ID. The agent processes this request, making the full profile details appear live on your frontend.

Yes, you can run `list_labels` to fetch all available label types. This helps your agent categorize leads accurately as they appear in the UI.

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