English Français العربية

BitBooth Agent Tools

Official registry Finance and payments

Discover BitBooth APIs for free, then buy capped x402 fetch, PageDelta, and wallet checks.

Source code Website Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

NPM package @bitbooth/mcp-fetch
Claude Code 
claude mcp add bitbooth-agent-tools -e 'BITBOOTH_AGENT_KEY=<your bitbooth_agent_key>' -e 'BITBOOTH_API_URL=<BITBOOTH_API_URL>' -e 'BITBOOTH_CHAIN_ID=<BITBOOTH_CHAIN_ID>' -e 'BITBOOTH_PAYMENT_RAIL=<BITBOOTH_PAYMENT_RAIL>' -e 'BITBOOTH_XRPL_SEED=<your bitbooth_xrpl_seed>' -e 'BITBOOTH_MAX_PER_CALL_USD=<BITBOOTH_MAX_PER_CALL_USD>' -e 'BITBOOTH_DAILY_LIMIT_USD=<BITBOOTH_DAILY_LIMIT_USD>' -- npx -y @bitbooth/mcp-fetch@2.3.1
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "bitbooth-agent-tools": {
            "command": "npx",
            "args": [
                "-y",
                "@bitbooth/mcp-fetch@2.3.1"
            ],
            "env": {
                "BITBOOTH_AGENT_KEY": "<your bitbooth_agent_key>",
                "BITBOOTH_API_URL": "<BITBOOTH_API_URL>",
                "BITBOOTH_CHAIN_ID": "<BITBOOTH_CHAIN_ID>",
                "BITBOOTH_PAYMENT_RAIL": "<BITBOOTH_PAYMENT_RAIL>",
                "BITBOOTH_XRPL_SEED": "<your bitbooth_xrpl_seed>",
                "BITBOOTH_MAX_PER_CALL_USD": "<BITBOOTH_MAX_PER_CALL_USD>",
                "BITBOOTH_DAILY_LIMIT_USD": "<BITBOOTH_DAILY_LIMIT_USD>"
            }
        }
    }
}

Environment variables

  • BITBOOTH_AGENT_KEY secret Hex private key for Base USDC payments. Required for the default base rail; not used in xrpl-rlusd mode.
  • BITBOOTH_API_URL BitBooth gateway URL. Defaults to https://app.heinrichstech.com; Base Sepolia is the default payment network.
  • BITBOOTH_CHAIN_ID EVM chain ID for the legacy fetch tool. The default public origin currently requires 84532 (Base Sepolia); 8453 is only for a separately configured compatible mainnet origin.
  • BITBOOTH_PAYMENT_RAIL Payment rail. Defaults to base. Set exactly to xrpl-rlusd to enable XRPL mainnet watch tools and optionally PageDelta.
  • BITBOOTH_XRPL_SEED secret Dedicated low-balance XRPL agent seed. Required only when BITBOOTH_PAYMENT_RAIL=xrpl-rlusd.
  • BITBOOTH_MAX_PER_CALL_USD Hard maximum payment per call. XRPL defaults to 0.001; explicitly set at least 0.010000 to expose the 0.010000-RLUSD PageDelta tool.
  • BITBOOTH_DAILY_LIMIT_USD Hard stablecoin spend cap per wallet and UTC day for this process. Defaults to 1.00 on Base and 0.10 in xrpl-rlusd mode.

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. BitBooth
  2. What PageDelta does
  3. Inspect the live challenge
  4. Try the complete flow without real money
  5. Use the MCP buyer
  6. Discovery scope
  7. XRPL ecosystem status
  8. Documentation
  9. About
  10. License

BitBooth

BitBooth's featured product is PageDelta, a paid page observation API for agents.

POST https://app.heinrichstech.com/v1/cdp/render-pro
$0.01 per observation

A buyer does not need a BitBooth account or subscription. Send a page URL, inspect the x402 challenge, pay with a supported stablecoin rail, and receive rendered Markdown plus bounded change evidence.

Live links: PageDelta browser demo | featured catalog | API docs | MCP package

What PageDelta does

The first paid observation saves a baseline scoped to the payer, canonical URL, and extraction mode. A later paid observation of the same scope compares the new result with that saved baseline.

Each successful response can include:

  • rendered, bounded Markdown
  • an exact, case-sensitive focus search result
  • a structured, bounded line diff
  • the prior baseline status and saved revision
  • a new opaque cursor for continuity checks
  • content and observation hashes
  • an optional bounded JPEG snapshot
  • settled payment metadata and a PAYMENT-RESPONSE receipt

