用途：为多个编码智能体提供类似邮件的协调层，避免互相覆盖编辑、遗漏并行工作上下文，以及依赖人工转达消息。
主要能力：智能体以形容词+名词命名（如 GreenCastle），按项目命名空间注册；提供收件箱/发件箱、线程化消息、重要级别与确认要求；文件预留（租约）用于声明编辑意图，可选 pre-commit 守卫在提交时拦截冲突；联系人策略支持 open、auto、contacts_only、block_all；消息历史支持 FTS5 搜索；Human Overseer 允许人类从 Web UI 直接向智能体发送高优先级消息。数据由 Git（可人工审计）与 SQLite（快速查询）支撑。
使用方式：安装后可用别名 am 启动，或运行 ./scripts/run_server_with_token.sh，默认地址 http://127.0.0.1:8765，Web UI 为 /mail。核心流程为 macro_start_session 引导会话、file_reservation_paths 预留文件、send_message 公告工作、fetch_inbox 检查收件箱、release_file_reservations 释放预留。提供四个宏：macro_start_session、macro_prepare_thread、macro_file_reservation_cycle、macro_contact_handshake。也可用 resource://inbox/{agent} 等资源快速读取。安装命令：curl -fsSL "https://raw.githubusercontent.com/Dicklesworthstone/mcp_agent_mail/main/scripts/install.sh?$(date +%s)" | bash -s -- --yes。支持 Docker 运行与静态邮箱导出、灾难恢复、doctor 诊断。
适用场景：多智能体并行编码、前后端或多仓库跨项目协调、与 Beads（br-###）任务标识对齐、与 Flywheel 生态工具集成。
限制：文件预留为建议性锁，冲突仍会授予并需自行协调；联系人策略可能阻止消息；需先注册智能体；具体收费、价格与平台支持资料暂未提供。