PayPerByte MCP サーバー

AIエージェントに**PayPerByte**への直接アクセスを提供するModel Context Protocolサーバーです。暗号学的に証明され、来歴を検証できる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。 有料フィードは実際の資金で決済されます。旗艦のMerchant Screen Oracleは判定1回につき$0.10です。マーチャントのドメインと支払い先アドレスに対する署名付きALLOW/WARN/BLOCKチェックで、レスポンスの正確なバイト列に対する署名付きEIP-712アテステーションによって裏付けられ、エージェントがx402支払いを決済する前に実行されます。真正性と配信の完全性であり、判定自体の正しさの保証ではありません。また、指定したドメイン・アドレス・価格に対するものであり、最終的に決済するアドレスを監視・制約するものではありません。使う予定の金額だけを保持する専用ウォレットを使用してください。

• オンチェーン購読/公開/クエリ層（BYTE Libraryコントラクト+インデクサー）: Arbitrum Sepoliaテストネット（チェーン421614）、MockUSDC。 この層のメインネットは外部セキュリティ監査を条件としています。EIP-712アテステーション署名ドメインは、どちらのレールで支払ったかに関係なく421614に固定されたままです。

1つのPRIVATE_KEYで両方のレールに対応します。失っても構わない資金を保持するキーを再利用しないでください。

クイックスタート

npx -y byte-mcp-server

MCPクライアント（Claude Desktop設定は以下）に配線すると、エージェントは以下を実行できます:

• フィードを発見: 「PayPerByteカタログを一覧表示」 / 「天気のパブリッシャーを検索」

• 支払う前に取引相手をスクリーニング（x402、セットアップ不要）: 「決済する前にこのドメインと支払い先アドレスをスクリーニングして」 → Baseメインネットで実際のUSDC $0.10、Merchant Screen Oracleからの署名付きALLOW/WARN/BLOCK判定とアテステーションレシート付き

• まず安価に試す: 「天気を取得して」 / 「今日M4以上の地震はある？」 → 実際のUSDC $0.005 / $0.003、すべてのレスポンスに同じアテステーションレシート付き — 判定に使う前に検証してから行動する仕組みを確認できる最も安価な方法

• ストリームに購読（テストネット）: 「地震フィードに購読して」 → Arbitrum Sepoliaでの継続的決済のためにMockUSDCを自動承認

• ファクトオラクルにクエリ（テストネット）: 登録済みファクトオラクルパブリッシャーに署名付きEIP-712質問を投稿し、引用付きのオンチェーン署名回答を取得 — ファクトオラクルパブリッシャーが稼働している場合（現在は誰もブロードキャストしていないため、登録してブロードキャストするまでツールはタイムアウトします）

ライブカタログは**x402.payperbyte.io/feeds**にあります — 天気、マーケット、コード、セキュリティ、ナレッジにわたる、暗号学的に証明され来歴を検証できるフィードです。

Related MCP server: CorteX402

行動前検証（ForeSeal）

検証してから行動するループ全体を1つのコマンドで確認できます — インストール不要、サインアップ不要、ウォレット不要:

npx @foreseal/demo

ローカルで実行され（実際のUSDCは不要）、エージェントが本物のバイト列に対してACTし、4つの攻撃（改ざんされたバイト、偽造署名、レシート欠落、フォークされた署名ドメイン）をREFUSEする様子を約1秒で示します。

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

• Kit — @payperbyte/sdk: 購入者が行動前にレシートを検証します。

• Gate — @foreseal/gate: 販売者が任意のx402エンドポイントに検証可能なレシートをスタンプします。

2つのパラダイム: 購読 vs. 購入

購入はゼロセットアップ、使った分だけ支払い、実際の決済で稼働中です。購読は監査ゲート付きテストネット層で毎回のブロードキャストを配信します。アクセスパターンで選択してください。

判定の購入（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": "100000" }
}

有料レスポンスは署名付き判定と、X-BYTE-Attestationレシートに対するインラインの検証してから行動する結果を返します:

{
  "feed": "merchant-screen",
  "paid": true,
  "price": "$0.100000",
  "txHash": "0x…",
  "data": { "answer": { "verdict": "ALLOW", "reasons": ["…"] }, "attestation": { "…": "…" } },
  "verification": { "verified": true, "hashMatch": true, "signerMatch": true,
                    "reason": "receipt verified — bytes intact AND signed by the pinned gateway attester (safe to act)" }
}

verification.verified === trueの場合のみ行動してください — レシートは来歴と完全性を証明するものであり、正しさを証明するものではありません。その他のPOSTボディ: address-reputation {domain,address}、sanctions-screen {address|name}、pkg-verdict {ecosystem,package[,version]}、reasoning-verdict {subject}。GETデータフィード（天気、地震など）ではbodyを完全に省略します。

ツール（全15個）

ディスカバリー（読み取り専用、ウォレット不要）

ストリームへの購読（PRIVATE_KEYが必要）

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

設定

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",
        "INDEXER_URL": "http://localhost:8080"
      }
    }
  }
}

PRIVATE_KEY は任意です — 読み取り専用ツールはこれなしで動作します。購読・公開・購入・クエリを有効にするには追加してください。

Claude Code

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

環境変数

ネットワーク

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）: buyer-side agent kit — フィードを購入・検証するエージェントで、ドロップインの Claude Desktop / Claude Code / Cursor 設定と無料の 30 分間レディネスコールが含まれます。npm パッケージは無料の MIT のままです — キットは組み立て済みのセットアップを販売するものです。

リンク

• payperbyte.io — PayPerByte ホーム

• x402.payperbyte.io/feeds — ライブフィードカタログ

• Model Context Protocol — MCP 仕様

• MCP TypeScript SDK