Payperbyte

PayPerByte MCP サーバー

Smithery の掲載ページ ·

Model Context Protocol サーバーです。AI エージェントが PayPerByte に直接アクセスできます。PayPerByte は、暗号学的に証明され、プロベナンスを検証可能な AI エージェント向けデータフィードを提供します（X-BYTE-Attestation レシートは配信の完全性を証明します。これは、PayPerByte が BYTE Library ドメインの下で配信し、証明したそのままのバイト列であることを示すものであり、独立したデータ発行者が署名したことや、データが正確であることを示すものではありません）。エージェントはフィードを検出し、x402 経由で呼び出しごとに支払う（Base メインネット上の USDC で決済）か、オンチェーンストリームを購読できます（Arbitrum Sepolia テストネット）。x402 の有料レスポンスにはすべて EIP-712 PayloadAttestation レシート（X-BYTE-Attestation ヘッダー）が含まれ、エージェントは動作する前にこれを検証します。トークンも API キーもオフチェーンアカウントも不要です。

2 つの決済経路 — PRIVATE_KEY を設定する前にお読みください。

• x402 の呼び出しごとの支払い（byte_buy_data）：Base メインネット（eip155:8453）、実際の USDC。 有料フィードでは実際のお金が決済されます。各価格は 402 チャレンジに記載され、フィードごとの価格は https://x402.payperbyte.io/feeds に掲載されています。例：Merchant Screen Oracle は、エージェントが x402 決済を行う前に実行できるよう、販売者のドメインと出金先アドレスに対する署名付き ALLOW/WARN/BLOCK チェックを返します。このチェックは、レスポンスの正確なバイト列に対する署名付き EIP-712 証明に基づいています。これは真正性と配信の完全性を示すものであり、判定自体の正確性を保証するものではありません。また、入力したドメイン、アドレス、価格についても同様です。最終的に決済するアドレスを監視したり、制限したりするものではありません。支出しても差し支えない金額だけを保有する専用ウォレットを使用してください。
• オンチェーンの購読／公開／クエリレイヤー（BYTE Library コントラクト＋インデクサー）：Arbitrum Sepolia テストネット（チェーン 421614）、MockUSDC。 このレイヤーのメインネット対応は、外部セキュリティ監査が完了するまで保留されています。EIP-712 証明の署名ドメインは、どちらの決済経路で支払ったかにかかわらず 421614 に固定されています。

1 つの PRIVATE_KEY で両方の決済経路を利用できます。失ってもよい金額を超える資金を保有するキーは絶対に再利用しないでください。

クイックスタート

npx -y byte-mcp-server

MCP クライアント（下記の Claude Desktop 設定）に接続すると、エージェントは次のことができます。

• フィードを検出する：「PayPerByte のカタログを一覧表示して」／「天気の発行者を検索して」
• 支払い前に取引相手を審査する（x402、設定不要）：「決済前にこのドメインと出金先アドレスを審査して」→ Base メインネット上の実際の USDC を 402 チャレンジに記載された価格で支払い、Merchant Screen Oracle から署名付き ALLOW/WARN/BLOCK 判定と証明レシートを取得
• まずは少額で試す：「天気を取得して」／「今日は M4 を超える地震があった？」→ 各フィードの掲載価格（https://x402.payperbyte.io/feeds）で実際の USDC を支払い、すべてのレスポンスで同じ証明レシートを取得します。判定に費やす前に、検証してから動作する仕組みを低コストで試せます
• ストリームを購読する（テストネット）：「地震フィードを購読して」→ Arbitrum Sepolia 上の継続的な決済に向けて MockUSDC を自動承認
• ファクトオラクルにクエリする（テストネット）：登録済みファクトオラクル発行者に署名付き EIP-712 質問を投稿し、引用付きのオンチェーン署名済み回答を取得します。これはファクトオラクル発行者が稼働している場合に限ります（現在はブロードキャストしている発行者はいません。発行者が登録してブロードキャストするまで、ツールはタイムアウトします）。

稼働中のカタログは x402.payperbyte.io/feeds にあります。天気、市場、コード、セキュリティ、ナレッジを扱う、暗号学的に証明され、プロベナンスを検証可能なフィードです。

実行前に検証する（ForeSeal）

インストール、登録、ウォレットなしで、実行前に検証する一連の流れを1つのコマンドで確認できます。

npx @foreseal/demo

ローカルで実行され（実際のUSDCは使用しません）、正規のバイト列に対してエージェントが実行し、4つの攻撃（改ざんされたバイト、偽造された署名、レシートの欠落、分岐した署名ドメイン）を拒否する様子を、約1秒で確認できます。

同じプリミティブは、独自のスタックに組み込める2つのパッケージとして提供されています。

• Kit — @payperbyte/sdk：購入者は実行前にレシートを検証します。
• Gate — @foreseal/gate：販売者は、任意のx402エンドポイントに検証可能なレシートを付与します。

2つの方式：サブスクライブと購入

