BitBooth Agent Tools MCP Server
by drock91io.github.Drock91/bitbooth-fetchv2.3.1
Discover BitBooth APIs for free, then buy capped x402 fetch, PageDelta, and watch tools over Base USDC or XRPL mainnet RLUSD.
context tax
queued
security
queued
cold start
queued
freshness
Active24d ago
Install BitBooth Agent Tools MCP server
Install in Claude Code
claude mcp add fetch -e BITBOOTH_AGENT_KEY='<bitbooth-agent-key>' -e BITBOOTH_XRPL_SEED='<bitbooth-xrpl-seed>' -- npx -y @bitbooth/mcp-fetchInstall in Cursor
{
"mcpServers": {
"fetch": {
"command": "npx",
"args": [
"-y",
"@bitbooth/mcp-fetch"
],
"env": {
"BITBOOTH_AGENT_KEY": "<bitbooth-agent-key>",
"BITBOOTH_XRPL_SEED": "<bitbooth-xrpl-seed>"
}
}
}
}Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).
Install in Claude Desktop
{
"mcpServers": {
"fetch": {
"command": "npx",
"args": [
"-y",
"@bitbooth/mcp-fetch"
],
"env": {
"BITBOOTH_AGENT_KEY": "<bitbooth-agent-key>",
"BITBOOTH_XRPL_SEED": "<bitbooth-xrpl-seed>"
}
}
}
}Settings → Developer → Edit Config (claude_desktop_config.json), then restart.
Install in VS Code
{
"servers": {
"fetch": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@bitbooth/mcp-fetch"
],
"env": {
"BITBOOTH_AGENT_KEY": "<bitbooth-agent-key>",
"BITBOOTH_XRPL_SEED": "<bitbooth-xrpl-seed>"
}
}
}
}Add to .vscode/mcp.json in your workspace.
Install in Windsurf
{
"mcpServers": {
"fetch": {
"command": "npx",
"args": [
"-y",
"@bitbooth/mcp-fetch"
],
"env": {
"BITBOOTH_AGENT_KEY": "<bitbooth-agent-key>",
"BITBOOTH_XRPL_SEED": "<bitbooth-xrpl-seed>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json.
Configuration
| Variable | Required | Secret | Description |
|---|---|---|---|
| BITBOOTH_AGENT_KEY | — | yes | 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 | — | yes | 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. |
Freshness
Active — last maintenance signal 24d ago. The newest of the signals below sets the band.
Last commit (default branch)
2026-09-16 · 24d ago · GitHub
Latest release
no data · GitHub
Package published
no data · npm/PyPI
Registry entry updated
2026-09-12 · 28d ago · official registry · v2.3.1
FAQ
›How do I install the BitBooth Agent Tools MCP server in Claude Code?
Run: claude mcp add fetch -e BITBOOTH_AGENT_KEY='<bitbooth-agent-key>' -e BITBOOTH_XRPL_SEED='<bitbooth-xrpl-seed>' -- npx -y @bitbooth/mcp-fetch. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.
›Does BitBooth Agent Tools require an API key?
Yes. It expects BITBOOTH_AGENT_KEY, BITBOOTH_XRPL_SEED, of which 2 are secrets.
›Can I use BitBooth Agent Tools as a remote (hosted) MCP server?
No hosted endpoint is published; it runs locally over stdio.
›Is BitBooth Agent Tools in the official MCP registry?
Yes, as io.github.Drock91/bitbooth-fetch.