X402 Service Discovery

x402 サービスディスカバリー MCP サーバー

⭐ このページを広めるためにスターを付けてください — x402Scout で時間を節約できたなら、スターを付けると、ほかの開発者にも見つけてもらいやすくなります

x402 エージェント型経済の、コミュニティが構築した Bazaar — リアルタイムの品質シグナル、ファシリテーターとの互換性チェック、ERC-8004 の信頼スコアを備えた、成長を続ける稼働中サービスのカタログです。Coinbase 自身の PROJECT-IDEAS.md がコミュニティに構築を求めたディスカバリーレイヤーです。

---

ScoutGate — x402 API の即時マネタイズ

既存の API を 2 分以内に x402 決済対応にできます — プロトコルの知識は不要です

x402 エコシステムにおける最大の障壁は、供給側にありました。API を x402 決済に対応させるには、EIP-712 ヘッダー、ファシリテーターへの登録、決済処理ロジックを理解する必要がありました。ScoutGate はこれらをすべて不要にします。

# Register your existing API (30 seconds)
curl -X POST https://x402-scoutgate.onrender.com/register \  -H "Content-Type: application/json" \  -d '{"api_url": "https://your-api.com", "wallet_address": "0xYourWallet", "price_usd": 0.01, "name": "My API"}'
# Returns: {"proxy_url": "https://x402-scoutgate.onrender.com/api/abc123", "api_id": "abc123"}

これだけです。API は x402 対応となり、x402Scout に自動登録され、Base メインネット上で実際の USDC による決済が行われます。ScoutGate がファシリテーターとの連携、EIP-712 の検証、決済処理を担います。

手数料モデル： 取引ごとに 2%（最低 $0.002）。稼働中： https://x402-scoutgate.onrender.com | API を登録する

---

ターミナル CLI — x402scout

ターミナルから x402 サービスカタログ全体を検索できます

# Install (npm)
npm install -g x402scout

# Search
x402scout search "weather data"

# Top services by trust score
x402scout top 10

# Browse by category
x402scout browse data

# Scan a URL for x402 compliance
x402scout scan https://api.yourservice.com

# Ecosystem stats
x402scout stats

詳しい使い方は cli/README.md をご覧ください。

---

scout_relay — 自律型決済ルーター

x402 決済のルーティング、実行、監査を 1 回の呼び出しで実行します

Discovery MCP が呼び出す対象を見つける一方で、scout_relay は実際の呼び出しを担います。最適なサービスを見つけ、x402 決済を行い、失敗した場合は再試行して、結果を返します。たった 1 回の呼び出しで、すべて自律的に実行します。

# Route an intent to the best matching x402 service
curl -X POST https://x402-scout-relay.onrender.com/route \
  -H "Content-Type: application/json" \
  -H "X-Payment: <your-x402-payment-header>" \
  -d '{"intent": "blockchain analytics for wallet 0xABC", "max_budget_usd": 0.05}'

4 つの MCP ツール — 任意の MCP クライアントに追加できます：

ツール	機能
scout_route	インテントに最適なサービスを見つけて、決済を実行します
scout_discover	実行せずにディスカバリーカタログを検索します
scout_execute	既知のサービス URL に決済を実行します
scout_audit	支出ログとエージェントの予算状況を表示します

手数料モデル： ルーティングされた呼び出しごとに max($0.003, 2.5% of downstream transaction value)。

掲載入札： プロバイダーは POST /placement/bid でルーティング優先度の入札を登録できます（x402 によるゲート付き、登録料 $0.01）。入札は信頼スコアによるフィルタリング後のタイブレーカーとして使用されます。常に実績を優先します。

エンドポイント	説明
GET /health	サービスの健全性とバージョン
POST /route	インテントをルーティングします（x402 によるゲート付き）
POST /execute	既知の URL に実行します（x402 によるゲート付き）
GET /discover	カタログの検索（無料）
GET /audit	支出ログ（無料）
POST /placement/bid	プロバイダーの掲載入札を登録します（x402 によるゲート付き、$0.01）
GET /placement/bids	有効な掲載入札をすべて表示します（公開）

稼働中： https://x402-scout-relay.onrender.com

---

これは何か（30 秒でわかる説明）

