X402 Ads MCP

Name: X402 Ads MCP
Author: forgemeshlabs

作者：forgemeshlabsバージョン 0.2.6i★ –iパソコンで動く

レジストリ名io.github.forgemeshlabs/x402-ads-mcp

インストール

概要

作者による説明（英語の原文）

x402 ad recommendations, intent analytics, and machine-commerce demand reports.

PopNx MCPの3つの柱

この3つを1つのスコアにまとめることはしません。意見、測定、人気はそれぞれ別のものだからです。

利用者の声iレビューはまだありませんレビューは今後のステップで、アカウント機能と一緒に始まります
私たちの基本チェックi1項目中1項目に合格公開情報からチェック。コードはまだスキャンしていません
利用状況i初期↓ 349/週 · ★ –

できること

このサーバーのやさしい解説はまだ書いていません。以下はレジストリから読み取った事実です。

接続方法: パソコンで動く
トランスポート: stdio
カテゴリ: マーケティング・SNS
入力が必要なもの：WALLET_PRIVATE_KEY, X402_ADS_PUBLISHER_KEY

インストール

使っているAIアプリを選んで、設定をコピーしてください。

インストールの前に

基本チェック：1項目中1項目に合格
あなたのパソコンで、あなたのユーザーと同じ権限（ファイル、ネットワーク、アプリ）で動きます。
自分で入力するもの： WALLET_PRIVATE_KEY, X402_ADS_PUBLISHER_KEY

「秘密」と表示された値は、あなたのアカウントの鍵です。絶対に人に教えたり、チャットに貼り付けたりしないでください。

必要なもの

npmNode.jsのインストール（npxコマンドに必要）

どのアプリを使っていますか？

ClaudeClaude CodeCursorVS CodeChatGPT

上でアプリを選んでください。選んだアプリを覚えておくので、次からはボタンに「…にインストール」と表示されます。

Claude Desktop → Settings → Developer → Edit Config を開き、claude_desktop_config.json にこれを貼り付けます

{
  "mcpServers": {
    "x402-ads": {
      "command": "npx",
      "args": [
        "-y",
        "@forgemeshlabs/x402-ads-mcp"
      ],
      "env": {
        "WALLET_PRIVATE_KEY": "your-value",
        "X402_ADS_PUBLISHER_KEY": "your-value"
      }
    }
  }
}

ターミナルでこれを実行します

claude mcp add x402-ads --env WALLET_PRIVATE_KEY=your-value --env X402_ADS_PUBLISHER_KEY=your-value -- npx -y @forgemeshlabs/x402-ads-mcp

動かす前に、空欄の値を入力してください。

Cursorで開く

または、設定を自分でコピーする

プロジェクトの .cursor/mcp.json、または ~/.cursor/mcp.json に貼り付けます

{
  "mcpServers": {
    "x402-ads": {
      "command": "npx",
      "args": [
        "-y",
        "@forgemeshlabs/x402-ads-mcp"
      ],
      "env": {
        "WALLET_PRIVATE_KEY": "your-value",
        "X402_ADS_PUBLISHER_KEY": "your-value"
      }
    }
  }
}

ブラウザがアプリを開いてよいか確認し、そのあとアプリが設定を表示して確認を求めます。キーの値は空欄のままなので、自分で入力してください。

VS Codeで開く

または、設定を自分でコピーする

プロジェクトの .vscode/mcp.json に貼り付けます

{
  "servers": {
    "x402-ads": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@forgemeshlabs/x402-ads-mcp"
      ],
      "env": {
        "WALLET_PRIVATE_KEY": "your-value",
        "X402_ADS_PUBLISHER_KEY": "your-value"
      }
    }
  }
}

これはパソコンで動くサーバーですが、ChatGPTがつなげるのはインターネット上のサーバーだけです。ほかのアプリを選んでください。

選んだアプリは、この端末のCookieに保存されます。アカウントは不要です。

自分で入力する値

