# Mailsac MCP for AI Agents AI Agent Connect > Mailsac MCP lets you manage disposable and private email addresses through your AI client. You can reserve new inboxes, fetch messages for verification codes, and clear out old emails automatically. It's built for developers and QA teams who need to handle high-volume email testing without cluttering their personal inboxes. ## Overview - **Category:** developer-tools - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_bmGU0B3mzhr77Bq8AeBVT3IIEbjEAHxufRNhHlOM/ai-agent-connect - **Tags:** disposable-email, email-testing, inbox-management, message-extraction, automated-testing, verification-codes ## Description Mailsac MCP lets you connect your email testing environment to your AI agent so you can stop hunting for verification codes in different tabs. If you're a developer or a QA person, you know the pain of having to manually check an inbox, find the right mail, and copy a code into a form. This Connector changes that by letting your agent do the work. You can tell your agent to fetch the latest message, grab the text body, and pull out the code for you. It also handles the boring stuff like reserving new private addresses for isolated tests or clearing out old messages when an inbox gets too cluttered. You can manage custom domains and see everything in your account from a single chat interface. You'll find this in the Vinkius catalog if you need a way to make your automated testing flows actually move faster. It turns a multi-step manual process into a single request. Instead of opening a browser, logging in, and waiting for a refresh, your agent handles the API calls for you. This means you can stay in your IDE or your primary workspace while your test suite runs in the background. It's about getting rid of the friction between your code and the emails it sends. You can automate the entire lifecycle of a test email, from the moment you reserve the address to the moment you delete the final message. This gives you a clean, programmatic way to handle mail without the overhead of managing a complex mail server or constant manual intervention. ## Tools ### list_reserved_addresses Mailsac MCP lets you see all your reserved email addresses at once. It helps you keep track of your active test accounts. ### delete_inbox_message Mailsac MCP lets you remove a single email from an inbox. This keeps your test environment clean and organized. ### get_plain_text_body Mailsac MCP lets you get the raw text from an email. It's the fastest way to grab a verification code or link. ### list_inbox_messages Mailsac MCP lets you see a list of all messages in a specific inbox. Use this to check if a mail arrived. ### release_reserved_address Mailsac MCP lets you delete a reserved address when you're finished with it. This frees up your account space. ### reserve_new_address Mailsac MCP lets you create a new private email address on the fly. Use it to start a fresh, isolated test flow. ### search_account_messages Mailsac MCP lets you search for messages across all your addresses. This helps you find old data using sender or subject lines. ### get_html_message_body Mailsac MCP lets you pull the full HTML content of a message. This is great for parsing complex layouts or buttons. ### list_custom_domains Mailsac MCP lets you see all the custom domains linked to your account. Use it to check your current branding options. ## Prompt Examples **Prompt:** ``` I need to test a new user signup. Can you get me a new email address from Mailsac? ``` **Response:** ``` I've reserved a new private address for you: **test-user-882@mailsac.com**. I'll keep this inbox open. Just let me know when you're ready for me to check for the verification code. ``` **Prompt:** ``` Check the last email sent to test-user-882@mailsac.com and give me the code. ``` **Response:** ``` I've checked the inbox for **test-user-882@mailsac.com**. Here is the latest message: * **Subject:** Verification Code * **Content:** Your code is **552-910**. Would you like me to extract that code for your form? ``` **Prompt:** ``` Clean out all the old messages in my test-user-882@mailsac.com inbox. ``` **Response:** ``` I've cleared out the messages in the **test-user-882@mailsac.com** inbox. It's now empty and ready for your next test run. ``` ## Capabilities ### Reserve new private addresses Mailsac MCP lets you create new private email addresses for isolated testing flows. ### Fetch message bodies Mailsac MCP lets you grab sanitized HTML or plain text from specific messages. ### List active inboxes Mailsac MCP lets you see all your reserved addresses and custom domains. ### Delete old messages Mailsac MCP lets you permanently remove messages to keep your inboxes clean. ### Search all messages Mailsac MCP lets you query messages across all addresses using sender or subject. ### Manage custom domains Mailsac MCP lets you view and manage your linked custom domains. ## Use Cases ### Automated QA Signup Flows A QA engineer wants to automate a signup flow. The agent uses `reserve_new_address` to get a fresh email, then uses `get_plain_text_body` to grab the code. ### Developer Notification Checks A developer wants to check if a password reset works. The agent uses `list_inbox_messages` to see if the mail arrived and then grabs the body. ### Privacy-First Web Registration A user wants to sign up for a new site without giving away their real email. The agent creates a private address and handles the communication. ### Bulk Test Inbox Cleanup A user has 50 test inboxes with old mail. The agent uses `delete_inbox_message` to clear them all out in one go. ## Benefits - Stop manual copy-pasting by using `get_plain_text_body` to pull codes directly into your app. - Keep your testing environment clean by using `delete_inbox_message` to wipe out old data. - Scale your automated tests instantly by using `reserve_new_address` to create new inboxes on demand. - Find old test data quickly using `search_account_messages` to query across all your addresses. - Manage your branding and setup more easily with `list_custom_domains` in a single view. - Reduce browser fatigue by using `list_inbox_messages` to verify mail arrival without opening a tab. ## How It Works The bottom line is you get a hands-off way to handle email verification and inbox management. 1. Subscribe to the Connector on Vinkius and grab your Mailsac API key. 2. Connect the Connector to your AI client like Claude or Cursor. 3. Start asking your agent to fetch codes or manage your inboxes. ## Frequently Asked Questions **Can the Mailsac MCP help me automate verification codes?** Yes, it can. By using the plain text body tool, your agent can grab verification codes from your Mailsac inboxes automatically, which is perfect for automated signup flows. **Does Mailsac MCP work with Claude or Cursor?** It works with any MCP-compatible client, including Claude, Cursor, and Windsurf. You just need to connect your Mailsac API key in the settings. **Can I use my own custom domains with Mailsac MCP?** Yes, you can. The Connector allows your agent to see and manage the custom domains you've already linked to your Mailsac account. **Is Mailsac MCP good for QA engineers?** It's a great fit for QA. It allows you to automate the entire lifecycle of a test email, from reserving a fresh address to extracting codes and cleaning up the inbox. **Can I delete emails automatically using Mailsac MCP?** Yes, you can. You can tell your agent to remove specific messages or clear out entire inboxes to keep your test environment organized. **How do I get my Mailsac API key for this Connector?** You can find your API key in your Mailsac account settings. Once you have it, you'll enter it into your AI client to connect the Connector. **What is an 'Enhanced' address in Mailsac?** An enhanced address is a private inbox that only you can access. Use the `reserve_new_address` tool to make an address private/enhanced. **Can I read the raw SMTP source of an email?** While this server provides tools for HTML and Plain Text bodies, the Mailsac API supports raw data retrieval. You can use the text body tool to extract key technical metadata. **Is an API Key required for all addresses?** Yes, this Connector requires an API Key to interact with your account and access your reserved resources and private messages.