AgentPay

AgentPay

信任 + 能力保险库 + 受治理的付费执行，专为 Agent 打造。

---

AgentPay 是 AI Agent 与现实世界之间的权限层。 它负责处理服务提供商访问权限、资金使用权限、人工审批、精确调用恢复和凭证，让 Agent 无需在聊天中暴露原始密钥或反复设置控制面板，即可端到端完成工作。

它不是通用的“Agent 平台”。 它是让自主执行切实可用的信任接口。

npx -y @agentpayxyz/mcp-server

这一条命令即可让任何兼容 MCP 的宿主能够：

• 请求 API 访问权限
• 在不向 Agent 暴露原始密钥的情况下，将凭证存入保险库
• 运行受治理的付费执行
• 仅在需要时暂停以等待 OTP 或审批
• 自动恢复被阻塞的精确调用
• 稍后从同一工作台重复使用受治理的访问权限

---

AgentPay 商务网络

AgentPay 现已推出专注于电子商务的功能：购物者可根据具体需求发现产品，然后设置可视化的买家宪章，明确类别范围、预算、配送、退货、商家政策和人工审批要求。AgentPay 会在可选的模型排序之前执行该宪章，通过审批的匹配结果则会继续进入商家结账流程。商家可以通过商品目录实情、以来源为依据的产品图片和签名归因草稿，触达需求图谱的另一端。

• 购物者体验：/commerce
• 卖家增长工作区：/commerce/studio
• 需求导向 API：POST /api/commerce/discover
• 闭域 GPT-5.6 编译器：POST /api/commerce/compile
• 商品目录审计 API：POST /api/commerce/catalog/audit
• MCP 工具：agentpay_discover_products、agentpay_compile_product_decision 和 agentpay_audit_catalog_truth
• 创始人与 SEO 规范：docs/COMMERCE_CONTROL_PLANE.md
• OpenAI Build Week 证据和评审运行手册：docs/OPENAI_BUILD_WEEK_2026.md
• 标注日期的黑客松复用决策及活动专属构建边界：docs/HACKATHON_REUSE_2026-07-18.md

随附的库存和需求索引是沙盒测试数据，不代表真实商家、客户、订单或收入。商家连接、公开库存、转化 Webhook、费用收取和部署仍需通过单独的审批与验证关卡。

---

Casper Buildathon 参赛项目

Bee + Clickey：配备 Casper 可验证 Agent 支付的开箱即用创始人工具

Bee 是运营中枢。Clickey 是桌面伴侣。两者协同，在真实的本地 AI 集群中分配工作，通过 AgentPay Feed MCP 发现工具，并通过经创始人批准的支付渠道暂存付款收据。针对 Casper Agentic Buildathon，本项目新增了原生 Casper 收据路径：Bee 可以暂存 x402-casper 支付载荷，并将 Bee mandate/receipt id 与 Casper Testnet 转账关联。

从这里开始：

• 提交材料包
• 截止日期后恢复材料包
• Bee 控制平面
• Casper 收据运行器

评委可以验证本地证明路径：

node --test ops/mac-mini/bee/bee.test.mjs
ops/mac-mini/bin/bee doctor
ops/mac-mini/bin/bee caps
ops/mac-mini/bin/bee feed
npm --prefix ops/mac-mini/bee/casper run proof
npm --prefix ops/mac-mini/bee/casper run video

要广播真实的测试网证明，需要专用且已注资的 Casper 测试网密钥：

CASPER_PRIVATE_KEY_HEX=<testnet-private-key-hex> \
CASPER_RECIPIENT_PUBLIC_KEY_HEX=<recipient-public-key-hex> \
BEE_CASPER_RECEIPT_ID=<bee-mandate-id-or-demo-receipt-id> \
npm --prefix ops/mac-mini/bee/casper run receipt

Bee 可以准备并暂存高影响操作，但不会自主发布、上传、更改 OAuth/账户设置、转移资金或绕过创始人审批。实时结算仍由创始人触发。

---

为何构建

Agent 总会在同一个环节失败：

1. 它们需要开发者尚未接入的 API
2. 它们需要人类不应粘贴到聊天中的凭据
3. 它们遇到付费步骤后就失去连续性

AgentPay 解决了这个衔接问题。

能力保险库 用户通过 AgentPay 连接一次服务提供商。原始凭据会存储在服务器端的保险库中。Agent 只能获得受治理的能力访问权限。

受治理的付费执行 人类只需设置一次防护规则：资金渠道、自动批准限额、OTP 策略和支出限额。AgentPay 会在 Agent 执行操作时强制执行这些规则。

精确调用续接 如果付费步骤需要人类介入，AgentPay 会暂停、收集最低限度的批准，然后续接被阻塞的确切调用，无需 Agent 重新构建调用内容。

