How to Use the Mailtrap MCP in Vercel AI SDK

Q: How do I stream Mailtrap sandbox emails in Vercel AI SDK?

Use createMCPClient to connect to the server endpoint. Pass the tools from mcpClient.tools() into streamText. Your agent will call listsandboxmessages and stream the results directly to your React components.

Q: Can Vercel AI SDK clean my Mailtrap inbox automatically?

Yes. Your agent calls clearsandboxinbox when you ask it to reset the test environment. You can trigger this action with a simple chat prompt or tie it to a button in your custom admin dashboard.

Stream real-time email sandbox logs and delivery status directly into Next.js apps 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 Mailtrap MCP to Vercel AI SDK

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Sandbox isolation for Vercel AI SDK

The Mailtrap MCP Server exposes direct virtual inbox control to your Next.js frontend through `list_sandboxes` and `list_sandbox_messages`. Your Vercel AI SDK agent reads captured test emails, checks HTML structures, and verifies headers directly within your React chat interface. Instead of waiting for a backend poller, you stream these Mailtrap sandbox states directly to your UI components using the SDK. This prevents Next.js developers from accidentally triggering live emails during staging runs while letting them inspect rendering issues on the fly.

Real-time HTML preview streaming

Your Vercel AI SDK application uses `get_message_html` to fetch the raw HTML of any captured Mailtrap message. The AI client immediately streams this payload into a sandboxed Next.js iframe, letting developers preview email layouts directly inside their chat workspace. This setup eliminates the need to switch tabs to an external Mailtrap inbox. By combining `get_message_details` with this HTML stream, your Vercel AI SDK agent checks for broken links and missing images before you ship.

Automated domain status checks

The Mailtrap server provides `get_domain_status` and `list_verified_domains` to track your sending infrastructure directly from Vercel Edge Functions. Your Vercel AI SDK agent monitors DNS records, SPF validation, and DKIM alignment in real-time. You query these Mailtrap endpoints to verify domain setup during Next.js deployment steps. The agent flags unverified domains instantly, stopping failed delivery runs before they impact your actual customers.

Setup guide

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

Use `createMCPClient` to connect to the server endpoint. Pass the tools from `mcpClient.tools()` into `streamText`. Your agent will call `list_sandbox_messages` and stream the results directly to your React components.

Yes. Your agent calls `clear_sandbox_inbox` when you ask it to reset the test environment. You can trigger this action with a simple chat prompt or tie it to a button in your custom admin dashboard.

The SDK executes tool calls as standard promises. If Mailtrap returns a 429 rate limit error, the SDK passes that error to your agent. You should handle retries at the application level or use edge middleware to throttle requests.

No. The server runs in a managed sandbox on Vinkius. Your Vercel AI SDK application connects to it remotely via HTTP, removing the need to run local background processes or manage SMTP configurations on your machine.

The server runs in a zero-trust V8 sandbox on Vinkius. Your actual email payloads, sandboxes, and domain records are never cached or stored on Vinkius servers. All data streams directly from Mailtrap to your local AI client using secure, encrypted transport.

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