402sentinel-mcp

402sentinel-mcp

警告

退役通知。 此软件包所连接的 402Sentinel 服务（402sentinel.com）将于 2026 年 10 月 31 日退役，且该域名将不再续费（将于 2027 年 5 月到期）。10 月 31 日之后，默认端点将停止响应；2027 年 5 月之后，该域名可能由他人控制。此软件包可以发起 x402 付款，因此请勿保留默认指向 402sentinel.com 的版本——请卸载，或仅将其指向你信任的端点。此软件包已弃用；代码仍根据其许可证保留在此处。

**0.9.0（最终版本）：**不再提供默认端点，即使你设置了 402sentinel.com，也会被拒绝，因此此版本绝不会向已退役的域名发送请求或付款。仅将 SENTINEL_URL 设置为你运行且信任的服务。

MCP 工具，可让你的 AI Agent 在付款前检查 x402 交易对手的风险，并将风险转化为可强制执行的钱包支出策略。提供 payTo 地址，即可获得 0–100 的风险评分和 allow / review / block 决策；评分依据是 Base 上的链上结算行为（地址年龄、考虑 Facilitator 的付款方多样性、结算成熟度）以及交付结果反馈循环，并如实反映置信度和覆盖范围。

工具——审核卖家：

• assess_counterparty（$0.002）——风险评分、决策，以及可直接应用的 recommended_policy
• assess_counterparty_deep（$0.02）——同上，并扫描更多链上历史记录
• recommend_policy（$0.002）——决策和可供钱包使用的支出策略（限额、拒绝名单、审批）
• report_outcome（免费）——付款后报告交付情况，为可靠性反馈循环提供训练数据

工具——审核付款本身（买方侧）：

• firewall（$0.002）——你的 Agent 现在是否应该进行这笔付款？可检测欺诈性路由（payTo 与你通常付款的地址不一致）、资金耗尽速度、超额收费，以及源自注入内容的指令。agent_id 和钱包所有权签名会根据你配置的钱包自动附加——无需额外步骤即可获得可信的路由历史记录。
• firewall_record（免费）——为 Agent 录入付款历史，以便防火墙建立行为基线。
• firewall_outcome（免费）——裁定后报告实际发生的情况（欺诈 / 合法 / …），让防火墙学习哪些信号具有预测性，并降低噪声信号的权重（安全信号仍保持确定性）。

工具——审核资产和资金流：

• assess_rwa（$0.02）——RWA 风险关卡：在购买代币化资产（国债 / 股票 / 信贷）前进行评分。可感知代理合约的转账限制扫描和行为转账模拟——能发现 Agent 可以买入、却无法转让或赎回的许可制证券（资金被困），以及实时暂停状态、发行方身份和发行方制裁情况。
• compliance_check（$0.02）——付款前合规筛查：OFAC 制裁（强制拦截）、交易对手尽职调查等级、结构化交易 / 拆分交易检测、FATF Travel Rule 门槛（仅供参考）。不构成法律建议。
• verify_service（$0.02）——可选择申请 402Sentinel Verified 徽章：提交你自己的 payTo 地址进行深度结算图审计；通过后可获得带签名、限时有效的凭证和公开允许名单。未通过的结果将保密。

这是一个轻量客户端，用于连接托管服务 **https://402sentinel.com**——评分模型和 Facilitator 识别逻辑均在服务端运行（闭源）；此软件包只转发请求并支付费用，因此它是开源的。

快速入门——用 5 行代码为付款设置关卡

在你的 Agent 向任何 x402 交易对手付款前，先询问防火墙；如果结果不是 allow，就不要付款。无需 MCP——任何标准 x402 v2 客户端均可使用：

import { x402Client, x402HTTPClient } from "@x402/core/client";
import { registerExactEvmScheme } from "@x402/evm/exact/client";
import { privateKeyToAccount } from "viem/accounts";

const client = new x402Client();
registerExactEvmScheme(client, { signer: privateKeyToAccount(process.env.AGENT_KEY) });
const http = new x402HTTPClient(client);

const body = JSON.stringify({
  payment: { payto_address: target, amount, resource_url },
  context: { source: "web_content", untrusted_text: pageYouActedOn },   // pass what you scraped
});
const url = "https://402sentinel.com/api/firewall";
const init = (h = {}) => ({ method: "POST", headers: { "Content-Type": "application/json", ...h }, body });
const r1 = await fetch(url, init());
const pr = http.getPaymentRequiredResponse((n) => r1.headers.get(n), await r1.json());
const payment = http.encodePaymentSignatureHeader(await http.createPaymentPayload(pr));
const data = await (await fetch(url, init(payment))).json();

if (data.decision !== "allow") throw new Error(`402Sentinel ${data.decision}: ${data.recommended_action}`);
// …safe to pay `target`.

只需一次 $0.002 的调用，即可检测欺诈性路由（payTo 与你通常付款的地址不一致）、提示词注入付款（payTo 出现在 untrusted_text 中）、资金耗尽、超额收费以及受制裁 / 涉嫌非法的交易对手。

在 MCP 框架中（Claude、Cursor、……），只需添加该服务——你的 Agent 即可按名称使用全部 10 个工具（见下文的配置部分）：

{ "mcpServers": { "402sentinel": { "command": "402sentinel-mcp", "env": { "CLIENT_PRIVATE_KEY": "0x…" } } } }

安装

npm i -g @kaditang/402sentinel-mcp

配置

添加到你的 MCP 客户端（Claude Desktop、Cursor 等）：

{
  "mcpServers": {
    "402sentinel": {
      "command": "402sentinel-mcp",
      "env": {
        "CLIENT_PRIVATE_KEY": "0x...  // a Base wallet holding USDC on-chain (no ETH/gas needed)"
      }
    }
  }
}

付费调用的费用从 $0.002（浅度评估）到 $0.02（深度评估）不等，费用会通过标准 x402（Base 上的 exact EIP-3009——由 facilitator 提交转账，因此买方无需支付 gas）自动从已配置的钱包以 USDC 支付。免费工具无需密钥。

使用

Agent 会在授权付款前调用它：

assess_counterparty({
  target: { payto_address: "0x..." },
  payment_context: { amount: 10, asset: "USDC" },
  policy: { block_at_score: 70, review_at_score: 40 }
})
→ { decision: "review", risk_score: 52, confidence: 0.41, coverage: {...},
    dimensions: [...], recommendation: "...",
    recommended_policy: { action: "limit", max_payment_usdc: 5, daily_cap_usdc: 15,
                          add_to_denylist: false, require_human_approval: true } }

• block / deny → 不要付款
• review / limit → 限制风险敞口 / 使用托管（使用 recommended_policy 设置限额）
• allow → 继续

recommend_policy(...) 仅返回决策和 recommended_policy——将 max_payment_usdc / daily_cap_usdc / add_to_denylist 直接应用到 Agent 钱包的支出限额。付款后，调用 report_outcome({ assessment_id, outcome }) 以提升未来的评分。

免责声明

算法风险信号，仅供参考——不构成建议、背书，也不代表对任何一方的指控。评分是基于有限的公开链上数据和启发式规则得出的概率估算，可能会产生误判。请自行尽职调查；不要将其作为付款或拒绝付款的唯一依据。请参阅 https://402sentinel.com/terms。

MIT。