blackwall-x402-guardrail について
blackwall-x402-guardrailは、x402決済の署名前リスク判定を行うホステッド型リモートMCPサーバーです。GO、HOLD、STOPの判定とシグナルを返し、第三者が検証できる署名付きレシートも生成します。
主な機能
- 01GO、HOLD、STOPの判定
- 02取引相手の決済実績を確認
- 03受取側の中央値との差を検出
- 04OFAC制裁シグナルを確認
- 05Ed25519署名付きレシートの生成
活用シーン
- 01x402決済への署名前のリスク評価
- 02判定理由とシグナルの確認
- 03第三者による署名付きレシートの検証
MCP 対応
リモートMCPサーバーは、Streamable HTTP経由でforecast_paymentツールを提供し、リクエストをx402オラクルに転送します。オラクル障害時や有効な判定がない場合は、GOではなくエラーを返します。
設定
リモートサーバーはインストール不要です。クライアントを選んで設定をコピーするか、ワンクリックで導入できます。
https://mcp.blackwalltier.comclaude mcp add --transport http com-blackwalltier-blackwall-x402-guardrail https://mcp.blackwalltier.com{"mcpServers":{"com-blackwalltier-blackwall-x402-guardrail":{"type":"http","url":"https://mcp.blackwalltier.com"}}}Cursor で開く{"servers":{"com-blackwalltier-blackwall-x402-guardrail":{"type":"http","url":"https://mcp.blackwalltier.com"}}}VS Code で開く{"mcpServers":{"com-blackwalltier-blackwall-x402-guardrail":{"type":"http","url":"https://mcp.blackwalltier.com"}}}{"mcpServers":{"com-blackwalltier-blackwall-x402-guardrail":{"serverUrl":"https://mcp.blackwalltier.com"}}}コマンドはターミナルで実行し、JSON は各クライアントの MCP 設定に貼り付けて再起動します。認可が必要なサーバーは初回接続時にログインを求めます。
ツール
1| パラメーター | 型 | 必須 | 説明 |
|---|---|---|---|
| asset | string | はい | 例:USDC |
| chain | string | はい | e.g. base |
| payer | string | いいえ | Agent の EVM ウォレット(任意。決済を紐付けます) |
| amount | string | はい | 金額を 10 進数文字列で指定します(例:"0.09") |
| context | object | いいえ | {quoted_price_history, expected_recipient} |
| agent_id | string | いいえ | 呼び出し元の DID/ID |
| resource | string | いいえ | 支払い対象 |
| counterparty | string | はい | 402 の応答に含まれる受取人のウォレット |
詳細
Black_Wall リモート MCP
あらゆる MCP 対応エージェントに、署名前の支払いリスク判定を提供する、ホスト型のリモート MCP(HTTP 経由の Model Context Protocol)です。インストールも登録も不要です。URL を 1 つ追加するだけで、エージェントは x402 支払いに署名する前に、*「これは支払うべきですか?」*と確認し、取引相手の決済実績、価格の異常値(提示額と受取人自身の中央値との比較)、OFAC 制裁に基づくGO / HOLD / STOPの判定と、第三者が検証可能な Ed25519 署名付きレシートを取得できます。
追加方法
MCP クライアントの接続先を次の URL に設定します。
https://mcp.blackwalltier.com
トランスポート:Streamable HTTP。API キーは不要です。リスクにさらされる金額が 10 ドル未満の場合、判定は無料です。それ以上の場合、ツールは x402 支払いチャレンジを返します。エージェントは自身のウォレットで決済し、決済済みの支払いを X-PAYMENT ヘッダーとして渡してから再試行します。
ツール:forecast_payment
| フィールド | ||
|---|---|---|
counterparty | string、必須 | 402 から取得した受取人のウォレット |
amount | string、必須 | "0.09" のような小数文字列 |
asset | string、必須 | 例:USDC |
chain | string、必須 | 例:base |
payer / resource / agent_id / context | 任意 | 決済先/コンテキストをひも付けます |
判定(GO/HOLD/STOP)、理由、シグナル、および signed_receipt を返します。signed_receipt は、公開鍵
https://agent-egress-proxy.onrender.com/.well-known/blackwall-receipt-key.json
と照合して、誰でも検証できます(任意の RFC 8032 Ed25519 ライブラリを使用)。Black_Wall が処理に介在する必要はありません。
仕組み
この Worker は薄いトランスポート兼プロキシです。最小限の MCP JSON-RPC(initialize/tools/list/tools/call/ping)を処理し、forecast_payment の呼び出しを Black_Wall x402 オラクルに転送します。すべての判定ロジックとレシートは、オラクルから変更せずに引き継ぎます。
**フェイルクローズ設計:**オラクルでエラーが発生した場合、到達できない場合、または判定以外の応答が返された場合、ツールはエラーを返します。決して架空の GO を返しません。バックエンドに接続できない支払いガードレールが、「安全に支払える」と示唆してはなりません。
レジストリ
公式 MCP レジストリに com.blackwalltier/blackwall-x402-guardrail として公開されています。
開発
node test.mjs # unit tests (mocked oracle)
npx wrangler dev # run locally
npx wrangler deploy # deploy (Cloudflare Workers)
BlueTier 提供。返すのは判定のみです。資金を保管せず、決済処理にも関与しません。 証拠がないことは、信頼の証ではありません。
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。