vouch

Vouch

AI エージェント向けの、呼び出しごとに課金される決済信頼性・評判 API — x402 で収益化します。

自律型エージェントが販売者、API、または取引相手に支払う直前に、Vouch にまず尋ねる質問はひとつです。ここに支払っても安全ですか？ Vouch は説明可能な信頼スコアを返し、呼び出しごとに USDC で 1 セント未満を課金します。アカウントも API キーも Stripe も不要です。課金には x402 プロトコルそのものを使用します。

なぜ必要なのか

エージェント型コマースの決済基盤（Coinbase x402、AWS、Visa、Mastercard、Agnic）は、大手企業によって構築されています。一方、ガバナンス層、つまり*このエージェントは、この取引相手に資金を預けてもよいのか？*という問題は、自律的な支出を妨げる最大の要因として挙げられていますが、まだ手つかずです。Vouch は、そうした基盤の上に構築された、シンプルでセルフサービス型のツルハシです。

呼び出しのたびにプロダクトが改善されます。チェック結果やコミュニティからの報告が蓄積して評判データセットとなり、利用とともに価値が高まります。これは、ブートストラップで成長するチームが実際に築ける競争優位性です。

仕組み

agent ──POST /v1/check { target }──▶  x402 paywall (402 → pay USDC → retry)
                                          │
                                          ▼
                          ┌─────────── scoring engine ───────────┐
                          │ transport · domain heuristics ·       │
                          │ threat feed · reputation (D1)         │
                          └───────────────────────────────────────┘
                                          │
                            { score, risk, reasons[] }

スコアは、独立したシグナルの加重平均で算出します。また、安全性を優先するため、上書きルールも設けています。脅威フィードへの一致など、強い否定シグナルがひとつでもあれば、総合スコアに上限を設け、ひとつの重大な危険信号が平均化されて見えなくなるのを防ぎます。

シグナル	重み	ソース
threat_feed	3	URLhaus ホストリスト（THREAT_FEED_URL）、キャッシュ済み、取得失敗時も処理を継続
reputation	2	Vouch 独自の蓄積型 D1 データ（競争優位性）
transport	1.5	HTTPS ／有効なホスト
domain_heuristics	1	Punycode、IP アドレスの直接指定、悪用されやすい TLD など

エージェントから利用する

Vouch は本格的な MCP サーバーであり、x402 課金対応の HTTP API であり、小規模な SDK でもあります。スタックに合うものを選んでください。アカウントも API キーも必要ありません。

MCP（無料ツール、あらゆる MCP クライアントで利用可能）

クライアントから Streamable-HTTP エンドポイントに接続します。vouch_score と vouch_report を提供し、エージェントが取引相手への支払い前にチェックするよう、 モデル向けの instructions も備えています。

{
  "mcpServers": {
    "vouch": { "type": "streamable-http", "url": "https://vouch.futuronoti.workers.dev/mcp" }
  }
}

stdio のみを使用するクライアントの場合は、npx mcp-remote https://vouch.futuronoti.workers.dev/mcp でブリッジしてください。 Vouch は 公式 MCP レジストリにも io.github.notifuturo/vouch として登録されています。

無料の HTTP（curl）

curl -s https://vouch.futuronoti.workers.dev/v1/score \
  -H 'content-type: application/json' -d '{"target":"https://some-merchant.com"}'
# → {"target":"...","host":"some-merchant.com","score":91,"risk":"low"}

SDK で支払いを制御する（1 行）

import { assertTrusted } from "vouch-sdk";

await assertTrusted("https://some-merchant.com", { minScore: 75 }); // free; throws if risky
await payTheMerchant();

有料の POST /v1/check では、説明可能な reasons、重み付きの signals、および 署名済み Ed25519 アテステーションが追加されます（デューデリジェンスの証明として保管してください）。x402 の支払いと再試行の全体的な流れは examples/buyer.ts を、クライアントについては sdk/ を参照してください。

エンドポイント

メソッドとパス	料金	説明
POST /v1/check	x402（USDC）	詳細な判定 → { score, risk, reasons, signals, attestation }（Ed25519 署名付きレシート）
POST /v1/score	無料（レート制限あり）	スコアとリスクのみ → { score, risk }。理由を取得するには /v1/check を利用してください
GET /v1/attestation/pubkey	無料	/v1/check のアテステーションを検証するための Ed25519 公開鍵（JWK）
POST /v1/report	無料	ホストの flag または vouch を送信
GET /v1/stats	無料	評判の集計値（ホスト、チェック、フラグ、推薦）
POST /mcp	無料	MCP Streamable-HTTP サーバー（vouch_score、vouch_report ツール）
GET /health	無料	稼働状況
GET /	無料	サービス情報（ブラウザー向け HTML ランディングページ）

CORS はオープン（*）で、x402 の支払いヘッダーが公開されているため、ブラウザー上で動作するエージェントはプリフライトを実行し、支払いと再試行のフローを完了できます。

/v1/report を読む（不正利用モデル）

POST /v1/report は、設計上 無料かつ認証不要 です。誰でもホストに対して flag または vouch を送信できるため、生の flags／vouches 件数は コミュニティ シグナルであり、確定的な事実ではありません。不正利用は次の方法で抑制されます。

• レート制限 — クライアント IP ごとに 60 秒間で 10 件のレポート（Cloudflare Rate Limiting、障害時は拒否）。
• レポーターの実績に応じた重み付け — 集計対象となる各レポートの寄与は、固定の +1 ではなく、レポート元の利用期間に基づく 重み付き の値です。新規または匿名の送信元は 0.3 として数えられ、継続的なレポートが約 7 日間続いた後にのみ 1.0 になります。スコアリングシグナルにはこの重み付き合計が使われるため、新しい Sybil ID を大量に作成しても影響力は大幅に抑えられます。また、送信元ごとに、同一ホストのカウンターを動かせるのは 24 時間に 1 回までです（送信元単位で重複排除）。監査用として生の件数も記録されます。
• スコアリングにおけるポイズニング耐性 — コミュニティの reputation は 権威のない シグナルです。スコアを下げることはできますが、それだけで critical 判定を 強制することはできません。スコアに上限を設けられるのは、脅威フィードやトランスポートなどの客観的なシグナルだけです。そのため、匿名のフラグが急増しても、正当な取引相手を一方的に危険と判断することはできません。
• 入力の制限 — target／reason／reporter は保存前に文字数を制限します。

/v1/stats とレポート件数は、有料判定に反映されるクラウドソースの事前情報として扱い、権威あるブロックリストとしては扱わないでください。

技術スタック（運用コスト $0）

TypeScript · Hono · Cloudflare Workers（無料枠）· D1（無料の SQLite）· @x402/* v2 · 公開ファシリテーター（x402.org/facilitator）。

Base メインネットで稼働中（X402_NETWORK=base、実際の USDC、1 回あたり $0.01）。ローカル 開発では、X402_NETWORK=base-sepolia を設定し、無料の Circle faucet から使い捨てウォレットに資金を入れてください。稼働中のネットワークと価格は、/.well-known/x402 で正式に通知されます。

開発

npm install
npm run typecheck
npm test

cp .dev.vars.example .dev.vars   # set PAY_TO_ADDRESS (your testnet wallet)
wrangler d1 create vouch         # paste database_id into wrangler.toml
npm run db:init                  # apply schema locally
npm run dev                      # local Worker

ライセンス

MIT — LICENSE を参照してください。