BitBooth Agent Tools

@bitbooth/mcp-fetch

An agent-facing x402 catalog and buyer shipped as one MCP server. Discover and preflight BitBooth APIs for free, fetch a URL over Base USDC, or explicitly opt into XRPL mainnet RLUSD for PageDelta, lightweight page watching, and XRPL wallet-runway monitoring.

What makes this worth paying for: page_delta renders a public page, returns bounded Markdown and exact focus evidence, compares it with that payer's prior observation, and may include a bounded JPEG snapshot. It also returns hashes, an opaque tracking cursor that never authorizes access, a content-bound observation ID that is not a public attestation, and settled payment metadata. Web content is always marked untrusted.

🧭 Scope: discover_bitbooth and preflight_bitbooth are free and available in every rail mode, even without a wallet credential. Base remains the default paid rail and exposes fetch. Explicit xrpl-rlusd mode exposes the 0.001-RLUSD watch tools and keeps page_delta visible for recovery. New PageDelta signing requires an explicit per-call cap of at least 0.010000; a zero, omitted, or subsequently lowered cap permits only exact recovery of an already-signed proof. The live catalog at /bazaar.json is canonical.

✅ Verified on-chain — BitBooth's XRPL merchant receipts are public on the XRPL AI profile.

🛡️ Testnet by default. A fresh install uses Base Sepolia. XRPL is mainnet-only and requires both an explicit rail selection and a separate XRPL seed.

Install

Use version 2.3.1 for accurate PageDelta onboarding: this patch corrects the examples to include PageDelta's required requestId and accurately identifies the default public /v1/fetch route as Base Sepolia. It does not expand the payment runtime or add payment networks. PageDelta remains on the serialized XRPL buyer introduced in 2.3.0. Keep the ^2.3.1 pin below so older clients cannot expose an incompatible tool contract or stale setup guidance.

MCP-native — drop into Claude Desktop, Claude Code, Cursor, Windsurf, Continue, or any MCP-compatible client. The snippet below matches the canonical install on app.heinrichstech.com.

Claude Desktop / Cursor / Windsurf / Continue

Paste into claude_desktop_config.json (Claude Desktop), .cursorrules.mcp.json (Cursor), or your client's MCP config:

For free catalog discovery and preflight, no wallet is required:

{

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

Add a dedicated testnet wallet to enable the paid fetch tool:

{

"mcpServers": { "bitbooth": { "command": "npx", "args": ["-y", "@bitbooth/mcp-fetch@^2.3.1"], "env": { "BITBOOTH_AGENT_KEY": "0x ", "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

Set your agent wallet key:

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

Global install

npm install -g @bitbooth/mcp-fetch@^2.3.1

mcp-fetch # runs on stdio

Get a testnet wallet + USDC (free, 2 minutes)

1. Generate an EVM wallet or use an existing one you control
2. Fund it with Base Sepolia ETH (gas): https://www.alchemy.com/faucets/base-sepolia
3. Fund it with Base Sepolia USDC: https://faucet.circle.com (select Base Sepolia)
4. Set BITBOOTH_AGENT_KEY to the wallet's private key (0x...)

Usage

Every install exposes two free tools that never sign or submit a payment:

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 fetches and validates the live catalog, then returns concise JSON with matching routes and advertised payment requirements. Set configuredOnly: true to filter to the MCP server's configured network and asset instead of browsing all rails.

preflight_bitbooth accepts an exact route name, path, or URL and either selects one compatible advertised requirement under the hard price ceiling or returns a structured no_match. If network or asset is explicit, that filter wins, but it does not reconfigure the buyer: the selected requirement must still match the server's configured payment rail. Otherwise preflight uses that configured rail automatically. Its output always contains paymentAuthorized: false. A buyer must still compare the selection with the live HTTP 402 challenge before signing.

With a Base wallet configured, your agent also gets the paid fetch tool:

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

Modes:

Returns markdown with title, body, and metadata (URL, timestamp, content length, truncation status).

XRPL RLUSD agent tools

XRPL mode replaces the paid fetch tool with two 0.001-RLUSD watch tools. With an explicit per-call cap of at least 0.010000, it also exposes PageDelta. The free discovery and preflight tools remain available:

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

watch_page stores a lightweight content fingerprint, then reports meaningful changes on later calls. watch_xrpl_wallet returns OK, WARN, or CRITICAL with spendable XRP after reserves, RLUSD trust-line and paid-call runway, recent validated activity, unfamiliar destinations, and payer-scoped baseline deltas. Omitted wallet-watch policy fields use server defaults: 0.001 RLUSD per planned call, 10 calls remaining, 1,000 spendable drops, no known destinations, and 50 recent transactions.

page_delta costs exactly 0.010000 RLUSD. It requires a caller-generated UUID requestId; reuse that UUID only to recover the same paid attempt. Before starting a later observation, use a new UUID and set acknowledgeRequestId to the prior completed UUID. Its extract value is article (default) or raw; focus is an optional exact, case-sensitive search over the bounded Markdown; and cursor is the opaque value from a prior observation. A missing screenshot is a valid result and is explained in warnings.

To opt in, use a dedicated low-balance payment wallet that holds only the RLUSD and XRP gas budget intended for this agent:

{

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

This is real mainnet spend. BITBOOTH_AGENT_KEY is never used as an XRPL seed, and setting only BITBOOTH_XRPL_SEED does not enable XRPL payments. Keep BITBOOTH_MAX_PER_CALL_USD=0.001 if the agent should have only the watch tools; PageDelta will not be registered. Monitoring the payment wallet itself works, but its own watch payment changes that wallet; for cleaner incident signals, pay from a separate low-balance watchdog wallet.

Pricing

Configuration

| BITBOOTH_XRPL_WS_URL | Credential-