How to Use the Mailtrap MCP in Mastra AI

Q: How do I register Mailtrap tools inside Mastra AI?

Instantiate the MCPClient with your Vinkius endpoint URL. Call mcpClient.listTools() and spread those tools directly into your Mastra agent configuration.

Q: How do I test HTML layouts using Mastra AI and Mailtrap?

Use getmessagehtml inside a Mastra workflow step to fetch the raw HTML. The agent analyzes the code for broken tags or CSS issues and alerts your team if it finds rendering errors.

Run automated email testing workflows and multi-step retries with Mastra AI and Mailtrap.

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 Mastra AI

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Conditional email testing workflows

The Mailtrap MCP Server integrates with Mastra workflows to run automated email verification runs via `send_test_email` and `list_sandbox_messages`. Your Mastra agent triggers a test email, waits for it to hit the Mailtrap sandbox, and checks the status automatically. If the test email fails to arrive, Mastra's workflow engine executes retries with exponential backoff. You write the logic once, and the Mastra agent handles the entire Mailtrap verification loop without manual testing.

Automated inbox cleanup in Mastra AI

This integration uses `clear_sandbox_inbox` to reset your Mailtrap testing environment before running a new Mastra workflow. Your Mastra agent clears old messages, runs the test suite, and then uses `list_sandbox_messages` to verify only the new emails exist. This prevents old test runs from polluting your Mastra assertions. If an assertion fails, the Mastra agent uses `get_message_details` to inspect the exact Mailtrap payload that caused the failure.

Production sending with human approval

The Mailtrap server exposes `send_production_email` for live customer communications managed by Mastra agents. By configuring Mastra's `requireToolApproval` setting, you force a human-in-the-loop check before any production email leaves the system. The Mastra agent drafts the message based on system events, but waits for your green light. Once approved, the agent fires the Mailtrap email and checks delivery status using `list_verified_domains`.

Setup guide

Set up Mailtrap MCP in Mastra AI

Prerequisites

Node.js 18+ and a TypeScript project
@mastra/mcp + @mastra/core packages
Active Vinkius subscription with a valid endpoint token

1

Install dependencies
Run npm install @mastra/mcp @mastra/core plus your preferred model provider (e.g. @ai-sdk/openai).
2

Configure the MCPClient
Create an MCPClient with your Vinkius endpoint as a URL object. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com.
3

Discover and inject tools
Call mcpClient.listTools() and spread the result into your agent's tools object. All Mailtrap tools become native Mastra tools.
4

Run with any model
Swap openai("gpt-4o") for any AI SDK-compatible provider. Call agent.generate() and the agent routes tool calls through MCP automatically.

agent.ts

import { MCPClient } from "@mastra/mcp";
import { Agent } from "@mastra/core/agent";
import { openai } from "@ai-sdk/openai";

const mcpClient = new MCPClient({
  id: "mailtrap-mcp-client",
  servers: {
    "mailtrap-mcp": {
      url: new URL(
        "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
      ),
    },
  },
});

const agent = new Agent({
  name: "Mailtrap Agent",
  model: openai("gpt-4o"),
  instructions: "You have access to Mailtrap tools.",
  tools: {
    ...(await mcpClient.listTools()),
  },
});

const result = await agent.generate(
  "List recent Mailtrap transactions"
);
console.log(result.text);

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 Mastra AI

Instantiate the `MCPClient` with your Vinkius endpoint URL. Call `mcpClient.listTools()` and spread those tools directly into your Mastra agent configuration.

Yes. Mastra has built-in retry logic with exponential backoff. If `get_message_details` fails due to network latency, Mastra retries the tool call automatically based on your workflow rules.

Use `get_message_html` inside a Mastra workflow step to fetch the raw HTML. The agent analyzes the code for broken tags or CSS issues and alerts your team if it finds rendering errors.

Yes. Mastra runs on standard Node environments. The MCP Server handles the external API connections, so your local workflows execute without configuring complex local SMTP servers.

Your credentials stay locked in Vinkius's secure credential manager. The server processes your sandbox emails and domain details in an ephemeral environment, meaning no message content or API keys are ever written to persistent disk.

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