# Mailinator MCP for AI Agents AI Agent Connect > Mailinator MCP lets you manage disposable inboxes and test email workflows directly through your AI client. It handles everything from reading messages and attachments to managing private domains and monitoring webhooks. Use it to verify sign-up flows, test notification triggers, or debug mail delivery without ever touching real production mailboxes or exposing your personal data. ## Overview - **Category:** productivity - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_JpAf2D1He3udyhT4hvROyoi8D1T63NyObfkJyVts/ai-agent-connect - **Tags:** disposable-email, qa-testing, webhook-testing, sms-testing, inbox-inspection, automation-testing ## Description Connecting the Mailinator MCP to your AI client changes how you handle email testing. Instead of manually creating accounts and checking dozens of different inboxes to see if a "Welcome" email actually sent, you can just ask your agent to do it. You can browse public and private inboxes, read the full content of messages, and even pull out attachments or specific links in a single step. It makes it easy to verify that your app is sending the right data without needing to set up real mail servers or deal with spam filters. If you're working on a staging environment, you can use this to monitor incoming webhooks and check payloads for errors. You can also manage your private domains, set up routing rules, and check your SMS inboxes for two-factor authentication tests. It's a practical way to validate your infrastructure. You can find this Connector in the Vinkius catalog to get it connected to Claude or Cursor. It gives your agent the eyes it needs to see what's happening in your mail flows so you can spend less time clicking through tabs and more time fixing bugs. You can quickly check how many messages are waiting, verify that your routing rules are actually forwarding mail correctly, and inspect the raw headers of incoming messages to ensure they aren't being flagged. This takes the guesswork out of your deployment cycle and lets you confirm that every notification and verification code is landing exactly where it should. ## Tools ### list_message_attachments Get all files attached to a specific email. Use this to verify that your app is sending the correct documents. ### extract_message_links Pull every URL out of an email body. It is great for quickly checking if your reset links are formatted correctly. ### list_private_domains See all the private domains you have created. This helps you organize your testing environments by project. ### list_inbox_messages Get a list of all messages in an inbox. This helps you see how many emails have arrived during a test run. ### list_routing_rules See your current forwarding and rule settings. This helps you debug why emails might be going to the wrong place. ### list_private_sms View the messages in your private SMS inbox. This is perfect for testing two-factor authentication flows. ### list_active_webhooks See all your active webhook configurations. This helps you check which endpoints are receiving data. ### remove_message Delete a specific email from an inbox. This helps you keep your test environment clean and organized. ### get_message_content Read the full text and headers of an email. This lets you inspect the raw data your system sends to users. ### get_usage_statistics Check your current API usage. This keeps you on top of your limits so your automated tests do not break. ### get_domain_details See the metadata for your private domains. This helps you manage your routing and domain limits effectively. ### inject_test_message Send a fake email into your system. It is the fastest way to test how your app handles incoming mail. ## Prompt Examples **Prompt:** ``` Check the inbox for test@privateteam.testinator.com and read the latest message. ``` **Response:** ``` Inbox: test@privateteam.testinator.com. Messages: 5. Latest: Subject: 'Password Reset Confirmation'. From: noreply@app.com. Received: 2 min ago. Body: 'Hi Test, click the link below to reset your password: https://app.com/reset?token=abc123. This link expires in 30 minutes.' Headers: SPF OK, DKIM OK, Content-Type: text/html. ``` **Prompt:** ``` Show all private domains and their inbox counts. ``` **Response:** ``` Private domains: 3. 'privateteam.testinator.com' (12 inboxes, 45 messages). 'staging.myapp.io' (8 inboxes, 23 messages). 'qa.testing.dev' (5 inboxes, 18 messages). Total: 25 inboxes, 86 messages. Rules: 4 active forwarding rules. Oldest message: 7 days (auto-purge: 24h for free, 30d for team). ``` **Prompt:** ``` Check SMS inbox and show webhook test results. ``` **Response:** ``` SMS inbox: +1-555-0123. Messages: 3. Latest: 'Your verification code is 847293' (from: MYAPP, 5 min ago). '2FA code: 123456' (from: AUTHSVC, 1h ago). Webhooks received (24h): 8 total. POST /webhook/stripe (3, all 200 OK). POST /webhook/twilio (5, 4x 200, 1x 500 payload error). ``` ## Capabilities ### Read email content Get the body and headers of any message in your inbox. ### List inbox messages See a full list of all emails in a specific inbox. ### Get email attachments Download and inspect files attached to your emails. ### Extract message links Pull out all URLs from an email body automatically. ### Manage private domains Create and list your own private Mailinator domains. ### Monitor webhooks Check incoming webhook payloads and status codes. ### Simulate test messages Inject dummy emails into your system for testing. ### Check SMS inboxes View incoming SMS messages for phone number testing. ## Use Cases ### Verifying a password reset flow A QA engineer asks the agent to check for a specific email and read the latest message to confirm the reset link is active. ### Debugging a failed webhook A developer asks the agent to show the latest webhook results to see why a payment notification failed. ### Validating SMS 2FA delivery A tester asks the agent to check the private SMS inbox to see if the verification code was delivered. ### Checking mail routing rules A DevOps engineer asks the agent to list routing rules to see why emails are being forwarded to the wrong domain. ## Benefits - Stop manually checking inboxes by using list_inbox_messages to see all mail at once. - Verify correct file delivery by inspecting files with list_message_attachments. - Quickly grab URLs from emails using extract_message_links to check redirect logic. - Test your app's reaction to fake mail using inject_test_message for rapid prototyping. - Monitor your webhook health and payloads with list_active_webhooks to catch errors early. - Check two-factor codes instantly with list_private_sms for mobile verification tests. ## How It Works The bottom line is you get a way to manage and inspect disposable mail flows through a chat interface. 1. Subscribe to the Mailinator MCP on Vinkius. 2. Provide your Mailinator API Token in the configuration. 3. Ask your AI client to check inboxes, read messages, or manage domains. ## Frequently Asked Questions **Can the Mailinator MCP help me test my app's sign-up flow?** Yes. You can use it to verify that your app sends the correct welcome emails and that they contain the expected links and content. **How does Mailinator MCP handle webhook testing?** It lets you monitor incoming webhooks and check the payloads and status codes in real time, making it easy to debug delivery issues. **Can I use Mailinator MCP to check SMS codes?** Yes. You can access private SMS inboxes to verify that your two-factor authentication codes are being delivered correctly. **Does Mailinator MCP support private domains?** Yes. It allows you to manage and list private domains, which is great for organizing different testing environments for different projects. **Can I see attachments with Mailinator MCP?** Yes. You can retrieve and inspect files attached to emails to ensure your system is sending the correct documents. **How do I use Mailinator MCP to debug mail routing?** You can use it to list your current routing rules and see where emails are being forwarded, helping you identify configuration errors. **Can I browse inboxes and read emails?** Yes. Browse public and private inboxes, read full email content including HTML, headers, and attachments. **How does Mailinator authentication work?** Mailinator uses a custom **Token** header for authentication against `api.mailinator.com/api/v2`. **Can I test SMS messages too?** Yes. Access SMS inboxes and read SMS messages for phone number-based testing.