How to Use the Mailosaur MCP in Mastra AI

Q: How can I search for messages with Mailosaur and Mastra AI?

Call searchservermessages from your agent. Provide the server ID and the specific criteria, and the agent will return the message details.

Q: Does Mailosaur and Mastra AI allow for human-in-the-loop approvals?

You can enable requireToolApproval in your client config. This forces the agent to ask you before it executes a destructive action like clearserverinbox.

Q: Can I automate the removal of old emails?

Yes. Add a teardown step to your workflow that calls deletespecificmessage after your test validation completes.

Build resilient email testing workflows with Mastra AI and this MCP Server.

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

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Dynamic server management in Mastra AI

Spin up isolated test environments on demand using `create_virtual_server`. This keeps your testing logic modular and prevents interference between parallel workflows. Your agents can now provision their own sandbox for every test run. It’s cleaner than sharing a single inbox across different test suites.

Automated failure recovery for Mastra AI

Use `list_virtual_servers` to verify your test environment is ready before running a workflow. If a server is missing, your agent can recreate it on the fly. This prevents your automation from stalling out when environments change. It keeps the pipeline moving without manual intervention from your team.

Precise message filtering

Use `search_server_messages` to find specific confirmation codes based on sender or subject. This tool gives your Mastra AI agent the data it needs to make decisions. If the message isn't there, your workflow can trigger a retry or flag the issue. It's how you handle flaky email delivery without breaking the whole build.

Setup guide

Set up Mailosaur 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 Mailosaur 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: "mailosaur-mcp-client",
  servers: {
    "mailosaur-mcp": {
      url: new URL(
        "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
      ),
    },
  },
});

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

const result = await agent.generate(
  "List recent Mailosaur 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 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 Mastra AI

Call `search_server_messages` from your agent. Provide the server ID and the specific criteria, and the agent will return the message details.

Yes. You can chain these tools into any multi-step workflow. Use `get_server_details` to verify configuration before your agent acts.

You can enable `requireToolApproval` in your client config. This forces the agent to ask you before it executes a destructive action like `clear_server_inbox`.

Yes. Add a teardown step to your workflow that calls `delete_specific_message` after your test validation completes.

All your email payloads are isolated within your unique server ID. We enforce strict data separation, so your test credentials remain yours alone.

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