safe4

Safe4 — 面向 AI Agent 的支付防火墙，以 MCP 服务形式提供

Safe4 会核验 AI Agent 实际接到的任务，以此判断是否应允许其提出的付款。

它要解决的是预算限制无法发现的情况：付款没有超出任何预算，属于允许的类别，收款方也已获批准，却仍然买错了东西，因为这笔购买与任务无关。

此代码库是托管式 MCP 服务的公开清单和客户端示例。服务本身运行在 api.safe4.ai；无需安装服务端。

连接

使用 Streamable HTTP，无需安装：

{
  "mcpServers": {
    "safe4": {
      "type": "http",
      "url": "https://api.safe4.ai/mcp/"
    }
  }
}

连接和列出工具均免费。只有 safe4_authorize 是付费工具。

工具

safe4_price — 免费

返回当前价格以及端点接受的支付网络，让 Agent 在进行付费调用前了解费用。

safe4_authorize — 付费，每次调用通过 x402 使用 USDC 结算

针对拟议付款返回 ALLOW 或 DENY 决策，并附上原因代码、匹配的概念和一条哈希链式审计记录。

未随调用提供付款时，它会返回 x402 挑战，而非决策。支持 x402 的客户端完成付款后，会在 payment 参数中携带生成的载荷再次调用。

参数：

参数	含义
task	Agent 接到的任务，即其委托方所述的任务
purchase	要购买的内容
purchase_purpose	此次购买如何服务于任务
amount, currency	拟议付款的金额和币种
counterparty	付款接收方
service_category	所购内容的类别
allowed_service_categories	委托方允许的类别
allowed_counterparties	可选。委托方允许的收款方
task_id	可选。写入审计记录的任务 ID
payment	x402 付款载荷。省略此项即可获取价格列表

任务和两个允许列表是委托方的约束，而非 Agent 的约束——Safe4 会依据它们核验购买。因此，如果 Agent 自行填写 task，就等于自己给自己的作业打分。Safe4 会记录收到的每个字段，并将任务上下文标记为由请求提供，因此之后可以在审计记录中看出约束是否被替换。

无需付款即可试用

此示例会运行所有免费功能——连接、列出工具、读取价格、获取挑战——并在签署任何内容前停止。它只需要 httpx：无需密钥，也无需已注资的钱包。

python examples/mcp_buyer_demo.py https://api.safe4.ai --dry-run

移除 --dry-run 并设置 SAFE4_BUYER_PRIVATE_KEY，即可购买真实决策。这样会为服务器所公布的准确金额和收款方签署 EIP-3009 授权，仅此而已；脚本不托管任何资金，Safe4 也绝不会看到密钥。

决策依据

依次进行四项核验，购买必须全部通过：

1. 预算和限额 — 单笔、每日以及按 Agent 划分的限额。
2. 服务类别 — 购买类别必须属于委托方允许的类别。
3. 收款方 — 如果任务声明了 allowed_counterparties，则会拒绝向其他任何人付款。这是唯一能发现收款方被调换的核验；在这种攻击中，任务文本和类别都完全相同。
4. 任务与购买的匹配 — 任务必须能够说明购买所称要买的内容，而不能只是与之共享一两个词。

每个决策都会追加到哈希链式审计日志中。每条记录都包含上一条记录的哈希，因此即使经过重启和重新部署，记录也能连续保留并显现篡改。

付款

通过 x402 按次使用 USDC 计价。端点会在 402 挑战中公布条款；买家可选择任一公布的网络付款。Safe4 不持有钱包密钥，也不托管买家的资金。

链接

• API 文档 — https://api.safe4.ai/docs
• OpenAPI 架构 — https://api.safe4.ai/openapi.json
• x402 发现 — https://api.safe4.ai/.well-known/x402
• 网站 — https://safe4.ai

安全

报告说明请参阅 SECURITY.md。请勿公开提交包含漏洞利用详情的问题。

许可证

本仓库中的清单和客户端示例采用 MIT 许可证。 它们所介绍的托管服务是独立的商业产品。