BitBooth Agent Tools

@bitbooth/mcp-fetch

エージェント向けの x402 カタログと購入機能を、1 つの MCP サーバーとして提供します。 BitBooth API を無料で検出して事前確認するか、Base USDC で URL を取得できます。また、PageDelta、軽量なページ監視、XRPL ウォレットの資金状況監視には、XRPL メインネットの RLUSD を明示的に選択できます。

料金を支払う価値がある理由： page_delta は公開ページをレンダリングし、上限付きの Markdown と正確な注目箇所の証拠を返します。さらに、その支払者の過去の観測結果と比較し、上限付きの JPEG スナップショットを含める場合があります。また、ハッシュ、アクセス許可には決して使われない不透明な追跡カーソル、公開の証明書ではないコンテンツに紐付いた観測 ID、決済済みの支払いメタデータも返します。Web コンテンツには常に信頼できないというマークが付けられます。

🧭 対象範囲： discover_bitbooth と preflight_bitbooth は無料で、ウォレット認証情報がなくてもすべての決済レールモードで利用できます。Base はデフォルトの有料決済レールで、fetch を提供します。明示的に xrpl-rlusd モードを選ぶと、0.001-RLUSD の監視ツールが利用可能になり、復旧用に page_delta も表示されます。新しい PageDelta への署名には、呼び出しごとに 0.010000 以上の上限を明示する必要があります。上限がゼロまたは省略された場合、あるいは後から引き下げられた場合、すでに署名済みの証明を正確に復旧することのみ許可されます。ライブカタログ /bazaar.json が正規の情報源です。

✅ オンチェーンで検証済み — BitBooth の XRPL マーチャントの領収記録は、XRPL AI プロフィールで公開されています。

🛡️ デフォルトはテストネットです。 新規インストールでは Base Sepolia が使用されます。XRPL はメインネット専用で、レールの明示的な選択と、別途用意した XRPL シードの両方が必要です。

インストール

PageDelta の正確な導入手順には、バージョン 2.3.1 を使用してください： このパッチでは、PageDelta に必須の requestId を例に追加し、デフォルトの公開 /v1/fetch ルートが Base Sepolia であることを正確に示しています。決済ランタイムの拡張や決済ネットワークの追加はありません。PageDelta は 2.3.0 で導入された直列化された XRPL 購入機能を引き続き使用します。古いクライアントが互換性のないツール契約や古い設定手順を提示しないよう、以下の ^2.3.1 固定を維持してください。

MCP ネイティブ — Claude Desktop、Claude Code、Cursor、Windsurf、Continue、または MCP 対応クライアントにそのまま追加できます。 以下のスニペットは、app.heinrichstech.com の正規のインストール手順と一致しています。

Claude Desktop / Cursor / Windsurf / Continue

claude_desktop_config.json（Claude Desktop）、.cursorrules.mcp.json（Cursor）、またはお使いのクライアントの MCP 設定に貼り付けます：

無料のカタログ検出と事前確認には、ウォレットは不要です：

{
  "mcpServers": {
    "bitbooth": {
      "command": "npx",
      "args": ["-y", "@bitbooth/mcp-fetch@^2.3.1"]
    }
  }
}

有料の fetch ツールを有効にするには、専用のテストネットウォレットを追加します：

{
  "mcpServers": {
    "bitbooth": {
      "command": "npx",
      "args": ["-y", "@bitbooth/mcp-fetch@^2.3.1"],
      "env": {
        "BITBOOTH_AGENT_KEY": "0x<your-testnet-wallet-private-key>",
        "BITBOOTH_MAX_PER_CALL_USD": "0.10",
        "BITBOOTH_DAILY_LIMIT_USD": "1.00"
      }
    }
  }
}

Claude Code

claude mcp add bitbooth -- npx -y @bitbooth/mcp-fetch@^2.3.1

エージェントウォレットのキーを設定します：

export BITBOOTH_AGENT_KEY="0x<your-testnet-wallet-private-key>"

グローバルインストール

npm install -g @bitbooth/mcp-fetch@^2.3.1
mcp-fetch   # runs on stdio

テストネットウォレットと USDC を入手する（無料、2 分）

1. EVM ウォレットを生成するか、自分で管理している既存のウォレットを使用します
2. Base Sepolia ETH（ガス代）を入金します：https://www.alchemy.com/faucets/base-sepolia
3. Base Sepolia USDC を入金します：https://faucet.circle.com （Base Sepolia を選択）
4. BITBOOTH_AGENT_KEY にウォレットの秘密鍵（0x...）を設定します

