Kaal Agent Safety (x402 paid MCP)

kaal-agent-safety — x402 有料 MCP サーバー

有料 MCP ツールが 2 つ、無料の HTTP エンドポイントが 3 つあります。購入者は Base 上の USDC で支払います（呼び出しごと、x402 exact スキーム、EIP-3009 transferWithAuthorization）。API キーもサブスクリプションも不要です。無料の initialize と tools/list は利用できます。支払いが必要なのは tools/call のみです（支払い要件を示す HTTP 402）。

エンドポイント

エンドポイント	メソッド	価格	備考
/v1/safety/check?target=<url>	GET	$0.002	決定論的な支払い安全性／フィッシングスキャン＋署名付きレシート
/v1/recommend?category=<cat>	GET	$0.005	プロバイダー／コストディレクトリのランキング検索
/mcp	POST (MCP)	下記参照	streamable-http MCP トランスポート
/.well-known/mcp.json	GET	無料	MCP ディスカバリーマニフェスト
/.well-known/x402	GET	無料	x402 支払いマニフェスト（payTo、ファシリテーター、価格）
/v1/verify?receipt=<id>	GET	無料	再利用可能なレシート検証
/health	GET	無料	稼働状態

MCP ツール

• safety_check(target) — 呼び出しごとに $0.002：credentials_in_url、 no_hsts、ip_literal、類似ホスト、/.well-known/x402 マニフェストの欠落を検出し、AVOID / CAUTION / CAUTION_NONE_DETECTED と署名付きレシートを返します。
• recommend(category) — 呼び出しごとに $0.005：検索、オンチェーンデータ、エージェント安全性、有料ディスカバリー、トランザクション実行にわたる、未開拓領域／コストのランキングディレクトリです。

接続

claude mcp add --transport http kaal-agent-safety https://<host>/mcp
# or any MCP client pointed at the streamable-http URL in server.json

無料：initialize、notifications/initialized、tools/list。 有料：tools/call には X-PAYMENT ヘッダー（base64 エンコードされた exact スキームのペイロード）が必要です。 サーバーは x402 ファシリテーターを通じて決済を実行し、オンチェーントランザクションを含む X-Payment-Response を返します。

実行

npm ci
RECEIPT_SECRET=<32-byte-hex> \
NETWORK=base FACILITATOR_URL=http://127.0.0.1:8142 \
PORT=8140 node server.js

RECEIPT_SECRET（または WALLET_FILE=<path-to-wallet-json>）でレシートに署名します。 NETWORK は base（メインネット）または base-sepolia です。決済は非カストディアルです。 決済のたびに、資金は設定済みの payTo ウォレットに直接送られます。

検証済み

• ローカル E2E：未払いの 402 → EIP-3009 署名済み支払い → 検証 → 決済 → オンチェーンのレシートステータス 1。
• トンネル経由のパブリック E2E：有料の GET /v1/safety/check を、次の tx で決済しました。 0xd7bd01780b75d106fb3e286b6a3c55a78a6a486ee2cf439f4d2b3d8b5b1c28d7 （Base メインネット、ブロック 53162843、ガス 83208）。
• 収益台帳＋財務資金のスイープ＋systemd による自動再起動は、本番デプロイの一部です。

ライセンス

MIT