TossInbox 是一款临时邮箱（temp-mail）CLI 工具兼 MCP 服务器，面向人类用户与 AI 智能体，核心用途是：生成一次性收件箱、等待验证邮件、提取 OTP 验证码，最后将其丢弃。项目由 Mohamed Khairy 创建，采用 MIT 许可。
用途：避免向各类注册表单暴露真实邮箱地址，同时服务于注册流程、QA 邮件流程和测试自动化；也可以让 AI 智能体通过内置 MCP 服务器完成全部操作。
主要能力：
- 一条命令创建全新的一次性邮箱地址，等待邮件验证到达，提取 OTP 码，并在完成后删除收件箱（服务端与本地均删除）。
- 所有命令均支持 --json 输出，供机器解析；人类读取普通输出，智能体解析 --json。
- 有文档化的退出码 0–4，无交互式提示。
- 内置 MCP 服务器，暴露若干工具，使 Claude、Cursor 及任何 MCP 客户端能够以原生工具方式创建收件箱并读取验证码。
- 仓库根目录提供 llms.txt，便于 LLM 友好地接入。
- 支持 GitHub Action，可在 CI 中测试真实的注册/验证邮件流程，输出 address（一次性收件箱）与 code（提取的 OTP）。
- 提供七个上游免费服务商，无需 API 密钥；provider 故障时支持自动故障转移。
- 附件（v0.1.6）：在 mailtm、mailgw 和 tempmailplus 上支持完整列表与下载；tempmailio 在其上游返回附件时显示（仅当上游暴露 URL 时可下载）；tempmaillol、guerrillamail 和 maildrop 上游不暴露附件，TossInbox 会明确告知而非猜测。
- 可通过 tossinbox read <id> --save 将附件（以及 HTML/纯文本正文）写入 ./tossinbox-attachments/<message-id>/。
使用方式：
- 环境要求 Node.js 18+，另提供 Homebrew、npm、npx、GitHub Action 等安装途径。
- 四条命令完成从零到丢弃收件箱的流程；每个命令也可加 --json 获得机器可读输出。
- MCP 服务器配置：Claude Desktop / Cursor / 任意 MCP 客户端；全局安装后可直接使用 tossinbox-mcp 命令，等效于 npx -y tossinbox mcp。
- 与 AI 智能体配合使用时，CLI 本身即为接口：--json、文档化退出码 0–4、零交互提示。
适用场景：
- 个人隐私保护：不再向每个注册表单暴露真实地址。
- 智能体自动化：任何 MCP 客户端（Claude Desktop、Claude Code、Cursor、Windsurf、Cline、Codex CLI、Gemini CLI 等）以及任何具备 shell 能力的智能体。
- CI/CD：通过 GitHub Action 测试注册与验证邮件流程，无需智能体。
限制与说明：
- 仅接收邮件，不支持发送邮件；没有批量发送或批量注册模式。
- 免费且 MIT 许可，七个上游服务商均免费且无需 API 密钥；但若某站点屏蔽了已知的一次性邮箱域名，可尝试其他服务商，若两者均被屏蔽则无法使用。
- 本地状态文件（~/.tossinbox/state.json，可用 TOSSINBOX_STATE 覆盖）保存服务商令牌，权限为 0600；toss 命令会在服务商支持时删除账户，然后清除本地状态。
- 临时邮箱用于隐私与测试，不得滥用，请遵守各服务商的条款。
- Windows 上同样可用：只要 Node.js 18+ 能运行即可，npx tossinbox@latest spawn 在 PowerShell 中表现一致。
其他细节：
- 项目网站与文档位于 tossinbox.pages.dev。
- 提供面向智能体的发现入口：仓库根目录 llms.txt、网站 llms.txt、MCP Server Card、Agent skill（SKILL.md）与技能索引、API catalog（RFC 9727），以及每个文档页面的 Markdown 镜像（可对 tossinbox.pages.dev 发送 Accept: text/markdown，或获取 /index.md、/quickstart.md、/cli.md、/agents.md、/faq.md）。
- 添加服务商只需实现一个小接口（createInbox、listMessages、readMessage，可选 destroyInbox）。
- 安装方式包括：GitHub Action（mohamed-khairy-5i/tossinbox@v1）、Homebrew tap（brew install mohamed-khairy-5i/tap/tossinbox）、npm 发布包 tossinbox + tossinbox-mcp。
- 版本演进包括：mail.gw 服务商（v0.1.3）、另外四个服务商 tempmail.lol、temp-mail.io、tempmail.plus、maildrop.cc（v0.1.4）、服务商故障转移（v0.1.5）、附件与 HTML 正文（v0.1.6）。
- 项目还提供快速开始、CLI 参考、Agents 与 MCP、FAQ、示例、指南、路线图、更新日志、贡献与安全等文档。
具体命令示例、安装命令细节、各 MCP 客户端的配置步骤等，资料中仅给出概括性描述，未提供完整逐条内容，故此处不再展开。
