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には、ご自身が運用し、信頼しているサーバーだけを設定してください。

AI エージェントが決済前にx402の取引相手のリスクを確認し、そのリスクを強制力のあるウォレット支出ポリシーに反映できるMCPツールです。payToアドレスを渡すと、オンチェーンのBase上の決済行動（アドレスの経過期間、ファシリテーターを考慮した支払者の多様性、決済の成熟度）と、配信結果のフィードバックループに基づいて、0～100のリスクスコアとallow／review／blockの判定を返します。信頼度とカバレッジも正直に示します。

ツール — 販売者を審査：

• assess_counterparty（$0.002）— リスクスコア、判定、すぐに適用できるrecommended_policy
• assess_counterparty_deep（$0.02）— 同じ情報を返し、より多くのオンチェーン履歴をスキャン
• recommend_policy（$0.002）— 判定と、ウォレットに適用できる支出ポリシー（上限、拒否リスト、承認）
• report_outcome（無料）— 決済後に配信結果を報告し、信頼性のフィードバックループを学習させます

ツール — 決済そのものを審査（購入者側）：

• firewall（$0.002）— あなたのエージェントは今、この決済を実行すべきでしょうか？不正なルーティング（通常支払うアドレスと異なるpayToへの差し替え）、資金流出の速度、過剰請求、インジェクション由来の指示を検出します。設定済みのウォレットからagent_idとウォレット所有権の署名が自動的に付与されます。追加の手順なしで、信頼できるルーティング履歴を利用できます。
• firewall_record（無料）— エージェントの決済履歴を登録し、ファイアウォールの行動ベースラインを作成します。
• firewall_outcome（無料）— 判定後に実際の結果（詐欺／正当など）を報告すると、ファイアウォールはどのシグナルが予測に役立つかを学習し、ノイズの多いシグナルの重みを下げます（安全性シグナルは決定論的なままです）。

ツール — 資産と資金の流れを審査：

• assess_rwa（$0.02）— RWAリスクゲート：購入前にトークン化資産（国債／株式／クレジット）をスコアリングします。プロキシを考慮した譲渡制限スキャンと、動作ベースの譲渡シミュレーションにより、エージェントが購入できても譲渡や償還はできない許可制証券（資金が拘束される）、稼働中の一時停止状態、発行体の身元および発行体への制裁を検出します。
• compliance_check（$0.02）— 決済前のコンプライアンス審査：OFAC制裁（強制ブロック）、取引相手のデューデリジェンス段階、ストラクチャリング／スムーフィングの検出、FATFトラベルルールのしきい値（参考情報）。法的助言ではありません。
• verify_service（$0.02）— 任意で取得できる402Sentinel Verifiedバッジ：自身のpayToを提出し、決済グラフの詳細監査を受けます。合格すると、署名付きの期間限定クレデンシャルと公開許可リストが発行されます。不合格の結果は非公開のままです。

https://402sentinel.com のホスト型サービス用の薄いクライアントです。スコアリングモデルとファシリテーター識別ロジックはサーバー側にあります（非公開）。このパッケージはリクエストを転送して料金を支払うだけなので、オープンソースです。

クイックスタート — 5行で決済を判定

エージェントがあらゆる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の呼び出し1回で、不正なルーティング（通常支払うアドレスと異なるpayToへの差し替え）、プロンプトインジェクションによる決済（untrusted_textに現れたpayTo）、資金流出、過剰請求、制裁対象／違法な取引相手を検出します。

MCPフレームワーク（Claude、Cursorなど）では、代わりにサーバーを追加するだけで、エージェントは名前で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。ファシリテーターが送金を実行するため、購入者にガス代は不要）を介して、USDC で自動的に支払われます。無料ツールにキーは不要です。

使用方法

エージェントは支払いを承認する前に呼び出します：

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 を、エージェントのウォレットの支出上限に直接適用してください。支払い後、report_outcome({ assessment_id, outcome }) を呼び出すと、今後のスコアが改善されます。

免責事項

アルゴリズムによるリスクシグナルであり、情報提供のみを目的としています。いかなる当事者についても、助言、推奨、非難ではありません。スコアは、限られた公開オンチェーンデータとヒューリスティクスに基づく確率的な推定であり、誤分類する場合があります。ご自身でデューデリジェンスを行い、支払うか拒否するかを決める唯一の根拠として依存しないでください。https://402sentinel.com/terms をご覧ください。

MIT.