The cursor is not an access token, and returned web content is untrusted input. Agents should still apply their own prompt-injection and data-handling policy.

Inspect the live challenge

This request does not pay. It returns HTTP 402 with the current payment requirements in the PAYMENT-REQUIRED header.

curl -i -X POST https://app.heinrichstech.com/v1/cdp/render-pro \
  -H 'content-type: application/json' \
  -d '{"url":"https://example.com","extract":"article","focus":"Example Domain"}'

For production PageDelta, the advertised rails are:

NetworkAsset
Base mainnetUSDC
XRPL mainnetRLUSD
XRPL mainnetUSDC IOU
Stellar pubnetUSDC

The fresh 402 challenge is authoritative for the exact network identifier, asset or issuer, amount, recipient, and timeout. PageDelta does not advertise a Solana rail.

Try the complete flow without real money

Open the PageDelta browser demo. It runs an isolated XRPL Testnet exercise:

  1. The tab creates a temporary wallet in browser memory.
  2. The official faucet funds it with valueless test XRP.
  3. The first observation pays 1,000 test drops and saves a payer-scoped baseline.
  4. The demo changes its isolated page from revision 1 to revision 2.
  5. The second observation pays another 1,000 test drops and returns the change.
  6. The run ends with two XRPL Testnet receipts.

Confirmation retries reuse the same signed proof. They do not create additional payments. This demo proves the test flow only. It is not a production payment and does not represent revenue.

Use the MCP buyer

The current buyer is @bitbooth/mcp-fetch@2.3.1. Its official MCP registry name is io.github.Drock91/bitbooth-fetch.

For free catalog discovery, no wallet credential is required:

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

The packaged PageDelta buyer currently automates the XRPL mainnet RLUSD path. Enabling it requires an explicit xrpl-rlusd rail, a dedicated low-balance XRPL wallet, and a per-call limit of at least 0.010000. See the integration guide before adding a seed.

Discovery scope

https://app.heinrichstech.com/bazaar.json currently features exactly one resource: PageDelta at /v1/cdp/render-pro.

That featured catalog is a deliberate release surface. It is not a count of everything implemented inside BitBooth. Internal and reference routes may exist outside it, and private seller routes are not automatically published there.

XRPL ecosystem status

BitBooth already has an XRPL AI merchant listing. It is an existing listing, not a new one. The external profile may lag BitBooth's current release, so the live featured catalog and fresh route challenge are authoritative.

ClawCredit's published docs describe generic x402 compatibility, including XRPL and RLUSD. BitBooth has not completed live ClawCredit interoperability or certification and is not currently a ClawCredit Partner. We do not claim guaranteed support, financing terms, or fees.

Documentation

About

BitBooth is built and operated by Heinrichs Software Solutions Company in Tallahassee, Florida.

This repository contains public documentation, MCP package source mirrors, PageDelta integration guidance, and links to the live OpenAPI specifications. The gateway source is operated separately.

License

MIT. See LICENSE.

Frequently asked questions

What is BitBooth Agent Tools?

Discover BitBooth APIs for free, then buy capped x402 fetch, PageDelta, and wallet checks.

How do I install BitBooth Agent Tools?

It runs on your machine. In Claude Code: claude mcp add bitbooth-agent-tools -e 'BITBOOTH_AGENT_KEY=<your bitbooth_agent_key>' -e 'BITBOOTH_API_URL=<BITBOOTH_API_URL>' -e 'BITBOOTH_CHAIN_ID=<BITBOOTH_CHAIN_ID>' -e 'BITBOOTH_PAYMENT_RAIL=<BITBOOTH_PAYMENT_RAIL>' -e 'BITBOOTH_XRPL_SEED=<your bitbooth_xrpl_seed>' -e 'BITBOOTH_MAX_PER_CALL_USD=<BITBOOTH_MAX_PER_CALL_USD>' -e 'BITBOOTH_DAILY_LIMIT_USD=<BITBOOTH_DAILY_LIMIT_USD>' -- npx -y @bitbooth/mcp-fetch@2.3.1. For other clients, paste the JSON configuration from this page into their MCP settings.

Does BitBooth Agent Tools need an API key?

Yes. It expects BITBOOTH_AGENT_KEY, BITBOOTH_XRPL_SEED, which you set in its configuration.

Is BitBooth Agent Tools open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains BitBooth Agent Tools?

It is published by Drock91. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.