同一工作台复用 本地项目无需原始服务提供商密钥。AgentPay 可以签发不透明、可撤销的工作台租约，让同一工作台之后仍能复用受治理的访问权限。

必然路径

AgentPay 围绕以下路径构建：

1. Agent 请求使用某个 API。
2. AgentPay 检查是否已存在受治理的访问权限。
3. 如果不存在，AgentPay 会运行一次托管设置流程，以配置权限和连接服务提供商。
4. Agent 可以免费使用该能力，直到需要付费使用为止。
5. 只有在策略要求时，AgentPay 才会暂停并等待 OTP 或确认。
6. AgentPay 会续接被阻塞的确切调用。
7. 同一工作台之后可以复用受治理的访问权限，无需重新输入密钥。

---

30 秒快速上手

将 AgentPay 添加到 Claude Desktop（claude_desktop_config.json）：

{
  "mcpServers": {
    "agentpay": {
      "command": "npx",
      "args": ["-y", "@agentpayxyz/mcp-server"],
      "env": {
        "AGENTPAY_API_KEY": "apk_your_key_here",
        "AGENTPAY_MERCHANT_ID": "your_merchant_id"
      }
    }
  }
}

获取 API 密钥：

curl -s -X POST https://api.agentpay.so/api/merchants/register \
  -H "Content-Type: application/json" \
  -d '{ "name": "My Agent", "email": "[email protected]" }'

现在向你的宿主提问：

“我的 Agent 需要 Firecrawl。设置 $5 的自动批准限额，超过限额时要求 OTP，并确保密钥不会出现在聊天中。”

或者：

“我的 Agent 在这个工作台需要 Databento。如果已有访问权限，就复用；如果没有，就启动最精简的 AgentPay 设置流程。”

完整快速入门指南

---

终端原生控制平面

AgentPay 应通过宿主和终端操作，而不是通过商户仪表板。

关键接口：

• GET /api/capabilities/authority-bootstrap
• POST /api/capabilities/authority-bootstrap
• POST /api/capabilities/access-resolve
• POST /api/capabilities/onboarding-sessions
• POST /api/capabilities/lease-execute
• GET /api/capabilities/leases
• POST /api/capabilities/leases/:leaseId/revoke
• POST /api/capabilities/:capabilityId/execute

这些接口让宿主或 Agent 能够：

• 读取权限状态
• 设置防护规则
• 连接服务提供商
• 仅在需要时请求人工批准
• 安全地复用之后的受治理访问权限

旗舰服务商路径

当 AgentPay 负责高价值 Agent API 的设置与持续使用时，当前的切入点最具优势。

当前优先路径：

• Databento
• Firecrawl
• Browserbase
• Exa
• 通用 REST API 备用方案

产品目标很简单：访问服务商控制面板应该成为例外，而非默认做法。

远程 MCP

对于支持远程 MCP 的主机：

https://api.agentpay.so/api/mcp

使用 API 密钥作为 Bearer 令牌进行身份验证，或为 Claude、OpenAI 或其他远程 MCP 主机签发短期令牌：

curl -X POST https://api.agentpay.so/api/mcp/tokens \
  -H "Authorization: Bearer apk_your_key_here" \
  -d '{ "audience": "openai", "ttlSeconds": 3600 }'

Ace - 基于 AgentPay 构建

Ace 是基于 AgentPay 构建的验证入口。 它在真实环境中展示了核心衔接点，但这并非核心定位。

产品现状

如果仍需人工：

• 将原始服务商密钥粘贴到聊天中
• 付款后重新构建被拦截的调用
• 不断重新打开服务商控制面板
• 或者无法在审批与执行之间保持连续性

那么产品仍未完成。

开发者资源

资源	链接
快速入门	QUICKSTART.md
MCP 服务参考	packages/mcp-server/README.md
完整 API 参考	openapi.yaml
终端原生控制平面	docs/TERMINAL_NATIVE_CONTROL_PLANE_20260419.md
示例	examples/README.md
安全模型	docs/SECURITY_MODEL.md
安全支付服务商	docs/PAYMENT_PROVIDERS.md
商务网络	docs/COMMERCE_CONTROL_PLANE.md

仓库结构

apps/
  api-edge/         Cloudflare Workers public API
  meridian/         Ace front door

packages/
  mcp-server/       Published MCP package
  sdk/              TypeScript SDK
  sdk-node/         Node.js SDK

examples/           Example agents and adapters
docs/               Architecture and product notes
migrations/         PostgreSQL migrations
ops/                Founder and growth operating artifacts

许可证

Business Source License 1.1。将于 2029-01-01 转为 AGPL-3.0。