使用方法

どのインストールでも、署名や支払いの送信を行わない無料ツールを2つ利用できます。

discover_bitbooth(
  query: "repair malformed JSON",
  category: "utility",
  maxPriceUsd: 0.01,
  network: "eip155:8453",
  limit: 10
)

preflight_bitbooth(
  route: "json-repair",
  maxPriceUsd: 0.01,
  network: "eip155:8453"
)

discover_bitbooth は最新のカタログを取得して検証し、一致するルートと提示された支払い要件を簡潔な JSON で返します。configuredOnly: true を設定すると、すべての決済手段を参照する代わりに、MCP サーバーで設定されたネットワークとアセットに絞り込めます。

preflight_bitbooth は正確なルート名、パス、または URL を受け取り、厳格な価格上限以下で互換性のある提示済み要件を1つ選択するか、構造化された no_match を返します。network または asset が明示されている場合、そのフィルターが優先されますが、購入者の設定は変更されません。選択される要件は、サーバーに設定された決済手段にも一致している必要があります。それ以外の場合、preflight は設定済みの決済手段を自動的に使用します。出力には常に paymentAuthorized: false が含まれます。署名する前に、購入者は選択内容と最新の HTTP 402 チャレンジを引き続き照合する必要があります。

Base ウォレットを設定すると、エージェントは有料の fetch ツールも利用できるようになります。

fetch(url: "https://example.com", mode: "full")

モード：

モード	価格	説明	最適な用途
fast	0.005 USDC	生の HTML を Markdown に変換	素早い検索、静的ページ
full	0.005 USDC	記事を抽出（Readability）してから Markdown に変換	ブログ記事、ドキュメント、ニュース

タイトル、本文、メタデータ（URL、タイムスタンプ、コンテンツの長さ、切り詰め状態）を含む Markdown を返します。

XRPL RLUSD エージェントツール

XRPL モードでは、有料の fetch ツールが、料金上限を各呼び出しで明示的に少なくとも 0.010000 に設定した場合に PageDelta も公開される、0.001-RLUSD の監視ツール2つに置き換わります。無料の discovery ツールと preflight ツールは引き続き利用できます。

watch_page(url: "https://example.com/pricing")

watch_xrpl_wallet(
  address: "rAgentWallet...",
  minCallsRemaining: 10,
  minSpendableXrpDrops: "1000",
  allowedDestinations: ["rKnownMerchant..."]
)

page_delta(
  requestId: "2f019f98-7bea-4c44-9b3f-2d6d9ffbce6c",
  url: "https://example.com/pricing",
  extract: "article",
  focus: "Enterprise price",
  cursor: "pd1_<cursor-from-the-prior-observation>"
)

watch_page は軽量なコンテンツフィンガープリントを保存し、その後の呼び出しで意味のある変更を報告します。watch_xrpl_wallet は、準備金差し引き後の使用可能な XRP、RLUSD のトラストラインと有料呼び出し可能回数、最近検証されたアクティビティ、見慣れない送金先、支払者ごとのベースライン差分を含む OK、WARN、CRITICAL を返します。ウォレット監視のポリシーフィールドを省略すると、サーバーのデフォルトが使用されます。デフォルトは、予定された呼び出し1回あたり 0.001 RLUSD、残り10回、使用可能な 1,000 ドロップ、既知の送金先なし、直近のトランザクション50件です。

page_delta の料金は正確に 0.010000 RLUSD です。呼び出し元が生成した UUID requestId が必要です。同じ有料の試行を復旧する場合に限り、その UUID を再利用してください。後続の観測を開始する前に、新しい UUID を使用し、直前に完了した UUID を acknowledgeRequestId に設定してください。extract の値は article（デフォルト）または raw です。focus は任意で、上限付き Markdown 内を大文字と小文字を区別して完全一致で検索します。cursor は前回の観測で返された不透明な値です。スクリーンショットがない場合も有効な結果であり、その理由は warnings で説明されます。

有効にするには、低残高の専用支払いウォレットを使用してください。このウォレットには、このエージェント用の RLUSD と XRP のガス予算のみを入れてください。

{
  "mcpServers": {
    "bitbooth-watch": {
      "command": "npx",
      "args": ["-y", "@bitbooth/mcp-fetch@^2.3.1"],
      "env": {
        "BITBOOTH_PAYMENT_RAIL": "xrpl-rlusd",
        "BITBOOTH_XRPL_SEED": "sEd<dedicated-agent-seed>",
        "BITBOOTH_MAX_PER_CALL_USD": "0.010000",
        "BITBOOTH_DAILY_LIMIT_USD": "0.10"
      }
    }
  }
}