WALLET_PRIVATE_KEY 秘密 env
Optional dedicated low-balance Base wallet private key for settling paid x402 analytics calls. Without it, paid tools return the x402 payment challenge instead of settling.
X402_ADS_PUBLISHER_KEY 秘密 env
Optional publisher key from ads.forgemesh.io. Makes get_intent_report free for your registered services.

この設定は、作者のレジストリ登録情報から作成しています。READMEと違う場合は、READMEに従ってください。

できること

パソコンで動くサーバーです。インストールすると、ツール一覧がAIアプリに表示されます。

基本チェックi

誰でも見られる情報をチェックしており、コードは読んでいません。当てはまらない項目は数に入れていません。 · 2026年11月8日にチェック

✓ 合格
作者とリポジトリが一致
レジストリ名は、リポジトリを所有するGitHubアカウント forgemeshlabs で確認済みです
… 未チェック
今もメンテナンスされている
このリポジトリはまだGitHubから読み取っていません
… 未チェック
ライセンスがある
このリポジトリはまだGitHubから読み取っていません
– 対象外
エンドポイントが応答する
これはパソコンで動くため、インターネット上のエンドポイントはありません
– 対象外
OAuthでサインイン
パソコンで動き、代わりにローカルの設定を使います
… 未チェック
ツールの説明に隠れた指示がない
パソコンで動くサーバーです。ツール一覧を読み取れるのは、インターネット上のエンドポイントがある場合だけです

マーケティング・SNSのほかのサーバーとの比較i

このカテゴリのほかの3610件のうち0%よりスターが多い
このカテゴリのほかの3610件のうち81%より最近レジストリに公開
基本チェックの結果が、このカテゴリのほかの3610件のうち100%と同じかそれ以上

レジストリでこのカテゴリにある有効なすべてのサーバーと比較しています。スターは、公開者がリポジトリの所有者である場合だけ数えます。

よくある質問

X402 Ads MCPは安全ですか？

当てはまる基本チェック1項目のうち1項目に合格しました。コードは読んでいません。キーやトークンを追加する前に、サーバーがどんなアクセスを求めているかを確認し、必要な権限だけを持つキーを使ってください。

どんなキーやコードが必要ですか？

入力が必要なもの：WALLET_PRIVATE_KEY, X402_ADS_PUBLISHER_KEY

パソコンで動きますか、それともクラウドですか？

あなたのパソコンで動きます。必要なときにAIアプリが起動し、データは作者のサーバーを通りません（サーバー自体がオンラインサービスを呼び出す場合を除きます）。

今もメンテナンスされていますか？

GitHubリポジトリの最終更新は–、最新バージョン（0.2.6）がレジストリに届いたのは7 日前です。

どのアプリで使えますか？

Claude Desktop、Claude Code、Cursor、VS CodeなどのMCP対応アプリで使えます。パソコンにNode.jsも必要です。

代わりに使えるものは？

同じカテゴリには：MCP YouTube Transcript, Google Analytics MCP, BibiGPT YouTube Video Summarizer

代わりの候補

同じカテゴリで、ほかの作者が作ったサーバー。スターの多い順。

カードの見方：↓ 週あたりのダウンロードi★ GitHubスターi3つの柱：レビュー · チェック · 利用状況i更新＝最新バージョンをレジストリに公開した日i

MCP YouTube Transcript

An MCP server retrieving transcripts of YouTube videos

作者：jkawamoto成長中★ 49511 日前更新

パソコンで動く

インストール

Google Analytics MCP

GA4 MCP server for AI agents: schema discovery, server-side aggregation, analysis-ready defaults.

作者：surendranb成長中↓ 1088/週★ 24411 日前更新

パソコンで動く

インストール

BibiGPT YouTube Video Summarizer

AI video summarizer: summarize and transcribe YouTube, Bilibili, TikTok and podcast videos.

作者：JimmyLv成長中★ 13712 日前更新

クラウドで動く✓ bibigpt.co

インストール

作者のREADME

READMEを開く

