Frisk

frisk-mcp

适用于 Frisk 的 MCP 服务： 在 Agent 付款前筛查 x402 付款的交易对手。

它提供一个工具 screen_payment，运行 Frisk 的确定性检查—— 地址合理性、动态 payTo 比对、传输安全性，以及你自己的 支出策略——并返回带有原因的 allow / review / block。

适用场景与非适用场景

MCP 工具会在模型决定调用时运行。如果模型可以跳过付款检查， 那么这种保障就不如在签署付款的代码路径中执行同样的检查。

因此：

• 使用库 — frisk-screen — 在资金实际转移的地方使用。它采用 MIT 许可证、无依赖项，且在本地运行。
• 使用此服务 进行检查（“向这个地址付款安全吗？”），以及供无法导入库的 Agent 使用。

在这两种情况下，Frisk 都只提供建议：它返回判定结果，由你的代码决定。 它不会持有资金，也无法独自阻止付款。

安装

npx frisk-mcp

在任意 MCP 客户端的服务配置中：

{
  "mcpServers": {
    "frisk": {
      "command": "npx",
      "args": ["-y", "frisk-mcp"]
    }
  }
}

无需 API 密钥、无需账户、无需网络调用：在未配置时，服务会完全在你的设备上 进行筛查。

托管模式（可选）

设置 FRISK_API_KEY，即可让托管服务处理同一工具调用；托管服务会添加信誉图谱信号， 并返回置信度更高的判定结果：

{
  "mcpServers": {
    "frisk": {
      "command": "npx",
      "args": ["-y", "frisk-mcp"],
      "env": { "FRISK_API_KEY": "..." }
    }
  }
}

托管版目前处于早期访问阶段——请发送邮件至 [email protected]。以上所有功能 均无需使用托管版。

变量	默认值	含义
FRISK_API_KEY	未设置	启用托管筛查。未设置表示完全离线。
FRISK_BASE_URL	https://api.tryfrisk.dev	覆盖托管端点。

工具

screen_payment

参数	类型	说明
counterparty	string，必填	Agent 打算付款的地址。
endpoint	string	提供付款报价的 URL；会检查传输是否使用明文。
amount	number	即将支付的金额。
asset	string	资产符号，例如 USDC。
observedPayTo	string	端点实际返回的 payTo。如果它与 counterparty 不同，即为动态 payTo 替换。
strictness	number 0–1	0 表示宽松，1 表示极度谨慎。默认值为 0.3。
maxPerCall	number	单次调用的支出上限。
allowedAssets	string[]	Agent 可以支付的资产。

返回 verdict、trustScore、confidence、reasons、policyHits、 source（lite 或 hosted）和 allowed。

不包含的功能

它无法检测女巫集群；离线时也无法查看地址的历史记录——因此，轻量筛查总是会将 "low" 作为置信度。此外，它也无法修复付款所依赖的底层协议：重放、结算竞态 以及对 facilitator 的信任都属于 x402 本身，而非正在签署的请求。这些限制详见 导致 x402 付款出错的五种方式。

许可证

MIT