これは実際のメインネットでの支出です。BITBOOTH_AGENT_KEY が XRPL シードとして使われることはなく、BITBOOTH_XRPL_SEED だけを設定しても XRPL 決済は有効になりません。エージェントに監視ツールのみを使わせる場合は、BITBOOTH_MAX_PER_CALL_USD=0.001 を維持してください。PageDelta は登録されません。支払いウォレット自体の監視は機能しますが、そのウォレット自身の監視料金の支払いによって残高が変化します。インシデントのシグナルをより明確にするには、別の低残高ウォッチドッグウォレットから支払ってください。

料金

項目	費用
discover_bitbooth	無料 — 公開中のカタログを読み取ります
preflight_bitbooth	無料 — 要件を選択しますが、署名も支払いも行いません
fast/full	取得ごとに 0.005 USDC
watch_page	フィンガープリントの比較ごとに 0.001 RLUSD
watch_xrpl_wallet	ウォレットの残高余力／アクティビティの確認ごとに 0.001 RLUSD
page_delta	レンダリングされた観測と比較ごとに 0.010000 RLUSD
ガス	該当する場合は基本ガス代。XRPL の手数料はデフォルトで 100 drops が上限です
デフォルトのチェーン	Base Sepolia（テストネット）。メインネットは明示的なオプトインが必要です。

設定

環境変数	説明	デフォルト
BITBOOTH_AGENT_KEY	専用の EVM エージェント秘密鍵（有料の Base fetch ツールでのみ必須です）	—
BITBOOTH_PAYMENT_RAIL	base またはメインネットへの明示的なオプトイン xrpl-rlusd	base
BITBOOTH_XRPL_SEED	専用の XRPL シード。xrpl-rlusd でのみ必須です	—
BITBOOTH_CHAIN_ID	従来の fetch ツールで使用する Base ネットワーク。デフォルトの公開 /v1/fetch オリジンでは現在 84532（Base Sepolia）が必要です。	84532
BITBOOTH_API_URL	BitBooth ゲートウェイの URL	https://app.heinrichstech.com
BITBOOTH_RPC_URL	EVM RPC エンドポイント	https://base-sepolia-rpc.publicnode.com
BITBOOTH_CONFIRMATIONS	再試行前に待機するトランザクションの確認数（最低 2）	2
BITBOOTH_API_KEY	オプションのテナント API キー（レート制限の引き上げに使用）	—
BITBOOTH_MAX_PER_CALL_USD	1 つのチャレンジで受け付けるステーブルコインの最大額。PageDelta を公開するには、0.010000 以上を明示的に設定します	0.10 Base / 0.001 XRPL
BITBOOTH_DAILY_LIMIT_USD	ウォレットごとの UTC 日次予約上限。XRPL の計上内容は再起動後も保持されます	1.00 Base / 0.10 XRPL
BITBOOTH_XRPL_WS_URL	署名済みトランザクションの自動入力と台帳への紐付けにのみ使用する、認証情報不要の WSS エンドポイント	wss://xrplcluster.com/
BITBOOTH_XRPL_MAX_FEE_DROPS	自動入力されるトランザクションで許可する XRP ネットワーク手数料の上限	100

Base ネットワークとの互換性

レガシー Base クライアントは、BITBOOTH_API_URL が Base メインネットで実際にチャレンジを要求する互換性のある x402 オリジンを指している場合に限り、チェーン ID 8453 をサポートします。デフォルトの公開ルート https://app.heinrichstech.com/v1/fetch は現在 Base Sepolia（84532）でチャレンジを要求しており、クライアントは設定とネットワークが一致しないチャレンジを意図的に拒否します。

デフォルトのオリジンに対して BITBOOTH_CHAIN_ID=8453 を設定しないでください。このパッケージにおける BitBooth の稼働中の PageDelta メインネットパスは、上記の明示的な xrpl-rlusd 設定です。

XRPL の安全性固定条件

XRPL モードは、稼働中のすべての PAYMENT-REQUIRED チャレンジが以下の値すべてに一致しない限り、支払いを拒否します。