x402 は、エージェント型ウェブ向けの Coinbase による HTTP ネイティブなマイクロペイメント標準です。AI エージェントがエンドポイントにアクセスすると、HTTP 402 チャレンジを受け取り、Base 上で USDC を支払い、データを受け取ります。API キーもサブスクリプションも不要で、機械同士のやり取りだけで完結します。

課題： エコシステムには x402 で決済できるサービスが何百と存在します。公式の x402.org カタログに掲載されているのは名前だけです。稼働状況のデータも、レイテンシースコアも、ファシリテーター互換性の情報も、信頼性の指標もありません。エージェントには、どのサービスが実際に稼働していて、信頼でき、決済フローと互換性があるのかを知る手段がありません。

この MCP サーバーがその課題を解決します。 Claude、Cursor、Windsurf の任意のエージェントを x402 Service Discovery API に直接接続できます。この API は、すべてのエントリーに実際の品質指標を備えた、継続的に更新されるカタログです。AI ワークフローの中から、サービスの検索、健全性の確認、ファシリテーター互換性の検証、新しいエンドポイントの登録をすべて実行できます。

---

MCP ツール（ディスカバリーツール 5 つ + リレーツール 4 つ = 合計 9 つ）

ディスカバリーツール

ツール	機能	料金
x402_discover	キーワード、カテゴリ、上限価格で稼働中のカタログをセマンティック検索します	$0.010 USDC (x402 経由で支払い)
x402_health	登録済みサービスの稼働状況とレイテンシーをリアルタイムで確認します	$0.001 USDC (x402 経由で支払い)
x402_register	新しい x402 サービスを登録します（HTTPS のみ、レート制限あり）	無料
x402_attest	サービスの ERC-8004 信頼スコアと評判指標を確認します	無料
x402_scan	x402 準拠状況を全件スキャンします。ライブ設定、信頼スコア、不一致の検出を含みます	$0.010 USDC (x402 経由で支払い)

リレーツール（scout_relay 経由）

ツール	機能	料金
scout_route	インテントに最適なサービスを見つけて、x402 決済を実行します	max($0.003, 2.5%)
scout_discover	実行せずにディスカバリーカタログを検索します	無料
scout_execute	既知のサービス URL に x402 決済を実行します	max($0.003, 2.5%)
scout_audit	エージェントの支出ログと予算状況を表示します	無料

---

クイックスタート — 30 秒でディスカバリーを開始

オプション A：Docker（推奨）

claude_desktop_config.json、Cursor の MCP 設定、または Windsurf の設定に追加します：

{
  "mcpServers": {
    "x402-discovery": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "ghcr.io/rplryan/x402-discovery-mcp:latest"]
    }
  }
}

オプション B：npx（Docker 不要）

{
  "mcpServers": {
    "x402-discovery": {
      "command": "npx",
      "args": ["-y", "@rplryan/x402-discovery-mcp"]
    }
  }
}

オプション C：直接 API を利用

Discovery API は認証なしで公開アクセスできます：

# Search for services
curl "https://x402scout.com/discover?query=blockchain+analytics&max_price_usd=0.01"

# Full catalog
curl "https://x402scout.com/.well-known/x402-discovery"

---

これが重要な理由

x402における発見のギャップ

x402プロトコルが解決するのは 決済 です。発見 は解決しません。何百ものサービスが存在していても、エージェントがそれらを見つけ、評価し、適切にルーティングできなければ、プロトコルの価値を十分に活用できません。

このプロジェクトは、次の3つのレイヤーでそのギャップを埋めます。

1. 発見 — 機能、カテゴリ、価格上限でx402サービスを検索
2. 品質シグナル — 稼働率（%）、レイテンシ（ms）、ファシリテーターとの互換性、ERC-8004の信頼スコア
3. 実行 — scout_relayが自律的にサービスを発見し、支払い、再試行して、結果を返します

x402.org/ecosystemとの違い

