mohamed-khairy-5i/tossinbox

Overview

Tossinbox is a disposable email CLI and MCP server for AI agents. It spawns a throwaway inbox, waits for an OTP verification code, and discards the inbox. Commands output JSON and use exit codes 0-4, with no sign-up or API keys required.

Best for

Best for
Developers and AI agents needing quick throwaway email addresses for OTP verification

Use cases

• Generate a temporary inbox to receive OTP codes during automated testing
• Integrate with AI agents via MCP to verify email-based signups
• Use in CI pipelines via GitHub Action to handle email verification

How to use

Install

npx tossinbox@latest spawn

Tools exposed

• create_inbox
• list_messages
• read_message
• wait_for_code

Tested with

Claude Desktop, Claude Code, Cursor, Windsurf, Cline

Notes

Tossinbox is a disposable email CLI and MCP server for AI agents. It spawns a throwaway inbox, waits for an OTP verification code, and discards the inbox. Commands output JSON and use exit codes 0-4, with no sign-up or API keys required.

0 stars on GitHub. Last updated 2026-09-16. Licensed MIT.

Use cases

• Generate a temporary inbox to receive OTP codes during automated testing
• Integrate with AI agents via MCP to verify email-based signups
• Use in CI pipelines via GitHub Action to handle email verification

Pros

• No sign-up or API keys required
• JSON output and exit codes make it scriptable
• Multiple install paths: npm, npx, Homebrew, GitHub Action

Cons

• Requires Node 18+
• Zero GitHub stars suggests limited community validation
• Limited to disposable email use cases

Indexed from awesome-mcp-servers-punkpeye and enriched against its public facts.