{"id":"2013e03c-1b50-4407-a342-b0390048346a","slug":"aliasmail-space-aliasmail-mcp","kind":"mcp","name":"aliasmail-mcp","summary":"Official Model Context Protocol (MCP) server for AliasMail (https://aliasmail.space) — Zero-log disposable temporary inboxes, autonomous OTP & verification code extraction, and email security tools fo","owner":"aliasmail-space","repoUrl":"https://github.com/aliasmail-space/aliasmail-mcp","license":"MIT","licenseTier":"permissive","trust":"community","stars":0,"match":null,"fewStars":true,"format":"mcp","createdAt":"2026-10-26T18:11:51.000Z","addedAt":"2026-10-27T18:35:58.960Z","logoUrl":"https://avatars.githubusercontent.com/u/279223020?v=4","linkOnly":false,"collection":null,"skillPath":null,"categories":["productivity","developer-tools","cloud-infra"],"tags":["ai-agents","claude","cursor","disposable-email","otp","tempmail","temporary-email","verification-code"],"runtime":"node","local":true,"cloudCapable":false,"cloudCapability":"unknown","cloudReadyOnPlatform":false,"needsApiKey":false,"reviewed":false,"syncedAt":"2026-10-27T18:36:09.983Z","sample":false,"url":"https://conduits.dev/tools/aliasmail-space-aliasmail-mcp","language":"TypeScript","transports":["stdio"],"install":{"npm":"aliasmail-mcp"},"requirements":{"env":[],"upstreamMayCharge":false},"tools":null,"readme":"

\n \n \"AliasMail\n \n

\n\n

AliasMail MCP Server

\n\n

\n The Official Model Context Protocol (MCP) Server for AliasMail.space
\n Instant, zero-log disposable email inboxes, autonomous OTP / verification code extraction, and deep email security tools for AI agents.\n

\n\n

\n \"npm\n \"MIT\n \"Model\n \"Zero\n \"Web\n

\n\n---\n\n## ⚡ What is AliasMail MCP?\n\nAutonomous 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.\n\nHistorically, this required manually signing up for third-party email APIs, creating credit card accounts, or writing fragile regexes to poll temporary mail inboxes.\n\n**AliasMail MCP** connects any MCP-compliant AI assistant directly to **[AliasMail.space](https://aliasmail.space/)**'s zero-log edge routing infrastructure:\n1. **Generate Instant Burner Inboxes**: Create disposable email addresses (`*@aliasmail.space`) in 1 millisecond without an API key or registration.\n2. **Autonomous Verification & OTP Extraction**: The `aliasmail_wait_for_code` tool polls until an incoming email arrives and automatically extracts 4–8 digit verification codes and magic confirmation links.\n3. **Email Security Suite**: Deep RFC 822 header inspection, spam score calculation, disposable domain detection, tracking pixel neutralization, and DNS MX/SPF/DMARC auditing.\n\n---\n\n## 🚀 Quickstart & Installation\n\n### Option 1: Run with `npx` (No installation needed)\n\n```bash\nnpx -y aliasmail-mcp\n```\n\n---\n\n### Option 2: Add to Claude Desktop\n\nOpen your Claude Desktop configuration file:\n- **macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`\n- **Windows**: `%APPDATA%\\Claude\\claude_desktop_config.json`\n- **Linux**: `~/.config/Claude/claude_desktop_config.json`\n\nAdd `aliasmail` to your `mcpServers`:\n\n```json\n{\n \"mcpServers\": {\n \"aliasmail\": {\n \"command\": \"npx\",\n \"args\": [\"-y\", \"aliasmail-mcp\"]\n }\n }\n}\n```\n\nRestart Claude Desktop, and you'll see the AliasMail tools icon ready in your prompt window!\n\n---\n\n### Option 3: Add to Cursor IDE\n\nAdd to your project's `.cursor/mcp.json` or your global Cursor settings:\n\n```json\n{\n \"mcpServers\": {\n \"aliasmail\": {\n \"command\": \"npx\",\n \"args\": [\"-y\", \"aliasmail-mcp\"]\n }\n }\n}\n```\n\n---\n\n### Option 4: Add to Windsurf\n\nIn your Windsurf MCP configuration (`~/.codeium/windsurf/mcp_config.json`):\n\n```json\n{\n \"mcpServers\": {\n \"aliasmail\": {\n \"command\": \"npx\",\n \"args\": [\"-y\", \"aliasmail-mcp\"]\n }\n }\n}\n```\n\n---\n\n### Option 5: Install via Smithery\n\nIf you use [Smithery.ai](https://smithery.ai/):\n\n```bash\nnpx -y @smithery/cli install aliasmail-mcp --client claude\n```\n\n---\n\n## 🛠️ Available MCP Tools\n\n### 📬 Disposable & Temporary Inbox Tools\n\n| Tool | Description |\n|---|---|\n| `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. |\n| `aliasmail_wait_for_code` | **Autonomous Agent Power Tool**: Polls until an email arrives and automatically extracts the numerical OTP verification code or activation link. |\n| `aliasmail_get_messages` | Fetches all received messages in an inbox with sender, subject, timestamp, and snippet. |\n| `aliasmail_get_message` | Retrieves the full plain text, clean sanitized HTML, headers, and detected links for a specific email. |\n| `aliasmail_wait_for_email` | Waits for any incoming message matching optional sender or subject filters. |\n\n### 🛡️ Email Forensics & Security Tools\n\n| Tool | Description |\n|---|---|\n| `aliasmail_validate_email` | Validates RFC 5322 syntax, live domain MX records, typo domains (e.g. `gmial.com`), and disposable mailbox detection. |\n| `aliasmail_check_disposable` | Inspects whether any email or domain belongs to an ephemeral burner service or legitimate corporate MX. |\n| `aliasmail_check_spam_score` | Scans email subject and body against 5 spam trigger categories and calculates a 0–100 deliverability score. |\n| `aliasmail_analyze_headers` | Parses RFC 822 headers: SPF, DKIM, DMARC verdicts, hop relay transit timeline, and origin IP. |\n| `aliasmail_clean_tracking` | Defuses invisible 1x1 tracking pixels, read receipt beacons, and surveillance redirect links. |\n| `aliasmail_check_dns` | Real-time DNS audit of domain Mail Exchange (MX) records, SPF syntax, and DMARC enforcement. |\n| `aliasmail_health_check` | Checks live availability and status of AliasMail edge relay infrastructure. |\n\n---\n\n## 🤖 Example Agent Workflows\n\n### 1. Autonomous Signup & Email Verification\nGive this instruction to your AI agent (Cursor / Claude / Antigravity):\n\n> *\"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_code` to enter it automatically.\"*\n\nThe agent will:\n1. Call `aliasmail_create_inbox` ➔ receives `swiftfox309@aliasmail.space`\n2. Fill the registration form with `swiftfox309@aliasmail.space`\n3. Call `aliasmail_wait_for_code({ address: \"swiftfox309@aliasmail.space\" })`\n4. Receive `{ code: \"748291\", primaryUrl: \"https://example.com/verify?token=...\" }`\n5. Finish authentication seamlessly without human intervention.\n\n---\n\n### 2. Inspecting Spam & Tracking Pixels\n> *\"Analyze this marketing email HTML for spy trackers and test its deliverability score.\"*\n\nThe agent calls:\n1. `aliasmail_clean_tracking` to neutralize tracking pixels.\n2. `aliasmail_check_spam_score` to optimize email copy.\n\n---\n\n## 🌐 Live Web Interface\n\nWant to view emails manually in your browser? Every inbox created by this MCP server is immediately accessible on the web:\n- **Instant Web Inbox**: [https://aliasmail.space/temporary/](https://aliasmail.space/temporary/)\n- **Main Platform & Permanent Aliases**: [https://aliasmail.space/](https://aliasmail.space/)\n- **Free Email Security Tools**: [https://aliasmail.space/tools/](https://aliasmail.space/tools/)\n\n---\n\n## 🔒 Zero-Log Architecture & Privacy\n\nAliasMail is engineered with a strict privacy-first foundation:\n- **Zero IP logging**: We never log agent or client IP addresses.\n- **Automatic TTL Expiration**: Ephemeral messages are held in high-speed edge queues and purged automatically.\n- **Edge Routing**: Powered by Cloudflare Email Routing and BullMQ processing for sub-second delivery.\n\n---\n\n## 📄 License\n\nMIT © [AliasMail](https://aliasmail.space) & [Anshu Sharma](https://github.com/anshu4sharma)\n"}