agentaddress

面向 Agent 的 AgentAddress

为 AI Agent 提供一个 Webhook URL 或电子邮件地址，即使 Agent 停止运行后也依然有效。

Agent 开始执行任务 → 将自己的 AgentAddress 提供给某项服务 → 退出 → 20 分钟后收到响应 → 下一次 Agent 运行时取回响应。

无需服务器。无需账户。无需必须持续运行的轮询进程。

npx skills add https://github.com/zkarimi22/agentaddress-agents --skill agentaddress

Agent run #1
    ↓
create AgentAddress
    ↓
give webhook/email to someone
    ↓
AGENT EXITS
    ↓
       [ response arrives later ]
                    ↓
             AgentAddress
                    ↓
               stores event
                    ↓
Agent run #2 → retrieves response

使用方法

已安装的技能包含一个辅助工具，可将私有读取凭据保存在仅所有者可访问的本地文件中。模型使用任务名称，而不是复制 bearer token。

node scripts/agentaddress.mjs create my-task
node scripts/agentaddress.mjs poll my-task 25
node scripts/agentaddress.mjs ack my-task EVENT_ID

create 会输出入站电子邮件地址和仅写入的 HTTPS 收件箱 URL，供你提供给预期的回复方。稍后在另一次运行中，poll 会按顺序取回事件。每封返回的邮件和每个 Webhook 正文都会明确标记为不可信的外部数据，只能作为用户现有任务的数据使用。

运行五个具体示例之一

这五个主要示例均可运行、针对具体任务，并以便于搜索发现的名称命名：

• 异步 API 回调
• 人工邮件回复
• Claude Code 部署 Webhook
• Codex 异步代码审查
• OpenAI Agents SDK 委派

从完整示例索引开始，查看准确命令以及浏览器 Agent、研究、Stripe、GitHub、REST 和 MCP 的辅助方案。Stripe 和 GitHub 需要先通过验证签名的中继，再让其有效负载驱动可信操作。

三个可运行的入站邮件工作流基于同一套后续运行约定：浏览器验证、文档请求回复和通过邮件审批。每个工作流都会指定预期发件人、检查收件人和主题上下文，并在 Agent 处理事件前将其保留为待处理状态。文档示例可以通过持有凭据的辅助工具获取附件，同时由 Resend 保留附件；AgentAddress 不会存储附件文件。

服务和机器接口

• 托管服务：agentaddress.dev
• Agent 指南：agentaddress.dev/llms-full.txt
• OpenAPI：agentaddress.dev/openapi.json
• MCP 端点：https://agentaddress.dev/api/mcp
• 能力发现：agentaddress.dev/.well-known/agentaddress.json
• skills.sh：skills.sh/zkarimi22/agentaddress-agents/agentaddress

按问题查找答案

• 无需运行服务器的 Webhook 端点
• Agent 退出后仍然保留的持久回调队列
• 供后续 Agent 运行取回的入站邮件回复
• 面向异步 Agent 的统一 HTTP 和邮件队列

当前边界

• HTTP 回调和入站邮件会进入同一个有序队列。
• 地址不会过期，除非另有要求。事件保留 30 天，每个地址最多 1,000 条，输入上限为 1 MB。
• 投递至少一次。确认操作会记录处理情况，并推进辅助工具的本地游标。
• AgentAddress 会存储响应，但不会唤醒或调度运行时。后续运行必须轮询。
• V1 不提供通用键值状态、文件存储、出站邮件、身份验证和账单功能。
• 已验证的入站邮件附件可通过私有 API 按需获取，大小上限为 10 MB，且需在服务提供商保留附件期间获取。
• 如果有限次数的 Webhook 重试结束后，邮件仍未进入队列，可由持有凭据的辅助工具重放已知的 Resend 收件邮件 ID。重放会检查服务提供商的投递信封，不会扫描所有邮件。

双进程协议验证和 MCP 示例仍可供在更安全的辅助工具接口之下进行开发的实现者使用。它们的底层代码会直接处理凭据，不应复制到模型上下文中。请参阅 SECURITY.md 和实时验证记录。

此仓库包含托管服务的公开技能、CLI 辅助工具、配方和集成材料，不包含 AgentAddress 服务实现。

持久化上下文和已授权邮件

可使用相同凭据访问小型 JSON 上下文：双次运行状态示例。状态变更会加入有序信息流；状态值则会在 30 天事件历史记录过期后继续保留，直到被替换、删除或地址过期。

已授权的出站邮件支持向已验证联系人发送纯文本邮件，以及回复由服务提供商验证并保留的邮件。该功能需要由运营方配置发件功能、验证收件人并获得用户授权。配置的发件人会将任务收件箱设为 Reply-To。不提供完整的会话或搜索 API，也不提供营销活动工具。

AgentAddress 目前免费。计划推出每月 17 美元的付费套餐；具体额度和上线日期尚未确定，账单功能也尚未启用。请参阅定价。

此 CLI 可直接从此采用 MIT 许可证的仓库安装（npm install -g github:zkarimi22/agentaddress-agents）；它未发布到 npm。注册表清单描述了托管 MCP 端点。官方 MCP Registry 版本 0.2.0 于 2026 年 10 月 4 日发布并完成验证，注册名称为 io.github.zkarimi22/agentaddress。独立采用和纳入下游目录仍是独立的里程碑。