作者のリポジトリから書かれたとおりにコピーしたものです。PopNx MCPは内容を確認・推奨していません。HTML、画像、スクリプトは取り除いています。リンクはこのサイトの外へ移動します。

@forgemeshlabs/x402-ads-mcp

Install one middleware. Monetize unused 402 responses with recommendations, discovery, and machine commerce analytics.

This is the MCP side of that network: what autonomous agents probe, want, and abandon across the x402 ecosystem — as tools for your agent.

Wraps the ForgeMesh x402 Ads & Intent Network. Paid tools settle per call in USDC on Base mainnet over the x402 protocol — no account, no API key; your wallet is the login. Publishers get reports on their own services free.

Install

"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)" } } } }

Both env vars are optional. With neither set, free tools work fully and paid tools return the x402 payment challenge (price, network, payTo) instead of settling — useful for inspection before spending anything.

Bonus: one-command publisher registration

This package doubles as the signup CLI for API operators (no MCP client needed):

# 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

One $0.10 USDC payment on Base; the paying wallet becomes your identity and your publisher key is printed once. Invalid requests are rejected before payment — you can't pay for a doomed registration.

Tools

Tool	Price	What it returns
`get_network_counters`	free	Live network totals: 402s observed, agent-class requests, recommendations served
`preview_recommendations`	free	The exact recommendations block the middleware injects into a 402
`get_terms`	free	Canonical terms + complete data-collection disclosure
`get_network_stats`	$0.005	Network totals + monitor/indexer/agent classification split
`get_intent_trends`	$0.01	Top endpoints & categories autonomous agents request
`get_category_demand`	$0.02	Demand depth for one category: volume, buyer share, price points
`get_intent_report`	$0.05 / free*	Why-agents-didn't-buy funnel for one service

\* get_intent_report is free with X402_ADS_PUBLISHER_KEY for services you contribute events to — the data co-op rule: your own data is free, forever.

Environment

Variable	Required	Purpose
`WALLET_PRIVATE_KEY`	no	Base mainnet wallet holding USDC; enables automatic settlement of paid tools
`X402_ADS_PUBLISHER_KEY`	no	Publisher key from ads.forgemesh.io; free lane for your own reports
`X402_MAX_PRICE_USD`	no	Per-call price cap in USD; can only LOWER the built-in cap ($0.05, or $0.10 for `register`)
`X402_SESSION_BUDGET_USD`	no	Cumulative cap per process; can only LOWER the built-in $10

The backend URL is fixed to https://ads.forgemesh.io (the publisher key is only ever sent there). The server refuses to sign for any payee other than the ForgeMesh Ads wallet, any network other than Base mainnet, any asset other than USDC, or any amount over the cap. Use a dedicated, low-balance wallet. The key never leaves your machine — payments are signed locally (EIP-3009) and settle on-chain.

Ready-made configs live in examples/: a Claude Desktop mcpServers block and a commented env-var template.

Testing (safe by construction)

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

No test settles a payment. The challenge test deletes the payment env vars before loading, so it cannot move funds even if your shell has a wallet configured.

The network in one sentence

We measure machine commerce, not API content — publishers running the @forgemeshlabs/x402-ads middleware contribute anonymized 402 probe metadata; this MCP sells the aggregate demand signal back to agents and builders.

Full disclosure of what publishers send (and never send): https://ads.forgemesh.io/terms

X402 Ads MCP

概要

PopNx MCPの3つの柱

できること

インストール

インストールの前に

自分で入力する値

できること

基本チェックi

作者とリポジトリが一致

今もメンテナンスされている

ライセンスがある

エンドポイントが応答する

OAuthでサインイン

ツールの説明に隠れた指示がない

マーケティング・SNSのほかのサーバーとの比較i

よくある質問

代わりの候補

MCP YouTube Transcript

Google Analytics MCP

BibiGPT YouTube Video Summarizer

作者のREADME

@forgemeshlabs/x402-ads-mcp

Install

Bonus: one-command publisher registration

Tools

Environment

Testing (safe by construction)

The network in one sentence

License