モード	ツール	レール	最適な用途	料金
購入（x402）	byte_buy_data	Base mainnet — 実際のUSDC	単発のニーズ（単一のスナップショット、または今回のユーザークエリに対する判定）	フィードごと。402チャレンジで提示されます。価格付きの最新リスト：https://x402.payperbyte.io/feeds
サブスクライブ	byte_subscribe	Arbitrum Sepolia — テストネットのMockUSDC	継続的なストリーム（天気の更新ごと、地震の発生ごと）	パブリッシャーごと。パブリッシャーのオンチェーンスキーマで設定されています。byte_get_publisherで確認できます

購入は設定不要の従量課金制で、実際の決済を利用できます。サブスクライブでは、監査ゲート付きのテストネットレイヤーで、ブロードキャストをすべて受信できます。アクセスパターンに応じて選択してください。

判定の購入（POSTオラクル）

GETデータフィードに必要なのはfeedだけです。methodにPOSTが含まれるフィード（最新リスト：https://x402.payperbyte.io/feeds）では、クエリを`body`として渡します。`byte_buy_data`は呼び出しをGETからPOSTに自動で切り替えます。署名付きのALLOW/WARN/BLOCKを返す**判定オラクル**は、`merchant-screen`、`address-reputation`、`sanctions-screen`、`pkg-verdict`、`reasoning-verdict`です。

// byte_buy_data tool call — screen a merchant/counterparty before settling
{
  "feed": "merchant-screen",
  "body": { "domain": "example.com", "address": "0x1234…abcd", "observed_price_atomic": "<atomic price the MERCHANT you are screening quoted you>" }
}

有料レスポンスは、署名付き判定とX-BYTE-Attestationレシートを使ったインラインの実行前検証結果を返します。

{
  "feed": "merchant-screen",
  "paid": true,
  "price": "$0.100000",   // illustrative — the amount the 402 challenge quoted at buy time
  "txHash": "0x…",
  "data": { "answer": { "verdict": "ALLOW", "reasons": ["…"] }, "attestation": { "…": "…" } },
  "verification": { "gatewayVerified": true, "hashMatch": true, "signerMatch": true,
                    "reason": "gateway delivery verified — these exact bytes were signed by the pinned gateway attester […receipt deadline note appended]" }
}

verification.gatewayVerified === trueの場合にのみ実行してください。レシートが証明するのは、ゲートウェイがこれらのバイト列をそのまま配信したことです。データが正しいことを証明するものではありません。その他のPOST本文：address-reputation {domain,address}、sanctions-screen {address|name}、pkg-verdict {ecosystem,package[,version]}、reasoning-verdict {subject}。GETデータフィード（天気、地震など）では、bodyを省略してください。

ツール（全15件）

検出（読み取り専用、ウォレット不要）

ツール	説明
byte_search_publishers	トピックと並べ替え順でパブリッシャーを検索します
byte_list_feeds	有効なフィードカタログを、料金と配信頻度とともに一覧表示します
byte_get_publisher	1つのパブリッシャーのオンチェーン情報（ステータス、サブスクライバー数、メッセージ数、USDC収益、スキーマ）を取得します
byte_get_network_stats	ネットワーク全体の統計情報：パブリッシャー数、メッセージ数、決済済み手数料の合計
byte_check_subscription	subscriberはpublisherをサブスクライブしていますか？
byte_list_my_subscriptions	ウォレットの有効なサブスクリプションをすべて表示します。直近7日間／30日間のメッセージ数とUSDC支出も確認できます
byte_subscription_health	パブリッシャーのコンテンツドリフトのシグナル：stable / moderate / significant / unknown
byte_get_token_balances	Arbitrum Sepolia上のUSDCおよびETH残高
byte_verify_payload	実行前に検証します。 エージェントが受信したバイト列のkeccak256を再計算し、パブリッシャーのオンチェーンEIP-712 PayloadAttestationと照合します。保持しているexpectedHashまたは決済のtxHashをアンカーとして使用します（これにより署名者も復元され、指定されたパブリッシャーであることも確認できます）。verified: falseの場合、データに基づいて処理しないでください。アテステーションされた内容とバイト列が異なるか、検証できなかったことを示します（アテステーションが見つからない、署名者が一致しない、またはexpectedHashもtxHashも指定されていない）。該当する理由はreasonフィールドに記載されます

ストリームを購読する（PRIVATE_KEY が必要です）

ツール	説明
byte_subscribe	パブリッシャーのストリームを購読します。skipAllowance: true を指定しない限り、USDC の approve(max) を自動でまとめて実行します（コントラクトの allowance スキップ経路が amount=0 でデータを配信してしまう、気づきにくい支払い失敗の落とし穴を解消します）
byte_unsubscribe	購読を解除します。次のブロックから有効になります
byte_register_publisher	データパブリッシャーとして登録します（スキーマとオンチェーン登録）。v1 はファーストパーティのみです。ステークは 0 です
byte_publish_data	DataStream 経由でサブスクライバーにペイロードを公開します（手数料は USDC で精算されます）。r2 については上記の移行に関するお知らせをご覧ください