• HTTPS オリジン https://app.heinrichstech.com
• ネットワーク xrpl:0、スキーム exact、および正規の 16 進数エンコードされた RLUSD 通貨
• Ripple RLUSD 発行者 rMxCKbEDwqr76QuheSUMdEGf4B9xJ8m5De
• BitBooth 受取人 rfryheo6yzFdLWj8qUQtZc7zG9MKkBkUEy
• 要求されたリソース URL と完全に一致すること、上限のある一度限りの請求書、および想定されるソースタグ
• どちらの XRPL ウォッチツールも、正確に 0.001000 RLUSD
• 既存の /v1/cdp/render-pro リソース上の PageDelta は、正確に 0.010000 RLUSD

トランザクションには最終レジャーによる上限が設定され、部分支払いは禁止されています。また、署名前に自動入力された受取人、金額、発行者、請求書、メモ、および手数料の各フィールドを再確認します。署名済みペイロードは PAYMENT-SIGNATURE として送信され、ペイロードとシードが出力されることはありません。

watch_page は、チャレンジを要求する前に、認証情報を含む URL、localhost と .local の名前、およびプライベート、ループバック、リンクローカルの各 IP アドレスのリテラルを拒否します。BitBooth はまた、リバインディングやホスト名からプライベートアドレスへの解決を防ぐため、決済前にサーバー側で DNS を解決して確認します。watch_xrpl_wallet は、チャレンジを要求する前に、従来型アドレス、数値の範囲、アクティビティ制限、および最大 25 アドレスの許可リストを検証します。

プログラムからの使用

カタログの検出と事前確認は、ウォレットクライアントを構築せずに利用できます。

import { createCatalogClient } from '@bitbooth/mcp-fetch/catalog-client';

const catalog = createCatalogClient({ chainId: 8453 });
const choices = await catalog.discover({ query: 'monitor', maxPriceUsd: 0.01 });
const checkout = await catalog.preflight({ route: 'web-watch', maxPriceUsd: 0.001 });
console.log(choices.resources, checkout);

自動支払いの場合：

import { createX402Client } from '@bitbooth/mcp-fetch/x402-client';

const client = createX402Client({ agentKey: process.env.AGENT_KEY });
const result = await client.fetchWithPayment('https://example.com', 'fast');
console.log(result.markdown);

const watcher = createX402Client({
  paymentRail: 'xrpl-rlusd',
  xrplSeed: process.env.DEDICATED_XRPL_AGENT_SEED,
  maxPerCallUsd: '0.010000',
  dailyLimitUsd: '0.10',
});
const result = await watcher.watchPageWithPayment('https://example.com/pricing');
console.log(result.changed, result.hashes.current, result.baseline);

const health = await watcher.watchXrplWalletWithPayment({
  address: 'rAgentWallet...',
  minCallsRemaining: 10,
  minSpendableXrpDrops: '1000',
  allowedDestinations: ['rKnownMerchant...'],
});
console.log(health.status, health.runway, health.alerts);

const firstRequestId = crypto.randomUUID();
const observation = await watcher.pageDeltaWithPayment({
  requestId: firstRequestId,
  url: 'https://example.com/pricing',
  extract: 'article',
  focus: 'Enterprise price',
});
console.log(observation.diff, observation.focusEvidence, observation.payment);

const nextObservation = await watcher.pageDeltaWithPayment({
  requestId: crypto.randomUUID(),
  acknowledgeRequestId: firstRequestId,
  url: 'https://example.com/pricing',
});

仕組み

無料のカタログクライアントは、認証情報を必要としない GET /bazaar.json を1回実行し、リモートのペイロード全体をZodで検証してから、ローカルでフィルタリングします。APIキー、ウォレットキー、シード、署名、支払いヘッダーは送信しません。事前確認は参考情報です。実際に購入する際は、新しいHTTP 402チャレンジを改めて検証する必要があります。

Baseでの支払いでは、このパッケージは既存のリクエストに紐づいたUSDC送金フローを実行します。XRPLモードでは、base64形式の PAYMENT-REQUIRED v2ヘッダーを読み取り、ピン留めされたRLUSD要件を1つだけ選択し、ルートの正確な正規価格を確認して、支出額を永続的に予約してから、請求書に紐づいたXRPL Paymentに署名し、base64形式の PAYMENT-SIGNATURE を送信します。PageDeltaも別の署名処理や支払いループではなく、同じコードパスを使用します。XRPLのライフサイクル全体は、パッケージのクライアントやプロセスをまたいで、ウォレットごとにシリアル化されます。ウォレットごとに保持される未解決の証明は最大1件です。同じリクエストの再試行では同じ証明をバイト単位で再利用しますが、別のリクエストは最初のリクエストが解決するまでブロックされます。page_delta には、呼び出し元が生成したUUIDの requestId が必要です。同じ支払い試行を復旧する場合に限り、同じIDを再利用してください。検証済みの結果は、次のPageDelta呼び出しで新しいUUIDと、前のUUIDに一致する acknowledgeRequestId が指定されるまで復旧可能な状態で保持されます。確認応答と次の予約は、1回のアトミックなウォレットドキュメント遷移として処理されます。自動監視の結果にはIDは不要で、常に最新の状態に保たれ、未確認の明示的なPageDelta結果を上書きすることはありません。

