Mailinator Connector for AI agents.
12 live capabilities
Verify email workflows and test webhooks in real time
Waiting for input…
Why people use Mailinator
Mailinator for Debugging Email Delivery Failures
With the Mailinator MCP, you just ask your agent to check the inbox and read the latest message. It pulls the content, headers, and attachments into your chat instantly. You get to skip the manual clicking and move straight to fixing the bug.
What Vinkius changes
You get a way to manage and inspect disposable mail flows through a chat interface.
Use it from Claude, ChatGPT, Cursor or another AI client you already have.
One account · 5,900+ Connectors
- Real-world use case 01
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.
- Real-world use case 02
Debugging a failed webhook
A developer asks the agent to show the latest webhook results to see why a payment notification failed.
- Real-world use case 03
Validating SMS 2FA delivery
A tester asks the agent to check the private SMS inbox to see if the verification code was delivered.
Complete set · 12capabilities
The complete Mailinator capability set.
These are the exact actions your AI can choose when you ask it to work with Mailinator.
01—04
4 capabilities in this set.
Part of 12 available through Mailinator.
- 01 Capability
List message attachments
Get all files attached to a specific email. Use this to verify that your app is sending the correct documents.
- 02 Capability
Extract message links
Pull every URL out of an email body. It is great for quickly checking if your reset links are formatted correctly.
- 03 Capability
List private domains
See all the private domains you have created. This helps you organize your testing environments by project.
- 04 Capability
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.
05—08
4 capabilities in this set.
Part of 12 available through Mailinator.
- 05 Capability
List routing rules
See your current forwarding and rule settings. This helps you debug why emails might be going to the wrong place.
- 06 Capability
List private sms
View the messages in your private SMS inbox. This is perfect for testing two-factor authentication flows.
- 07 Capability
List active webhooks
See all your active webhook configurations. This helps you check which endpoints are receiving data.
- 08 Capability
Remove message
Delete a specific email from an inbox. This helps you keep your test environment clean and organized.
09—12
4 capabilities in this set.
Part of 12 available through Mailinator.
- 09 Capability
Get message content
Read the full text and headers of an email. This lets you inspect the raw data your system sends to users.
- 10 Capability
Get usage statistics
Check your current API usage. This keeps you on top of your limits so your automated tests do not break.
- 11 Capability
Get domain details
See the metadata for your private domains. This helps you manage your routing and domain limits effectively.
- 12 Capability
Inject test message
Send a fake email into your system. It is the fastest way to test how your app handles incoming mail.
Set up in minutes
One URL. Then ask Mailinator to work.
Claude and ChatGPT only need the Connector URL. Copy it once, add it in settings, and use Mailinator from the conversation.
Choose your client
Live previewAdvanced clients IDE · CLI
Claude · Web + desktop
Connector URL · ready to paste
Streamable HTTPhttps://edge.vinkius.com/vk_preview_JpAf2D1He3udyhT4hvROyoi8D1T63NyObfkJyVts/mcp - Step 01
Open Connectors
In Claude Web or Claude Desktop, open Settings and choose Connectors.
- Step 02
Add the URL
Choose Add custom connector, name it Mailinator, and paste the URL above.
- Step 03
Turn it on in chat
Select +, open Connectors, and enable Mailinator for the conversation.
ChatGPT · Web + desktop
Connector URL · ready to paste
Streamable HTTPhttps://edge.vinkius.com/vk_preview_JpAf2D1He3udyhT4hvROyoi8D1T63NyObfkJyVts/mcp - Step 01
Open MCP settings
On desktop, open Settings and MCP servers. On web, open your workspace app or connector settings.
- Step 02
Add the URL
Choose Add server with Streamable HTTP, or create a custom MCP app, then paste the Mailinator URL.
- Step 03
Save and start
Save the connection and enable Mailinator in your conversation. Desktop may ask you to restart once.
Cursor · IDE configuration
Advanced setup
{
"mcpServers": {
"mailinator": {
"url": "https://edge.vinkius.com/vk_preview_JpAf2D1He3udyhT4hvROyoi8D1T63NyObfkJyVts/mcp"
}
}
}- Step 01
Open MCP Settings
Press Cmd+Shift+P (macOS) or Ctrl+Shift+P (Windows/Linux) → search "MCP Settings"
- Step 02
Add the server config
Paste the JSON configuration above into the mcp.json file that opens
- Step 03
Save the file
Cursor will automatically detect the new Connector
- Step 04
Start using Mailinator
Open Agent mode in chat and ask: "Using Mailinator, help me...". 12 tools available
VS Code Copilot · IDE configuration
Advanced setup
{
"mcpServers": {
"mailinator": {
"url": "https://edge.vinkius.com/vk_preview_JpAf2D1He3udyhT4hvROyoi8D1T63NyObfkJyVts/mcp"
}
}
}- Step 01
Create MCP config
Create a .vscode/mcp.json file in your project root
- Step 02
Add the server config
Paste the JSON configuration above
- Step 03
Enable Agent mode
Open GitHub Copilot Chat and switch to Agent mode using the dropdown
- Step 04
Start using Mailinator
Ask Copilot: "Using Mailinator, help me...". 12 tools available
Windsurf · IDE configuration
Advanced setup
{
"mcpServers": {
"mailinator": {
"url": "https://edge.vinkius.com/vk_preview_JpAf2D1He3udyhT4hvROyoi8D1T63NyObfkJyVts/mcp"
}
}
}- Step 01
Open MCP Settings
Go to Settings → MCP Configuration or press Cmd+Shift+P and search "MCP"
- Step 02
Add the server
Paste the JSON configuration above into mcp_config.json
- Step 03
Save and reload
Windsurf will detect the new server automatically
- Step 04
Start using Mailinator
Open Cascade and ask: "Using Mailinator, help me...". 12 tools available
Cline · IDE configuration
Advanced setup
{
"mcpServers": {
"mailinator": {
"url": "https://edge.vinkius.com/vk_preview_JpAf2D1He3udyhT4hvROyoi8D1T63NyObfkJyVts/mcp"
}
}
}- Step 01
Open Cline MCP Settings
Click the Connectors icon in the Cline sidebar panel
- Step 02
Add remote server
Click "Add Connector" and paste the configuration above
- Step 03
Enable the server
Toggle the server switch to ON
- Step 04
Start using Mailinator
Ask Cline: "Using Mailinator, help me...". 12 tools available
Claude Code · Terminal command
Advanced setup
claude mcp add mailinator --transport http "https://edge.vinkius.com/vk_preview_JpAf2D1He3udyhT4hvROyoi8D1T63NyObfkJyVts/mcp"- Step 01
Install Claude Code
Run npm install -g @anthropic-ai/claude-code if not already installed
- Step 02
Add the Connector
Run the command above in your terminal
- Step 03
Verify the connection
Run claude mcp to list connected servers, or type /mcp inside a session
- Step 04
Start using Mailinator
Ask Claude: "Using Mailinator, show me...". 12 tools are ready
Where the request belongs
Work Mailinator can move forward.
This is for the QA engineer tired of manual verification and the developer who needs to debug mail delivery without creating real accounts.
QA Engineer
Verifying that 'Forgot Password' buttons actually send emails and that links land in the inbox.
Developer
Debugging email delivery in staging environments and verifying webhook payload accuracy.
DevOps Engineer
Monitoring email infrastructure, routing rules, and webhook notification configs.
Build the capability set
Add more capabilities.
Each Connector adds new actions and data without changing how you work.
Browse ConnectorsMailSlurp
Manage temporary inboxes and automate email testing via the MailSlurp REST API.
Mailsac
Manage disposable and private email addresses via the Mailsac REST API.
Elastic Email
Equip your AI agent to manage email campaigns, track contacts, and monitor delivery logs via the Elastic Email API.
Mailtrap
Test, debug, and preview emails in a sandbox before sending to production with analytics that catch rendering issues early.
Mailosaur
Automate email and SMS testing and management via the Mailosaur REST API.
Postmark
Automate transactional email delivery via Postmark. manage servers, templates, and bounces directly from any AI agent.
Bring your own AI
Change the model, client or framework. Keep Mailinator connected.
-
Claude -
ChatGPT -
Gemini -
Cursor -
VS Code -
Windsurf -
ZCode -
Cline -
Zed -
Continue -
Kiro -
Roo Code -
Zencoder -
Goose -
Void -
Augment Code -
Amp -
Qodo -
Tabnine -
Pieces -
Sourcegraph Cody -
JetBrains -
Warp -
Amazon Q -
Antigravity -
BoltAI -
Raycast -
Jan -
LM Studio -
AnythingLLM -
Open WebUI -
Msty -
Cherry Studio -
LibreChat -
TypingMind -
Chorus -
5ire -
n8n -
LangChain -
LlamaIndex -
CrewAI -
Vercel AI SDK
Before you connect
Questions about Mailinator.
The practical details behind the request, access and result.
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.
One connection away
Give your agent a direct line to Mailinator.
Connect Mailinator once. Keep it beside 5,900+ managed Connectors when the next task needs more.
Explore every Connector No credit card required · Free tier available