機能	x402.org/ecosystem	このプロジェクト
サービス一覧	✅ 名前＋URL	✅ 完全なメタデータ
稼働状況の監視	❌ なし	✅ ライブヘルスチェック
レイテンシデータ	❌ なし	✅ サービスごとのmsスコア
ファシリテーターとの互換性	❌ なし	✅ サービスごとのフラグ
ERC-8004の信頼シグナル	❌ なし	✅ 評判スコアリング
エージェント向けの使い方プロンプト	❌ なし	✅ サービスごとのllm_usage_prompt
自動更新カタログ	❌ 手動	✅ 6時間ごとにスキャン
MCP連携	❌ なし	✅ 9個のツール、レジストリに公開済み
セマンティック検索	❌ なし	✅ キーワード＋カテゴリ＋価格
自律実行	❌ なし	✅ scout_relay — 発見＋支払い＋再試行
エージェント連携のヒント	❌ なし	✅ サービスごとのhowToUseブロック — x402での正確な支払い手順

---

ライブカタログの統計

Total Services:      Live — check https://x402scout.com/catalog
Auto-scan interval:  6 hours
Scan sources:        x402.org/ecosystem, awesome-x402, GitHub search
Categories:          data, compute, agent, utility
Facilitator-compat:  Flagged per service
Trust signals:       ERC-8004 per service
Primary URL:         https://x402scout.com
Trust scores:        0-100 per service (ERC-8004 based)
Payment metadata:    x402Config (address, asset, version) per service
Router:              Live at https://x402-scout-relay.onrender.com

カタログのサンプル

カテゴリ	件数	主なサービス
data	ライブ	CoinGecko、Einstein AI、DJD Agent Score、Ordiscan、Nansen、Zapper、AdEx AURA
utility	ライブ	dTelecom STT、Pinata、Tip.MD、Cybercentry、Trusta Attestation、AsterPay
compute	ライブ	BlockRun.AI、X402Engine、AurraCloud、AiMo、QuickSilver
agent	ライブ	Questflow、Ubounty、Bitte Protocol、Farnsworth、SerenaI

---

例：エージェントのワークフロー

発見のみ

# 1. Agent needs blockchain analytics under $0.01
result = x402_discover(
    query="blockchain analytics whale tracking",
    max_price_usd=0.01,
    category="data"
)
# Returns: ranked list with price, uptime %, latency, llm_usage_prompt

# 2. Scan for compliance + trust before paying
scan = x402_scan(url=result[0]["url"])

# 3. Check live health before committing
health = x402_health(url=result[0]["url"])

scout_relayによる完全な自律実行

# One call — discovery + payment + retry handled automatically
result = scout_route(
    intent="blockchain analytics for wallet 0xABC",
    max_budget_usd=0.05
)
# Returns: {result: {...}, provider: "...", fee_usd: 0.003, trust_score: 82}

支払いには、x402 HTTPプロトコル経由の**EIP-712署名付きTransferWithAuthorization**を使用します。直接のERC-20送金ではありません。署名はサーバー側で検証され、オンチェーン決済にはreceiveWithAuthorizationを使用します。

---

CDP Builder Grantの背景

このプロジェクトは、Coinbaseが公開しているロードマップの2項目を直接実装したものです。

coinbase/x402のPROJECT-IDEAS.mdより：

「Dynamic Endpoint Shopper — MCPレジストリを発見し、アクセス料金を支払い、複数のサービスから結果を連鎖させるエージェント」

CDP x402ファシリテーターのロードマップより：

「購入者（人間とエージェント）が利用可能なサービスを見つけるための発見レイヤー（Bazaar）」

私たちはコミュニティのBazaarを構築しました。すでに稼働しています。公式ページにはない品質シグナルも備えています。さらに、x402決済自体を利用しています。x402_discoverの料金は0.010 USDCで、サービス提供に使っているプロトコル経由で支払われます。scout_relayはこれをさらに発展させ、x402決済を自律的にルーティングして実行し、サービス料金として独自のx402手数料を請求します。

提供済みの機能（11日間）