オンデマンドで購入する（PRIVATE_KEY が必要です）

ツール	説明
byte_buy_data	x402 ゲートウェイ経由で任意のフィードから 1 つのパケットを購入します。Base メインネット上の実際の USDC を使用します。購読も allowance も不要です。402 チャレンジに対して EIP-3009 transferWithAuthorization に署名し、ファシリテーターがオンチェーンで精算します。データとトランザクションハッシュをインラインで返します
byte_query_fact	スラッシュ可能な事実オラクルのパブリッシャーに質問します。EIP-712 署名付きリクエストにより、クエリをウォレットに紐付けます（漏えいしたクエリによってエスクローが消費されるのを防ぎます）。回答は引用とともに、オンチェーンであなたのアドレスにブロードキャストされます。稼働中の事実オラクルパブリッシャーが必要です。現在ブロードキャストしているパブリッシャーはいないため、登録されるまでは呼び出しがタイムアウトします。

設定

Claude Desktop

~/.config/claude/claude_desktop_config.json（Linux）または ~/Library/Application Support/Claude/claude_desktop_config.json（macOS）を編集します。

{
  "mcpServers": {
    "payperbyte": {
      "command": "npx",
      "args": ["-y", "byte-mcp-server"],
      "env": {
        "PRIVATE_KEY": "0x...",
        "RPC_URL": "https://sepolia-rollup.arbitrum.io/rpc"
      }
    }
  }
}

PRIVATE_KEY は省略可能です。読み取り専用のツールは、これがなくても動作します。購読、公開、購入、クエリを有効にするには追加してください。

Claude Code

claude mcp add payperbyte -- npx -y byte-mcp-server

環境変数

変数	必須	デフォルト	説明
PRIVATE_KEY	書き込み／購入／クエリ用ツールでのみ必要	—	EOA キーです。byte_buy_data 用のBase メインネット上の実際の USDCと、購読／公開／クエリ用のテストネットトランザクションに署名します。専用ウォレットを使用してください
RPC_URL	いいえ	https://sepolia-rollup.arbitrum.io/rpc	Arbitrum Sepolia RPC（オンチェーンの読み取り／購読レイヤー）
INDEXER_URL	いいえ	https://feeds.payperbyte.io	PayPerByte インデクサー API
BYTE_GATEWAY_URL	いいえ	https://x402.payperbyte.io	x402 ゲートウェイのベース URL（byte_buy_data で使用）
BYTE_GATEWAY_ATTESTER	いいえ	現在のゲートウェイアテスター（0xB48CCc9e3ab67041e3b5D09700138E45cda6AeA8、2026-08-19 にローテーション）	byte_buy_data が配信レシートの検証先として固定するアテスターアドレスです。このパッケージの更新前にゲートウェイがローテーションされた場合は、/.well-known/agent.json の新しい receipt.attester に設定してください。古いアドレスに固定したままだと、支払い精算後の購入がフェイルクローズします
MAX_PAYMENT_USDC	いいえ	—（上限なし）	byte_buy_data のサーバー側支出上限を、10 進数の USDC で指定します（例：0.25）。設定すると、上限を超える 402 の見積もりは署名前に拒否されます。未設定の場合は上限がありません。専用の残高が少ないウォレットを、最後の安全策として使用してください

ネットワーク

2 つのレールを、実態に即して説明します。

• x402 支払いレール（byte_buy_data）：Base メインネット（eip155:8453）。 有料フィードは x402.payperbyte.io のゲートウェイ経由で実際の USDC を精算します。有料の 200 レスポンスにはそれぞれ、正確なレスポンスバイト列に対する EIP-712 レシート X-BYTE-Attestation が含まれます。
• オンチェーンレイヤー（購読、ブロードキャスト、事実オラクルのエスクロー、インデクサー）：Arbitrum Sepolia（チェーン 421614）。 BYTE Library コントラクトのメインネット展開は、外部のセキュリティ監査が完了するまで保留されています。EIP-712 PayloadAttestation の署名ドメインは、支払いレールにかかわらず 421614 を基準とします。

コントラクトアドレスは同梱の設定に固定されており、npm リリースにはすぐに使えるデフォルト値が含まれています。トークンはありません。

開発

git clone https://github.com/0rkz/byte-mcp-server.git
cd byte-mcp-server
npm install
npm run build && npm start

ライセンス

MIT — LICENSE をご覧ください。

スターターキット

任意の有料キット（$39）：購入者側エージェントキット — フィードを購入して検証するエージェントです。Claude Desktop／Claude Code／Cursor 用の設定をすぐに導入でき、30 分間の無料相談も含まれています。npm パッケージは無料の MIT ライセンスで、今後も無料です。このキットでは、セットアップ済みの環境を販売しています。

リンク

• payperbyte.io — PayPerByte のホーム
• x402.payperbyte.io/feeds — ライブフィードカタログ
• Model Context Protocol — MCP 仕様
• MCP TypeScript SDK
• gold-402 — 稼働中の x402 サービスを厳選したディレクトリ（PayPerByte も掲載）