x402-ads-mcp

@forgemeshlabs/x402-ads-mcp

ミドルウェアを1つインストールするだけで、未使用の402レスポンスをレコメンデーション、ディスカバリー、マシンコマース分析で収益化できます。

このネットワークのMCP側では、x402エコシステム全体で自律型エージェントが何を探り、何を求め、何を諦めるのかを、エージェント向けのツールとして提供します。

ForgeMesh x402 Ads & Intent Networkをラップしています。有料ツールは、x402プロトコルを介してBaseメインネット上で、呼び出しごとにUSDCで決済されます。アカウントもAPIキーも不要で、ウォレットがログイン手段になります。パブリッシャーは、自身のサービスに関するレポートを無料で利用できます。

インストール

{
  "mcpServers": {
    "intent": {
      "command": "npx",
      "args": ["-y", "@forgemeshlabs/x402-ads-mcp"],
      "env": {
        "WALLET_PRIVATE_KEY": "0x... (optional — enables paid analytics)",
        "X402_ADS_PUBLISHER_KEY": "pub_... (optional — free reports on your own services)"
      }
    }
  }
}

どちらの環境変数も任意です。どちらも設定しない場合、無料ツールはすべて利用でき、有料ツールは決済を行う代わりにx402の支払い要求（価格、ネットワーク、payTo）を返します。支出する前の確認に便利です。

ボーナス：1コマンドでパブリッシャー登録

このパッケージは、API運営者向けの登録CLIとしても使えます（MCPクライアントは不要です）。

# read the terms first: https://ads.forgemesh.io/terms
WALLET_PRIVATE_KEY=0xYOUR_WALLET npx -y @forgemeshlabs/x402-ads-mcp register \
  --url https://api.your-service.com --accept-terms

Base上で0.10 USDCを1回支払うと、支払いに使ったウォレットがIDになり、パブリッシャーキーが一度だけ表示されます。無効なリクエストは支払い前に拒否されるため、登録に失敗するリクエストに対して支払うことはありません。

ツール

ツール	価格	返される内容
get_network_counters	無料	ネットワークのリアルタイム集計：観測された402の数、エージェントクラスのリクエスト数、提供されたレコメンデーション数
preview_recommendations	無料	ミドルウェアが402に挿入するレコメンデーションブロックそのもの
get_terms	無料	正式な利用規約と、データ収集に関する完全な開示
get_network_stats	$0.005	ネットワークの集計と、モニター／インデクサー／エージェントの分類別内訳
get_intent_trends	$0.01	自律型エージェントがリクエストする上位のエンドポイントとカテゴリ
get_category_demand	$0.02	1つのカテゴリの需要の詳細：ボリューム、購入者の割合、価格帯
get_intent_report	$0.05 / 無料*	1つのサービスについて、エージェントが購入しなかった理由を示すファネル

* get_intent_reportは、イベントを提供するサービスについてX402_ADS_PUBLISHER_KEYがあれば無料です。これはデータ協同組合のルールです。自分のデータは、いつまでも無料で利用できます。

環境

変数	必須	用途
WALLET_PRIVATE_KEY	いいえ	USDCを保有するBaseメインネットのウォレット。有料ツールの自動決済を有効にします
X402_ADS_PUBLISHER_KEY	いいえ	ads.forgemesh.ioから取得したパブリッシャーキー。自身のレポートを無料で利用できます
X402_MAX_PRICE_USD	いいえ	呼び出しごとの価格上限（USD）。組み込み上限（$0.05、registerの場合は$0.10）より引き下げることのみ可能です
X402_SESSION_BUDGET_USD	いいえ	プロセスごとの累積上限。組み込み上限の$10より引き下げることのみ可能です

バックエンドURLはhttps://ads.forgemesh.ioに固定されています（パブリッシャーキーはこのURLにのみ送信されます）。サーバーは、ForgeMesh Adsウォレット以外の受取人、Baseメインネット以外のネットワーク、USDC以外の資産、または上限を超える金額への署名を拒否します。残高の少ない専用ウォレットを使用してください。キーがマシンの外に出ることはありません。支払いにはローカルで署名（EIP-3009）し、オンチェーンで決済します。

すぐに使える設定はexamples/にあります。Claude DesktopのmcpServersブロックと、コメント付きの環境変数テンプレートが含まれています。

テスト（安全性を設計段階から確保）

npm test                # smoke: MCP boots over stdio and lists its 7 tools
npm run test:free       # free tools against the live network
npm run test:challenge  # every paid tool returns an x402 challenge — no wallet, nothing can spend
npm run test:all        # all of the above

テストで支払いが決済されることはありません。チャレンジテストは読み込み前に支払い関連の環境変数を削除するため、シェルでウォレットを設定していても資金が動くことはありません。

このネットワークを一言で説明すると

APIのコンテンツではなく、マシンコマースを測定します。@forgemeshlabs/x402-adsミドルウェアを実行するパブリッシャーが、匿名化された402プローブのメタデータを提供します。このMCPは、集約された需要シグナルをエージェントやビルダーに販売します。

パブリッシャーが送信する情報と、送信しない情報の完全な開示：https://ads.forgemesh.io/terms

ライセンス

MIT © ForgeMesh