提供物	ステータス
x402 Service Discovery API v3.7.0	✅ Render で稼働中
x402 Discovery MCP Server	✅ Docker + GitHub MCP Registry
x402 RouteNet v1.0.0（スマートルーティング）	✅ Render で稼働中
x402 Payment Harness v1.0.0（EOA テスト）	✅ PyPI pip install x402-payment-harness
品質シグナル付きで継続的に拡大するカタログ	✅ 6時間ごとに自動更新
ERC-8004 信頼レイヤー	✅ サービスごとの信頼スコアリング
Facilitator 互換性レイヤー	✅ 支払い前の互換性チェック
Base 上で完全な HTTP 402 プロトコルフローを実証	✅ EIP-712 署名 → X-PAYMENT ヘッダー → 200
x402scout CLI v1.0.0	✅ npm install -g x402scout
scout_relay v2.1.0（支払いルーター）	✅ Render で稼働中
プロバイダーの掲載入札（POST /placement/bid）	✅ 稼働中 — x402 によるゲート制御、セルフサービス
カタログ内の x402Config 支払いメタデータ	✅ サービスごとの payment_address、asset_contract、x402Version
/scan コンプライアンスエンドポイント（有料）	✅ 稼働中 — コンプライアンス評価、ミスマッチ検出、信頼スコア
howToUse 統合ブロック	✅ /discover の結果にサービスごとの正確な x402 支払い手順
ランディングページ（x402scout.com）	✅ NVG グリーンのデザイン、リアルタイム統計、コードスニペット
エンドポイントのセキュリティ強化	✅ SSRF ガード、レート制限、/register で HTTPS のみ許可
Smithery スコア	✅ 100/100
GitHub MCP Registry	✅ 公開済み：io.github.rplryan/x402-discovery-mcp
ScoutGate v1.0.0（x402 API マネタイズゲートウェイ）	✅ Render で稼働中 — あらゆる API を30秒で x402 決済対応に変換

---

アーキテクチャ

┌─────────────────────────────────────────────────────┐
│              AI Agent (Claude / Cursor / Windsurf)  │
│                                                     │
│  x402_discover → x402_health → x402_attest         │
│  x402_scan → x402_register → x402_health           │
│                                                     │
│  scout_route → scout_execute → scout_audit          │
└──────────┬──────────────────────────┬───────────────┘
           │ MCP (stdio/Docker)       │ REST / MCP
┌──────────▼──────────┐    ┌──────────▼──────────────┐
│  x402 Discovery     │    │  scout_relay v2.1.0      │
│  MCP Server         │    │  x402-scout-relay        │
│  ghcr.io/rplryan/   │    │  .onrender.com           │
│  x402-discovery-mcp │    │  Fee: max($0.003, 2.5%)  │
└──────────┬──────────┘    └──────────┬───────────────┘
           │ HTTPS                    │ HTTPS
           └──────────────┬───────────┘
                          │
┌─────────────────────────▼───────────────────────────┐
│     x402 Discovery API (Render, v3.7.0)             │
│     https://x402scout.com                          │
│                                                     │
│  • Growing catalog  • Auto-scan every 6h            │
│  • Health checks  • Facilitator compat flags        │
│  • ERC-8004 trust • llm_usage_prompt per service    │
└─────────────────────────────────────────────────────┘

---

関連プロジェクト

プロジェクト	説明	ステータス
x402 Discovery API	この MCP サーバーを支える REST バックエンド	v3.7.0 で稼働中
scout_relay	自律型 x402 支払いルーター — 検出 + 実行 + 監査を1回の呼び出しで実行	v2.1.0 で稼働中
x402 RouteNet	検出済みサービス間のスマートルーティング	v1.0.0 で稼働中
x402 Payment Harness	x402 支払いテスト用の EOA ベース Python ライブラリ + CLI	PyPI v1.0.0
ScoutGate	既存のあらゆる API を30秒で x402 決済対応に変換 — プロトコルの知識は不要	v1.0.0 で稼働中

---

サービスを登録する

x402 対応サービスを開発している場合は、カタログに追加してください。

curl -X POST https://x402scout.com/register \
  -H "Content-Type: application/json" \
  -d '{
    "name": "My Service",
    "url": "https://myservice.example.com/api",
    "price_usd": 0.010,
    "category": "data",
    "description": "What your service does",
    "network": "base-mainnet"
  }'

または、Claude/Cursor/Windsurf 内から x402_register MCP ツールを使用してください。

ルーティングの優先度を上げたいですか？ POST https://x402-scout-relay.onrender.com/placement/bid に掲載入札を登録してください（x402 によるゲート制御、登録料 $0.01）。信頼スコアによるフィルタリング後の同点判定に、サービスの重みが加算されます — 常に実績が最優先です。

---

ライセンス

MIT

---

Coinbase x402 protocol 上に構築 | Base Network | ERC-8004 | Model Context Protocol