How to Use the Mailosaur MCP in Vercel AI SDK

Q: How do I search for emails using Mailosaur and Vercel AI SDK?

Use the searchservermessages tool within your agent definition. Pass the server ID and your criteria to get results back in your stream.

Q: Can Mailosaur and Vercel AI SDK handle large volumes of test mail?

Yes. Just ensure you manage your inbox lifecycle using deletespecificmessage to keep your workspace performant.

Stream real-time email and SMS verification directly into your Vercel AI SDK frontends.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Mailosaur MCP to Vercel AI SDK

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Live inbox validation in your UI

Pipe email data straight to your user interface without waiting on background jobs. Use `list_server_messages` to pull new arrivals into your stream immediately. Your end users see the verification status update as it happens. It's the fastest way to confirm account sign-ups or password resets in a live session.

Automated server cleanup for Vercel AI SDK

Keep your testing environments lean by purging data after every test run. Use `clear_server_inbox` to wipe everything clean before the next test cycle begins. This prevents state bleed between your automated tests. It ensures your next check starts from a known, empty state every single time.

Targeted message extraction

Drill down into specific test emails with `get_message_content`. This MCP Server lets your agent find the exact body text or links needed for your flow. Stop guessing if the mail arrived. Your agent now has eyes on the inbox, pulling the precise data needed to complete the user's task.

Setup guide

Set up Mailosaur 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 Mailosaur 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 Mailosaur 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 Mailosaur. 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 Mailosaur 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 Mailosaur MCP in Vercel AI SDK

Use the `search_server_messages` tool within your agent definition. Pass the server ID and your criteria to get results back in your stream.

Yes. Just ensure you manage your inbox lifecycle using `delete_specific_message` to keep your workspace performant.

Absolutely. The MCP protocol integrates with the SDK stream, allowing your UI to render message content as it arrives from the server.

Emails are stored on the Mailosaur infrastructure. Your Vercel AI SDK client only retrieves them when you invoke a tool call.

Yes. Only you and your agent have access to the virtual servers you create. Your email content is never logged or exposed to other users.

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

Mastra AI sdk-typescript

Start using the Mailosaur MCP today

We host it, we monitor it, we maintain it. You just paste one token.

Get started