gentech-blockrun

GenTech Labs — BlockRun Integration Patterns

Real-world patterns from running BlockRun MCP in production across 32 cron jobs and daily agent operations.

---

Getting Started

Initial Wallet Setup

# Set up BlockRun wallet (one-time)
blockrun_wallet(action="setup")
# → Follow the QR to fund the wallet with USDC

Budget Controls

# Set a global budget cap so spending never surprises you
blockrun_wallet(action="budget", budget_action="set", budget_amount=10.0)

# Spawn child agents with delegate budgets
blockrun_wallet(action="delegate", agent_id="researcher", agent_limit=2.0)
blockrun_wallet(action="delegate", agent_id="data-poller", agent_limit=0.50)

Check Balance

blockrun_wallet(action="status")
# → Two wallets: Base + Solana. Active chain shown. Check before expensive runs.

---

Daily Usage Patterns

Pattern 1: Regular Price Checks (FREE)

Crypto, FX and commodity quotes cost nothing — blockrun_price is free for those categories (stocks/usstock quotes are not served since 2026-09-05 — the gateway 501s before payment; only the ticker catalog works). Use them liberally. (blockrun_surf, which used to charge $0.0085 for the same quote, was removed in 0.49.0 — the gateway 410s every Surf path since 2026-09-06.)

# Single price
blockrun_price(action="price", category="crypto", symbol="BTC-USD")

# Batch of prices
blockrun_price(action="price", category="crypto", symbol="ETH-USD")
blockrun_price(action="price", category="crypto", symbol="SOL-USD")

# Free — discover available symbols
blockrun_price(action="list", category="crypto", query="sol")

Cost: $0 — crypto/FX/commodity price and list calls are both free. category:"stocks" price/history currently return 501 (equity quotes withdrawn 2026-09-05, nothing charged); its list catalog is free.

Pattern 2: Token Research Pipeline (~$0.018)

Start with the free tools, then pay only for what they cannot answer.

# 1. Free — DEX liquidity + volume (free endpoint)
blockrun_dex({ query: "SOL" })

# 2. FREE — CEX price (crypto category is free)
blockrun_price(action="price", category="crypto", symbol="SOL-USD")

# 3. $0.0060 each — Protocol TVL
blockrun_defi({ path: "protocols" })
blockrun_defi({ path: "protocol/jupiter" })

# 4. $0.0060 — Chain TVL
blockrun_defi({ path: "chains" })