AliasMail MCP server
Commit Oct 26, 2026Provides AI agents with disposable email inboxes, autonomous OTP extraction, and deep email security forensics.
Also known as aliasmail-space/aliasmail-mcp
- Stars
- 1
- Tools
- 12
- Downloads, 30 days
- —
- Latest version
- —
- Last commit
- Oct 26, 2026
- License
- MIT
What is AliasMail MCP?
AliasMail provides AI agents with disposable email inboxes, autonomous OTP extraction, and deep email security forensics. It exposes 12 tools, such as aliasmail_create_inbox, aliasmail_wait_for_code, aliasmail_get_messages.
Summary generated from the project's README
About AliasMail MCP server
Automating account registrations and email verification workflows is what developers achieve using AliasMail MCP. This server provides AI agents with instant, zero-log disposable email inboxes that require no API keys or registration to use. It is designed for autonomous coding agents like Claude Desktop, Cursor, Windsurf, and Playwright to handle end-to-end integration tests and signup processes without human intervention.
Users can generate temporary addresses using aliasmail_create_inbox and utilize aliasmail_wait_for_code to automatically extract 4–8 digit OTPs or magic links. Beyond simple inbox management, the server includes a security suite for deep forensics. This includes tools for RFC 822 header inspection, spam score calculation, and DNS auditing for MX, SPF, and DMARC records. It also features aliasmail_clean_tracking to neutralize invisible tracking pixels and surveillance links.
What you can do with it
- 1Spam and tracking analysisAn agent can scan marketing emails to calculate deliverability scores and remove hidden tracking pixels.
Written from the project's README. Every use case is checked against a quote from it.
AliasMail MCP tools 12
Detected from the READMEaliasmail_create_inboxaliasmail_wait_for_codealiasmail_get_messagesaliasmail_get_messagealiasmail_wait_for_emailaliasmail_validate_emailaliasmail_check_disposablealiasmail_check_spam_scorealiasmail_analyze_headersaliasmail_clean_trackingaliasmail_check_dnsaliasmail_health_check
Automated checks
Ran Nov 14, 2026Full report →Not verified yet. A server needs a score of 80, no serious finding, and enough data for us to check. How checks work · What to fix for more points
- Source repository linked and reachablealiasmail-space/aliasmail-mcp is public and reachablegithub.com/aliasmail-space/aliasmail-mcp ↗Pass
- Package names this repository as its sourceNot checked
- Build provenance (Sigstore attestation)Not checked
- Open source license (OSI)MITspdx.org/licenses/MIT.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-10-26github.com/aliasmail-space/aliasmail-mcp ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNot checked
- No critical advisory in the package or its dependenciesNot checked
- No hidden instructions to the model12 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNo tool named like delete, drop or execPass
- Remote endpoint answers the MCP handshakeNot checked
README
View on GitHub⚡ What is AliasMail MCP?
Autonomous AI coding agents (Claude Desktop, Cursor, Antigravity, Windsurf, AutoGPT, Playwright agents) constantly need to sign up for accounts, run end-to-end integration tests, and verify email workflows.
Historically, this required manually signing up for third-party email APIs, creating credit card accounts, or writing fragile regexes to poll temporary mail inboxes.
AliasMail MCP connects any MCP-compliant AI assistant directly to AliasMail.space's zero-log edge routing infrastructure:
- Generate Instant Burner Inboxes: Create disposable email addresses (
*@aliasmail.space) in 1 millisecond without an API key or registration. - Autonomous Verification & OTP Extraction: The
aliasmail_wait_for_codetool polls until an incoming email arrives and automatically extracts 4–8 digit verification codes and magic confirmation links. - Email Security Suite: Deep RFC 822 header inspection, spam score calculation, disposable domain detection, tracking pixel neutralization, and DNS MX/SPF/DMARC auditing.
🚀 Quickstart & Installation
Option 1: Run with npx (No installation needed)
npx -y aliasmail-mcp
Option 2: Add to Claude Desktop
Open your Claude Desktop configuration file:
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - Windows:
%APPDATA%\Claude\claude_desktop_config.json - Linux:
~/.config/Claude/claude_desktop_config.json
Add aliasmail to your mcpServers:
{
"mcpServers": {
"aliasmail": {
"command": "npx",
"args": ["-y", "aliasmail-mcp"]
}
}
}
Restart Claude Desktop, and you'll see the AliasMail tools icon ready in your prompt window!
Option 3: Add to Cursor IDE
Add to your project's .cursor/mcp.json or your global Cursor settings:
{
"mcpServers": {
"aliasmail": {
"command": "npx",
"args": ["-y", "aliasmail-mcp"]
}
}
}
Option 4: Add to Windsurf
In your Windsurf MCP configuration (~/.codeium/windsurf/mcp_config.json):
{
"mcpServers": {
"aliasmail": {
"command": "npx",
"args": ["-y", "aliasmail-mcp"]
}
}
}
Option 5: Install via Smithery
If you use Smithery.ai:
npx -y @smithery/cli install aliasmail-mcp --client claude
🛠️ Available MCP Tools
📬 Disposable & Temporary Inbox Tools
| Tool | Description |
|---|---|
aliasmail_create_inbox |
Generates a fresh, zero-log temporary email inbox (e.g. lunarbyte492@aliasmail.space) or custom handle. Returns email and web inbox URL. |
aliasmail_wait_for_code |
Autonomous Agent Power Tool: Polls until an email arrives and automatically extracts the numerical OTP verification code or activation link. |
aliasmail_get_messages |
Fetches all received messages in an inbox with sender, subject, timestamp, and snippet. |
aliasmail_get_message |
Retrieves the full plain text, clean sanitized HTML, headers, and detected links for a specific email. |
aliasmail_wait_for_email |
Waits for any incoming message matching optional sender or subject filters. |
🛡️ Email Forensics & Security Tools
| Tool | Description |
|---|---|
aliasmail_validate_email |
Validates RFC 5322 syntax, live domain MX records, typo domains (e.g. gmial.com), and disposable mailbox detection. |
aliasmail_check_disposable |
Inspects whether any email or domain belongs to an ephemeral burner service or legitimate corporate MX. |
aliasmail_check_spam_score |
Scans email subject and body against 5 spam trigger categories and calculates a 0–100 deliverability score. |
aliasmail_analyze_headers |
Parses RFC 822 headers: SPF, DKIM, DMARC verdicts, hop relay transit timeline, and origin IP. |
aliasmail_clean_tracking |
Defuses invisible 1x1 tracking pixels, read receipt beacons, and surveillance redirect links. |
aliasmail_check_dns |
Real-time DNS audit of domain Mail Exchange (MX) records, SPF syntax, and DMARC enforcement. |
aliasmail_health_check |
Checks live availability and status of AliasMail edge relay infrastructure. |
🤖 Example Agent Workflows
1. Autonomous Signup & Email Verification
Give this instruction to your AI agent (Cursor / Claude / Antigravity):
"Sign up for a test account on example.com. Use an AliasMail temporary email inbox, submit the form, and wait for the verification code using
aliasmail_wait_for_codeto enter it automatically."
The agent will:
- Call
aliasmail_create_inbox➔ receivesswiftfox309@aliasmail.space - Fill the registration form with
swiftfox309@aliasmail.space - Call
aliasmail_wait_for_code({ address: "swiftfox309@aliasmail.space" }) - Receive
{ code: "748291", primaryUrl: "https://example.com/verify?token=..." } - Finish authentication seamlessly without human intervention.
2. Inspecting Spam & Tracking Pixels
"Analyze this marketing email HTML for spy trackers and test its deliverability score."
The agent calls:
aliasmail_clean_trackingto neutralize tracking pixels.aliasmail_check_spam_scoreto optimize email copy.
🌐 Live Web Interface
Want to view emails manually in your browser? Every inbox created by this MCP server is immediately accessible on the web:
- Instant Web Inbox: https://aliasmail.space/temporary/
- Main Platform & Permanent Aliases: https://aliasmail.space/
- Free Email Security Tools: https://aliasmail.space/tools/
🔒 Zero-Log Architecture & Privacy
AliasMail is engineered with a strict privacy-first foundation:
- Zero IP logging: We never log agent or client IP addresses.
- Automatic TTL Expiration: Ephemeral messages are held in high-speed edge queues and purged automatically.
- Edge Routing: Powered by Cloudflare Email Routing and BullMQ processing for sub-second delivery.
📄 License
MIT © AliasMail & Anshu Sharma
AliasMail MCP questions
What tools does AliasMail MCP provide?
It exposes 12 tools, including aliasmail_create_inbox, aliasmail_wait_for_code, aliasmail_get_messages, aliasmail_get_message, aliasmail_wait_for_email.
How can I use AliasMail for account verification?
You can use the aliasmail_wait_for_code tool, which polls until an email arrives and automatically extracts numerical OTP codes or magic confirmation links.
Does using AliasMail require an API key?
No, you can create disposable email addresses instantly without an API key or registration.
Can I view my temporary emails in a browser?
Yes, every inbox created via the MCP server is immediately accessible through the AliasMail web interface.