BlockRun BlockRun works with Claude Code and Google Antigravity. Inspect the host’s existing capabilities first. BlockRun is an optional external provider/payment integration, not evidence that native image/search tools are unavailable. Philosophy Use only an explicitly authorized wallet/account, requested capability and spending limit. Do not create/fund a wallet or make paid calls merely because this skill is loaded. You Need You Call Pricing Image generation DALL E $0.04/image Real time X data Grok + Live Search $0.025/source Second opinion GPT 5.2 $1.75/M input, $14/M output Cheaper processing DeepSeek $0.14/M input, $0.28/M output How it works: BlockRun uses x402 micropayments to route your requests to OpenAI, xAI, Google, and other providers. No API keys needed your wallet pays per token. Budget Control (Required Before Paid Calls) If the user specifies a budget (e.g., "use at most $1"), track spending and stop when budget is reached: When to Use Trigger Your Action User explicitly requests ("blockrun second opinion with GPT on...", "use grok to check...", "generate image with dall e") Execute via BlockRun User needs something you can't do (images, live X data) Suggest BlockRun, wait for confirmation You can handle the task fine Do it yourself, don't mention BlockRun Example User Prompts Users will say things like: User Says What You Do "blockrun generate an image of a sunset" Call DALL E via ImageClient "use grok to check what's trending on X" Call Grok with search=True "blockrun GPT review this code" Call GPT 5.2 via LLMClient "what's the latest news about AI agents?" Suggest Grok (you lack real time data) "generate a logo for my startup" Suggest DALL E (you can't generate images) "blockrun check my balance" Show wallet balance via get balance() "blockrun deepseek summarize this file" Call DeepSeek for cost savings Version and authorization limits All model IDs, search fields and prices below are historical examples; verify current official SDK/provider documentation and availability before calls. A pre call spending total is not a hard cap: include worst case next call cost and reserve budget for concurrent/in flight work. Stop if a safe bound is unavailable. Do not expose wallet session/private key files, sign unrelated transactions or upload private prompts without authorization. setup agent wallet() can create local wallet state, so even balance lookup must use a deliberately selected existing setup or obtain setup authorization first. Wallet & Balance Use setup agent wallet() to auto create a wallet and get a client. This shows the QR code and welcome message on first use. Initialize client (always start with this): Check balance (when user asks "show balance", "check wallet", etc.): Show QR code for funding: SDK Usage Prerequisite: Install the SDK with pip install blockrun llm Basic Chat Real time X/Twitter Search (xAI Live Search) IMPORTANT: For real time X/Twitter data, you MUST enable Live Search with search=True or search parameters . Advanced X Search with Filters Image Generation xAI Live Search Reference Live Search is xAI's real time data API. Cost: $0.025 per source (default 10 sources = ~$0.26). To reduce costs, set max search results to a lower value: Search Parameters Parameter Type Default Description mode string "auto" "off", "auto", or "on" sources array web,news,x Data sources to query return citations bool true Include source URLs from date string Start date (YYYY MM DD) to date string End date (YYYY MM DD) max search results int 10 Max sources to return (customize to control cost) Source Types X/Twitter Source: Web Source: News Source: Available Models Model Best For Pricing openai/gpt 5.2 Second opinions, code review, general $1.75/M in, $14/M out openai/gpt 5 mini Cost optimized reasoning $0.30/M in, $1.20/M out openai/o4 mini Latest efficient reasoning $1.10/M in, $4.40/M out openai/o3 Advanced reasoning, complex problems $10/M in, $40/M out xai/grok 3 Real time X/Twitter data $3/M + $0.025/source deepseek/deepseek chat Simple tasks, bulk processing $0.14/M in, $0.28/M out google/gemini 2.5 flash Very long documents, fast $0.15/M in, $0.60/M out openai/dall e 3 Photorealistic images $0.04/image google/nano banana Fast, artistic images $0.01/image M = million tokens. Actual cost depends on your prompt and response length. Cost Reference All LLM costs are per million tokens (M = 1,000,000 tokens). Model Input Output GPT 5.2 $1.75/M $14.00/M GPT 5 mini $0.30/M $1.20/M Grok 3 (no search) $3.00/M $15.00/M DeepSeek $0.14/M $0.28/M Fixed Cost Actions Grok Live Search $0.025/source (default 10 = $0.25) DALL E image $0.04/image Nano Banana image $0.01/image Typical costs: A 500 word prompt (~750 tokens) to GPT 5.2 costs ~$0.001 input. A 1000 word response (~1500 tokens) costs ~$0.02 output. Setup & Funding Wallet location: $HOME/.blockrun/.session (e.g., /Users/username/.blockrun/.session ) First time setup: 1. Wallet auto creates when setup agent wallet() is called 2. Check wallet and balance: 3. Fund wallet with $1 5 USDC on Base network Show QR code for funding (ASCII for terminal): Troubleshooting "Grok says it has no real time access" → You forgot to enable Live Search. Add search=True : Module not found → Install the SDK: pip install blockrun llm Updates Limitations Use this skill only when the task clearly matches the scope described above. Do not treat the output as a substitute for environment specific validation, testing, or expert review. Stop and ask for clarification if required inputs, permissions, safety boundaries, or success criteria are missing.