How to Use the Mailinator MCP in Vercel AI SDK

Q: How do I connect the Mailinator MCP Server to the Vercel AI SDK?

Install @ai-sdk/mcp and set up an HTTP transport. Call createMCPClient with your connection details, then pass the tools to your streamText function.

Q: Can the Vercel AI SDK stream Mailinator attachments to my UI?

Yes. When your agent calls listmessageattachments, the framework streams that JSON data back to your React components in real-time.

Stream live email testing data directly into your React components using the 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 Mailinator MCP to Vercel AI SDK

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Stream Inboxes with Vercel AI SDK

Pulling incoming test emails instantly is what the `list_inbox_messages` tool does best. Your users see messages arrive without refreshing the page. The Vercel AI SDK streams this data straight into your UI as the agent fetches it through the MCP Server. You don't have to build custom polling logic. When a test fires, your application grabs the payload via `get_message_content` and renders it live on screen.

Simulate Traffic and Parse Attachments

Pushing simulated traffic into a disposable inbox requires the `inject_test_message` tool. Testing an email parser needs actual data. Your frontend application can trigger this directly from a button click. If your application handles files, pass the `list_message_attachments` tool to your agent. It pulls the file metadata and streams the results back to your Next.js frontend immediately.

Manage Private Testing Domains

Fetching your testing environments programmatically happens through the `list_private_domains` tool. Keeping track of disposable domains usually means logging into a separate dashboard. Call it to show users their available testing environments right in your app. You can also keep an eye on your API limits. The `get_usage_statistics` tool lets your agent warn users if they hit their message caps during a heavy testing session.

Setup guide

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

Install `@ai-sdk/mcp` and set up an HTTP transport. Call `createMCPClient` with your connection details, then pass the tools to your `streamText` function.

Yes. When your agent calls `list_message_attachments`, the framework streams that JSON data back to your React components in real-time.

It runs perfectly on the edge. The MCP connection relies on standard HTTP calls, so you can fetch data without heavy Node.js dependencies.

You build the logic directly into your app. Read the current limits using `get_usage_statistics` before triggering heavy test runs.

This integration only reads emails and SMS messages sent to your configured disposable domains. It never touches your production systems or personal inboxes.

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