XRPLの証明、上限付きの完了済み結果、ウォレットごとのUTC日次支出台帳は、専用ウォレットシードから導出されたキーを使用して、1つのウォレットごとのドキュメントにまとめて暗号化されます。このドキュメントはfsync後にアトミックに置き換えられ、POSIXの所有権とモード、およびWindowsのプライベートDACLの読み戻しがフェイルクローズ方式で適用されます。 MCPホストで別の永続状態ディレクトリが必要な場合に限り、BITBOOTH_XRPL_JOURNAL_DIRを設定してください。再起動後は、まったく同じ requestId と入力で再試行してください。ブロックを回避するためにこの状態を削除してはいけません。稼働中のプロセスが所有するリースは奪取されません。ネイティブHTTP呼び出しのタイムアウトは30秒です。ホストが実際に応答不能になった場合は、PIDベースの復旧を行う前に終了させる必要があります。

人が介入する必要はありません。登録も不要です。x402による従量課金で利用できます。

エージェントが呼び出せるエンドポイント

すべてのモードで discover_bitbooth と preflight_bitbooth を利用できます。有料ツールの公開内容は選択した決済レールに応じて異なります。Baseでは fetch、XRPL RLUSDでは watch_page、watch_xrpl_wallet、および復旧に対応した page_delta を利用できます。PageDeltaで新たな支出を開始するには、1回の呼び出しごとに0.010000以上の上限を明示する必要があります。エージェントは、互換性のあるx402購入者を介して、BitBoothの残りの機能をプレーンなHTTPで呼び出せます。価格とルートの一覧は変更されるため、/bazaar.json と最新のHTTP 402チャレンジが正規の情報源です。

連邦政府向けの体制

BitBoothは、**サービスによる障害を持つ退役軍人が所有する小規模事業者（SDVOSB認定済み）**によって運営されており、有効な CAGEコード と SAM.gov 登録を備えています。防衛関連チームや連邦政府請負業者は、身元を確認できる米国の供給業者を通じて、実装およびマネージド運用の支援を調達できます。詳細はランディングページをご覧ください。

セキュリティに関する注意事項

• BITBOOTH_AGENT_KEY と BITBOOTH_XRPL_SEED はシークレットです。専用のエージェントウォレットを別途用意し、個人用または財務用のウォレットは使用しないでください。
• 検索のみを行うインストールでは、どちらのシークレットも必要ありません。カタログクライアントは BITBOOTH_API_KEY や決済認証情報を /bazaar.json に転送しません。
• デフォルトの設定ではテストネットを使用します。テストネットの設定にメインネットのキーを設定しないでください。
• Base は各決済チャレンジから受取人を検証します。すべての XRPL ツールでは、正規のネットワーク、発行者、販売者、リソース、およびルート固有の価格をコード内で固定しています。決済確定後に配信に失敗した場合、XRPL の証明は安全な再試行のために保持されます。同一のツールリクエストを再試行し、手動で別の決済を送信しないでください。
• Base の支出予約はプロセス内で管理されます。XRPL の予約と確定済み合計額は、署名の前に暗号化されたウォレットごとの UTC 日次台帳にも保存されるため、プロセスを再起動しても設定済みの XRPL 日次上限はリセットされません。署名済みの予約は、本文とヘッダーに紐づいた、決済未確定を明示する応答を受け取った場合にのみ解放されます。未署名の予約は、チャレンジの有効期限が切れた場合、または現在の上限によって使用が禁止された場合に、アトミックに解放されます。
• 暗号化されたドキュメントとプライベートディレクトリは、ドキュメントだけが削除または破損した場合、フェイルクローズします。同じ OS アカウントを持つ悪意のあるユーザーは、依然としてすべてのローカル状態を削除または巻き戻すことができます。別の分岐状態のストアを作成せずに、ローカルのみのジャーナルでそれを初回利用と区別することはできません。ローカルアカウントを信頼できるものとして扱い、専用のエージェントウォレットの残高を意図的に低く保ってください。オンレジャーのウォレット残高が、損失の絶対上限となります。

ライセンス

MIT