5-Minute Quickstart
Make your first paid AI call in under five minutes. No API keys, no subscription — just a wallet with a few dollars of USDC.
A terminal, and ~$5 of USDC on Base (or Solana). Don't have USDC yet? Any Coinbase account can withdraw it directly to Base — Step 2 shows the address.
Pick your surface
Set up and make your first call
A non-custodial wallet is created on first run. In Claude Code, just ask for your wallet; with the Python SDK, call setup_agent_wallet() once.
blockrun_wallet action:"setup"
from blockrun_llm import setup_agent_wallet
client = setup_agent_wallet() # creates the wallet if missing, prints the address + QR
This prints your address and opens a funding QR code. The private key is stored locally at ~/.blockrun/.session (mode 0600) and never leaves your machine — the MCP and both SDKs read the same file, so one funded wallet serves all of them.
Send $5 USDC on Base to the address from Step 1 — withdraw from Coinbase (pick the Base network) or bridge via bridge.base.org.
Prefer Solana? Run blockrun_wallet action:"chain" chain:"solana" then action:"setup" for a Solana funding address — see Wallet Setup.
Ask your assistant — or call the SDK — and the payment settles automatically.
Use blockrun_chat to ask gpt-5.5: write a haiku about micropayments
from blockrun_llm import LLMClient
client = LLMClient()
print(client.chat("openai/gpt-5.5", "Write a haiku about micropayments."))
Confirm the charge — each call costs a fraction of a cent.
blockrun_wallet action:"status"
print(client.get_balance()) # USDC on Base
print(client.get_spending()) # {"total_usd": ..., "calls": ...} for this session
If a call returns 402 Payment Required after retrying, your wallet is empty or on the wrong chain. Run blockrun_wallet action:"setup" and confirm you funded the active chain. In Python, LLMClient() raising ValueError: No wallet configured means no key was found — run setup_agent_wallet() or set BLOCKRUN_WALLET_KEY. Solana users install pip install "blockrun-llm[solana]" and use SolanaLLMClient.