Yolfi Agent Kit 是 Yolfi 推出的 AI 智能体支付集成工具包，用于加密结账场景。它是一套 JSON 优先的 SDK、CLI、Agent Skill 和 MCP 服务器，使 AI 编程智能体能够通过 Yolfi 为应用添加稳定币结账、支付链接、支付状态查询、Webhook 验证以及基于 Webhook 的访问逻辑。
【用途】 开发者可将其用于 SaaS 产品、游戏、市场平台、捐赠页面、数字下载、内部工具以及由智能体构建的应用，为其添加 AI 智能体支付能力。它让编码智能体拥有安全的支付工作流：检查应用、授权或复用工作区、询问钱包与价格决策、创建 paylink、安装结账、验证 Webhook，并检查支付状态。
【主要能力】
- 通过 Yolfi paylink 提供托管加密结账。
- 为数字产品、积分、文件、工具或游戏物品创建一次性支付链接。
- 在 Yolfi 账户支持时设置周期性或订阅式支付链接。
- 捐赠与创作者支持支付页面。
- 从 paylink 创建公开支付发票的服务端路由。
- 通过 Yolfi 公开支付端点轮询支付状态。
- 验证 X-Yolfi-Signature 的 Webhook 处理器。
- 基于 Webhook 的授权逻辑，仅在确认支付事件后解锁访问。
- 适用于 Codex、Claude Code、Cursor、OpenClaw 及自定义自动化的智能体工作流。
【使用方式】 包内包含 SKILL.md 中的 Yolfi Payments Skill。安装方式为在项目中安装，或无需安装直接运行；可启动 stdio MCP 服务器。本地开发时，推荐流程为打开浏览器授权，并将生成的 yolfi_agent_* 凭据存入 ~/.yolfi/config.json，配置目录与文件在支持的环境下以 0700 和 0600 权限创建，可通过 YOLFI_CONFIG_HOME 覆盖配置目录。显式凭据仍然有效且优先于已存储凭据。CLI 与本地 MCP 服务器还支持通过邮件确认注册新的 Yolfi 用户：首次调用创建待处理注册、向所有者发送确认链接并在本地存储受保护的签入令牌；所有者打开链接后再次运行同一命令，第二次调用会检查待处理注册、将一次性 yolfi_agent_* 凭据存入受保护的本地配置，并从 CLI/MCP 输出中移除完整凭据。该命令仅用于注册；若邮箱已有 Yolfi 账户，应使用 OAuth 或本地浏览器设置。
CLI 命令示例包括：检查与 API 密钥关联的工作区；在用户提供钱包地址后配置结算钱包；配置一个或多个 Webhook 端点（投递、重试与签名密钥各自独立，CLI 将每次创建/轮换的密钥存入受保护的本地 Yolfi 配置，仅打印脱敏元数据）；列出已有 paylink 以避免重复创建；创建一次性支付链接；从 paylink 创建公开支付发票；检查支付状态。每个 CLI 命令都输出 JSON，便于智能体解析。
MCP 服务器提供生产环境 streamable HTTP 端点与本地 stdio 服务器。可用的 MCP 工具包括：yolfi_agent_setup_start、yolfi_agent_checkin、yolfi_agent_register、yolfi_auth_status、yolfi_organization_get、yolfi_organization_update、yolfi_settlement_configure、yolfi_webhooks_configure、yolfi_webhooks_list、yolfi_webhooks_update、yolfi_webhooks_rotate_secret、yolfi_webhooks_delete、yolfi_paylinks_create、yolfi_paylinks_list、yolfi_paylinks_get、yolfi_paylinks_disable、yolfi_payments_create、yolfi_payments_status、yolfi_webhooks_verify。Webhook 创建/轮换工具会将一次性签名密钥保存在受保护的本地 Yolfi 配置中，从不通过 CLI stdout 或 MCP 记录返回明文。破坏性工具（如 yolfi_paylinks_disable）必须仅在用户明确确认后运行。
智能体可编写 payload 文件并传给 CLI，应将返回的 paylink ID 保存在目标应用的环境变量/配置中，并使用 Yolfi 公开支付端点进行面向客户的结账与状态轮询。Webhook 验证方面，Yolfi 使用 X-Yolfi-Signature 签名 Webhook 负载，应在解析和信任事件前验证原始请求体；不要将前端重定向视为支付凭证，应使用已验证的 Webhook 与 Yolfi 支付状态检查。
【与 AI 编程智能体配合】 该工具包为代理式支付工作流设计，用户给出“添加支付”“销售此数字产品”“添加捐赠按钮”“为此游戏收费”或“将功能置于支付之后”等高层指令。Codex 可检查仓库、添加结账路由/组件、配置环境变量并将验证过的 Webhook 接入现有授权逻辑；Claude Code 可使用 MCP 服务器与 Agent Skill 添加支付链接、服务端处理器和状态检查，钱包与价格决策需用户批准；Cursor 可添加支付 UI 与后端处理器，同时避免将 Yolfi 密钥提交到源码；OpenClaw 与自定义智能体可通过 CLI、SDK、MCP 工具和 JSON payload 连接产品构建工作流。examples/ 文件夹包含可复制粘贴的工作流与 JSON payload 示例。
【限制】 它不是一个独立的 Yolfi 仪表盘，不是钱包提供商，也不是具有重复业务逻辑的第二个支付 API。它不会自行发明结算钱包、产品名称、价格、货币、订阅或捐赠金额；不会绕过用户对破坏性操作的确认；不会将密钥存储在源代码中；不会用重定向作为支付确认。ChatGPT 网页版只能通过插件使用远程 MCP 端点，无法启动本地 stdio 包。每个 Webhook 端点有各自的签名密钥，组织 API 密钥从不作为签名密钥使用。浏览器设置仅在成功签入时返回一次智能体凭据。最终支付确认应来自已验证的 Webhook 与支付状态检查。MCP 目录批准与本包相互独立，在列表被接受前不要声称已获官方目录批准。
官网：https://yolfi.com Agent Kit 页面：https://yolfi.com/ai-agent-kit 文档：https://docs.yolfi.com/en/agent-kit LLM 索引：https://docs.yolfi.com/llms.txt 完整 LLM 上下文：https://docs.yolfi.com/llms-full.txt npm 包：https://www.npmjs.com/package/@yolfi/agent GitHub 仓库：https://github.com/yolfinance/yolfi-agent Glama MCP 列表：https://glama.ai/mcp/servers/yolfinance/yolfi-agent 集成指南：https://yolfi.com/blog/ai-agent-payment-integration-api
