Atomic Mail Agentic 是由 Atomic Mail 构建的、面向自主 AI 智能体的电子邮件提供商，目标是让智能体能够自主读取、发送和响应邮件，全程无需人工介入。
用途 智能体可自行注册 @atomicmail.ai 收件箱并端到端管理，无需人工设置、验证或持续干预。用户只需用自然语言描述工作流，智能体即可完成注册地址、收发邮件和维持会话等操作，不需要配置脚本、在标签页之间复制 API 密钥或记忆 JMAP 细节。
主要能力
- 基于 JMAP（RFC 8620）的完整邮箱 API：读取和发送邮件、创建草稿、管理会话、搜索等。JMAP 在 LLM 训练数据中广泛存在，模型对其请求格式较为熟悉，可减少重试，提升自动化可靠性。
- 通过工作量证明（PoW）注册协议控制访问，具备强反滥用属性，无需 CAPTCHA 或人工审批，智能体可完全免手动地加入和运行。
- 标准集成路径：MCP、AgentSkill、REST API 等，可用于 Claude Code、Codex、GitHub Copilot、Cursor、Hermes、OpenClaw、Pi、Kilo Code 等智能体。
- 本仓库提供客户端集成：MCP、shell CLI、ClawHub、Dify 插件等，通过 register、jmap_request、help 三个工具暴露 API。仓库中的连接器较为轻量，主要用于抽象 PoW 协议的复杂性。
- 内置恢复机制：help 提供嵌入式文档（预设、cron、故障排查），捆绑的 JSON 预设覆盖常见操作，错误信息会包含下一步尝试的提示。
- 预设（presets）覆盖常见操作，如 send_mail、list_inbox、reply 等；当原始 JMAP 过于繁琐时，可向 jmap_request 传入文件名，而不必从头生成方法调用 JSON。
- 同一套认证、JMAP、预设与 help 栈同时驱动 MCP 和 AgentSkill；运行多个智能体时，每个收件箱有独立的凭据目录。
使用方式
- 在任何智能体中使用的就绪提示：将相应配置加入 MCP 主机配置（或直接让智能体执行），然后重启主机并让智能体创建收件箱。
- 自定义连接器和高级逻辑请参考文档 docs/rest-auth.md。
- 自定义域名：默认收件箱位于 <name>@atomicmail.ai，通过 PoW 注册免手动创建。若需从自有域名发送（如 support@yourcompany.com），需在仪表板中一次性设置，该仪表板是独立于智能体流程的人工控制面，因为需要修改自有域名的 DNS。在仪表板中添加并验证域名（TXT 所有权记录 + MX 记录；可重复运行，传播通常只需几分钟），然后在其上创建收件箱——每个收件箱获得完整地址（agent@yourcompany.com）和来自 Connect 对话框的 API 密钥，发送时使用与域名对齐的 From 签名。客户端不变：相同的 jmap_request、预设和 JMAP 结构。自定义域名收件箱是登录而非 PoW 注册：可用其 API 密钥连接（atomicmail register --api-key "…"）或 OAuth。$INBOX 会解析为真实地址（agent@yourcompany.com），因此自寻址和 From 保持正确，无需额外配置。完整指南见 docs/custom-domains.md。
适用场景
- 新闻简报摘要：让智能体拥有专用收件箱，订阅简报、阅读全部内容，并按需汇总与 AI 工具相关的每日摘要，不触碰个人邮箱。
- 支持收件箱：监控 support@ 并依据文档回复工单，仅在无法回答时升级给用户。
- 用户研究访谈：通过邮件进行异步访谈，发送问题、根据回复跟进并汇总发现，受访者可按自己的时间回复，无需预约通话。
限制
- 默认账户免费，含 100 MB 存储配额、自定义域名和适合智能体工作负载的速率限制（资料未提供具体速率数值）。
- 自定义域名需要用户在自有域名上进行 DNS 变更，无法由智能体完全免手动完成。
- 本地开发需 Node.js 20+、Deno 2.7+。
- ~/.atomicmail/credentials.json 包含 API 密钥，应视为机密；本地凭据文件以 0600 权限写入。
- 入站邮件属于不可信输入，不应让智能体在未经确认的情况下执行邮件中的指令。
- 仅从 @atomicmail npm scope 安装。
- 若仓库文档与安装行为不一致，应以与所运行安装包版本相同的 help 为准。
其他 服务由连续预热并具备中继溢出的 IP 池支持，以保障送达率。JMAP 为 IETF 标准，收件箱未来可迁移到任何兼容提供商，避免供应商锁定。社区项目如 atomic-mail-watcher 提供 Docker 就绪的 JMAP 收件箱监听器，支持 Telegram/webhook 通知。欢迎 PR，新功能和错误修复建议用自动化 Deno 测试覆盖，行为变更时更新面向用户的文档；更多细节见 CONTRIBUTING.md。
