How to Use the Mail-in-a-Box MCP in Mastra AI

Q: Can I require human approval before deleting a user?

Yes. You can enable requireToolApproval on the deletemailuser tool. The workflow pauses execution and waits for an administrator to confirm the action.

Q: How do I reset a user password programmatically?

Add the updateuserpassword tool to your workflow. You can pass the new credentials as arguments and configure a fallback step if the validation fails.

Build resilient Mail-in-a-Box administration workflows with Mastra AI using conditional branching and automatic retries.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Mail-in-a-Box MCP to Mastra AI

Create your Vinkius account to connect Mail-in-a-Box 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 Mail-in-a-Box with Mastra AI

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Script fault-tolerant user creation

This MCP server plugs directly into Mastra AI to handle complex onboarding sequences using `create_mail_user`. A workflow executes the command and immediately branches based on the result. If the API hits a rate limit, the framework applies exponential backoff and tries again. You can chain these operations safely. After the mailbox exists, the next step runs `create_or_update_alias` to set up forwarding. If the alias step fails, your workflow catches the error without leaving the account in a broken state.

Monitor domains with conditional alerts

Your agent can run `get_system_status` via the MCP to check SSL certificates and DNS configurations directly. Scheduled tasks need reliable access to server telemetry, and Mastra evaluates the output to route critical failures to an admin channel. The same logic applies to inventory checks. Running `list_mail_domains` lets your system verify active properties against a database. The workflow handles any network timeouts automatically.

Automate offboarding sequences

Your workflow starts by calling `list_mail_aliases` to find any active forwarders tied to a departing user. Removing an employee requires multiple steps, so the agent parses the list and prepares the cleanup batch. Execution happens systematically. The script fires `delete_mail_alias` for the routing rules, followed by `delete_mail_user` to wipe the mailbox. Mastra AI ensures every tool finishes before marking the offboarding complete.

Setup guide

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

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

const result = await agent.generate(
  "List recent Mail-in-a-Box 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 Mail-in-a-Box. 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 Mail-in-a-Box 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 Mail-in-a-Box MCP in Mastra AI

Instantiate a new MCPClient and pass the server URL in your configuration object. Call mcpClient.listTools() to spread the available actions into your agent's toolkit.

Yes. You can enable requireToolApproval on the delete_mail_user tool. The workflow pauses execution and waits for an administrator to confirm the action.

The framework catches the timeout natively. It uses built-in exponential backoff to retry the failed tool call before throwing a fatal error.

Add the update_user_password tool to your workflow. You can pass the new credentials as arguments and configure a fallback step if the validation fails.

Workflows process sensitive routing lists, account credentials, and system health metrics. Because the MCP connection uses a zero-trust architecture, the framework never stores the payload. The data passes through the ephemeral sandbox and disappears after the step resolves.

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