# Mailosaur MCP

> Mailosaur gives your AI agent full control over virtual inboxes and SMS message streams. It lets you automate testing by listing, searching, retrieving content, and managing messages across multiple simulated servers. Use this MCP to instantly validate email delivery metrics and audit communication flows without ever touching a dashboard.

## Overview
- **Category:** productivity
- **Price:** Free
- **Tags:** email-testing, sms-testing, qa-automation, rest-api, virtual-inbox, message-validation

## Description

You can connect Mailosaur to your AI client and treat your test inboxes like any other data source. This lets you automate the tedious process of checking if a signup confirmation or an SMS code actually arrived, and what its content was. Instead of logging into multiple web panels, your agent reads directly from these virtual servers using simple natural language prompts.

Need to check messages sent only to a specific domain? No problem. You can also programmatically create new test environments when you need complete isolation for a fresh round of checks. When validation is done, you don't have to manually delete the evidence; just tell your agent to clear out the entire server inbox or permanently remove one bad message. Because Vinkius hosts this MCP, your AI client can access all these testing tools from one place, making communication flow auditing simple and fast.

## Tools

### create_virtual_server
Creates a new, isolated virtual server or test inbox for dedicated testing periods.

### clear_server_inbox
Deletes every single message from an entire configured test server.

### delete_specific_message
Permanently removes one specific, undesirable message from a virtual inbox.

### get_message_content
Retrieves the full HTML and plain text content of any given test message for deep inspection.

### get_server_details
Fetches specific information about a particular virtual server, such as its unique routing domain.

### list_server_messages
Lists every message currently residing in a specified virtual server inbox.

### search_server_messages
Searches for specific messages by requiring detailed criteria like the sender, recipient, or subject line.

### list_virtual_servers
Returns a list of all available virtual servers associated with your account ID.

## Prompt Examples

**Prompt:** 
```
List all my Mailosaur servers.
```

**Response:** 
```
I've retrieved your servers. You have 3 active environments: 'Production Tests (ID: prod123)', 'Staging Inboxes', and 'Dev Sandbox'.
```

**Prompt:** 
```
Find the last message sent to 'test-user@mailosaur.io' in server 'prod123'.
```

**Response:** 
```
I've searched server prod123. I found 1 message sent to test-user@mailosaur.io with the subject 'Welcome to our Service'. Would you like to see the full content?
```

**Prompt:** 
```
Delete all messages in the 'Dev Sandbox' server (ID: 'dev789').
```

**Response:** 
```
I've successfully cleared the inbox for server dev789. All messages have been permanently removed.
```

## Capabilities

### Discover available test servers
Lists all the virtual inboxes you own so you know which environments to check.

### Set up new isolated test accounts
Creates a brand-new, clean virtual server/inbox for testing without affecting your live data.

### Check all messages in an inbox
Retrieves a complete list of every email and SMS message received by a specific test account.

### Find messages using detailed criteria
Searches through thousands of messages, finding exactly what you need by sender, recipient, or subject line.

### Extract full message content
Gets the complete HTML and plain text body for any single message so your agent can analyze its specific contents.

### Manage inbox clutter
Clears all messages from a server, or deletes individual messages permanently when testing is finished.

## Use Cases

### Debugging Failed Webhooks
A developer notices that the payment confirmation email isn't being generated correctly. They ask their agent to `search_server_messages` for 'Stripe Payment Failure' in the staging server, instantly retrieving the message content and seeing the exact missing parameter.

### Auditing Communication Flows
An SRE needs to verify that all marketing campaigns sent last month were delivered. They prompt their agent to `list_server_messages` across three different server IDs, quickly confirming message count and status for a full audit report.

### Validating Multi-Step Signups
A QA engineer is testing a new signup flow that requires an SMS code. They use the agent to `create_virtual_server` for isolation, then prompt it to find the expected 6-digit message via `search_server_messages`, confirming the code immediately.

### Analyzing Specific Sender Behavior
An operations team needs to check if a third-party integration is sending spam. They ask their agent to filter all messages from that specific domain using advanced search and then use `delete_specific_message` on anything suspicious.

## Benefits

- Instant Validation: Instead of manually checking a dashboard, your agent can run sophisticated searches using `search_server_messages` to find messages based on exact criteria like subject or sender domain. This saves hours of manual clicking.
- Controlled Testing Environments: Need to simulate a fresh start? Use `create_virtual_server` to build entirely separate test accounts, ensuring that debugging one feature doesn't contaminate data for another.
- Deep Content Inspection: Don't just confirm delivery; confirm the content. The ability to run `get_message_content` lets your agent read the full HTML body, guaranteeing links and required text blocks are present.
- Clean Up Effortlessly: When testing is done, you can immediately reset your environment using `clear_server_inbox`. This keeps your data clean and prevents accidental review of old test messages.
- Comprehensive Visibility: With one call to `list_virtual_servers`, your agent knows every server ID it needs access to. It gives a single pane of glass view over all your simulated communication channels.

## How It Works

The bottom line is you get programmatic access to complex email and SMS testing features through simple conversational prompts.

1. Subscribe to the MCP and provide your unique Mailosaur API key.
2. Connect this MCP to your preferred AI client (Cursor, Claude, etc.).
3. Use natural language commands—like 'Find all messages sent from billing@example.com'—and let your agent pull the data.

## Frequently Asked Questions

**How do I use Mailosaur MCP to check all my test inboxes?**
First, run list_virtual_servers to get a list of all your unique server IDs. Then, you can pass those IDs to the agent and ask it to search for messages across that entire set of servers.

**Can I use Mailosaur MCP to validate SMS codes?**
Yes. The MCP treats SMS like email messages. You can use search_server_messages, specifying the expected sender or keyword in the body to find and verify those test codes.

**What is the best tool for finding a message sent from a specific user?**
Use search_server_messages. This tool allows you to filter messages by detailed criteria, making it highly accurate when looking up sender or recipient addresses.

**Does Mailosaur MCP allow me to create new test accounts?**
Yes. The create_virtual_server tool lets your agent programmatically build brand-new inboxes. This is critical for keeping different feature tests isolated from one another.

**How do I get the full text of a message using Mailosaur MCP?**
Call get_message_content. This tool doesn't just show you the subject line; it retrieves the complete HTML and plain text body, which is necessary for deep data validation.