{
  "markdown": "# BitBooth\n\n> The multi-chain x402 payment gateway for AI agents. **18 paid HTTP endpoints**, **5 mainnet chains**, **real on-chain settlement**, **~$2/month to run on AWS Lambda**.\n\n**Live:** [app.heinrichstech.com](https://app.heinrichstech.com)\n**Playground:** [app.heinrichstech.com/demo](https://app.heinrichstech.com/demo)\n**API reference:** [app.heinrichstech.com/docs](https://app.heinrichstech.com/docs)\n**Bazaar manifest:** [app.heinrichstech.com/bazaar.json](https://app.heinrichstech.com/bazaar.json)\n**A2A agent card:** [app.heinrichstech.com/.well-known/agent.json](https://app.heinrichstech.com/.well-known/agent.json)\n\n---\n\n## What is this?\n\nBitBooth implements the [x402 protocol](https://x402.gitbook.io) — Coinbase's spec for \"HTTP 402 Payment Required + on-chain settlement.\" Drop a paywall in front of any HTTP endpoint, and AI agents pay per call from their own wallet. No accounts, no API keys, no signups. Non-custodial — the agent pays your wallet directly, BitBooth never touches the funds.\n\n```\n1. Agent calls a paywalled endpoint with no payment\n2. Server returns HTTP 402 with a multi-chain `accepts[]` array\n3. Agent picks one entry (whatever chain it holds liquidity on) and signs\n4. Agent retries the request with X-PAYMENT header\n5. Server verifies + settles + unlocks the response\n```\n\nThe whole loop is ~3 seconds on Base mainnet.\n\n## Why multi-chain?\n\nEvery BitBooth endpoint advertises up to **9 (network, asset) tuples** in every 402 challenge:\n\n| Network | Asset | Facilitator |\n|---|---|---|\n| Base mainnet (eip155:8453) | USDC | Coinbase CDP |\n| Base mainnet | Chainlink LINK | Self-hosted onchain verifier |\n| Solana mainnet | USDC SPL | Coinbase CDP |\n| XRPL native (xrpl:0) | XRP | [T54 XRPL Facilitator](https://www.t54.ai) |\n| XRPL native | RLUSD (Ripple issuer) | T54 |\n| XRPL native | USDC IOU (Bitstamp issuer) | T54 |\n| Stellar pubnet | XLM | Self-hosted Horizon |\n| Stellar pubnet | USDC (Circle issuer) | Self-hosted Horizon |\n| XRPL EVM Sidechain (eip155:1440000) | Native XRP | Self-hosted onchain verifier |\n\nAgents pick the chain they already hold. No bridging, no swaps, no friction.\n\n## Quick start\n\n### Pay one endpoint with curl (no payment yet — see the 402 challenge)\n\n```bash\ncurl -s -X POST https://app.heinrichstech.com/v1/cdp/echo \\\n  -H 'content-type: application/json' \\\n  -d '{\"message\":\"hello from agent\"}'\n```\n\nYou'll get back a `402` response body containing `resource`, `accepts[]`, and an `extensions.bazaar` block.\n\n### Install the MCP server for any Claude / Cursor / Continue agent\n\n```bash\nnpm install -g @bitbooth/mcp-fetch\n```\n\nOr in your MCP client config (Claude Desktop, Cursor, etc.):\n\n```json\n{\n  \"mcpServers\": {\n    \"bitbooth\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@bitbooth/mcp-fetch\"],\n      \"env\": {\n        \"BITBOOTH_AGENT_KEY\": \"0x<your-testnet-wallet-private-key>\"\n      }\n    }\n  }\n}\n```\n\nTestnet by default (Base Sepolia). Opt into mainnet explicitly with `BITBOOTH_CHAIN_ID=8453`.\n\n### Or build your own buyer\n\nSee `examples/` for runnable demos:\n- `01-curl-fetch.sh` — pure shell, sees the 402 challenge\n- `02-node-evm-pay.mjs` — Node + ethers, signs EIP-3009 transferWithAuthorization on Base\n- `03-node-xrpl-pay.mjs` — Node + xrpl.js, signs an XRPL Payment tx through the T54 facilitator\n- `04-mcp-config.json` — drop-in MCP client config\n- `05-langchain-agent.py` — LangChain agent that fetches paid URLs\n\n## The endpoint catalog\n\n| Endpoint | Price | Category |\n|---|---|---|\n| `/v1/cdp/echo` | $0.001 | utility |\n| `/v1/cdp/json-repair` | $0.001 | utility |\n| `/v1/cdp/faker` | $0.001 | utility |\n| `/v1/cdp/jwt-verify` | $0.001 | utility |\n| `/v1/cdp/webhook-sig-verify` | $0.001 | utility |\n| `/v1/cdp/llm-tool-validate` | $0.002 | utility |\n| `/v1/cdp/pii-redact` | $0.002 | utility |\n| `/v1/cdp/rss` | $0.002 | data |\n| `/v1/cdp/dns` | $0.002 | utility |\n| `/v1/cdp/ssl-info` | $0.002 | security |\n| `/v1/cdp/x402-discover` | $0.005 | security |\n| `/v1/cdp/agent-credit-score` | $0.005 | security |\n| `/v1/cdp/wallet-doctor` | $0.005 | security |\n| `/v1/cdp/prompt-injection-scan` | $0.005 | security |\n| `/v1/cdp/contract-honeypot-check` | $0.005 | security |\n| `/v1/cdp/approval-safety` | $0.05 | security |\n| `/v1/cdp/render-pro` | $0.05 | data |\n| `/v1/cdp/web-diff` | $0.08 | data |\n\nFull schemas in [`openapi.yaml`](./openapi.yaml). Live manifest at [`/bazaar.json`](https://app.heinrichstech.com/bazaar.json).\n\n## Documentation\n\n- [`docs/INTEGRATION.md`](./docs/INTEGRATION.md) — integration guide (buyer + seller patterns)\n- [`docs/ENDPOINTS.md`](./docs/ENDPOINTS.md) — full endpoint catalog with examples\n- [`docs/XRPL.md`](./docs/XRPL.md) — XRPL native + XRPL EVM Sidechain integration notes\n- [`openapi.yaml`](./openapi.yaml) — full OpenAPI spec for every paid endpoint\n- [`examples/`](./examples/) — runnable demos\n\n## About\n\nBitBooth is built and operated by **[Heinrichs Software Solutions Company](https://heinrichstech.com)** — a veteran-owned business based in Tallahassee, Florida. SDVOSB-pending, CAGE-registered, SAM.gov-registered. Solo-built. Production-grade testing (~2,400+ Vitest tests, 92% coverage on core payment + middleware paths). Approved under [Anthropic's Cyber Verification Program](https://www.anthropic.com) for dual-use cybersecurity work.\n\n## License\n\nMIT — see [LICENSE](./LICENSE).\n\nThis repository contains the **public documentation, OpenAPI spec, and runnable examples** for BitBooth. The gateway source code is operated privately during a federal-procurement-posture scrub; for technical-interview-grade source access, contact `derek@heinrichstech.com`.\n",
  "bytes": 5616,
  "sha": "7b75c50ae503de6ccb9a601dee3b6cd85eb92181a7d67917487273235ea93115",
  "repo_slug": "drock91/bitbooth-docs",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_drock91_bitbooth_fetch_2149d59a/readme"
}