Blockrun MCP

Call this tool to manage the BlockRun payment wallet and control agent spending budgets. Call this FIRST if any other blockrun_* tool returns a payment/balance error. Call this to check your current USDC balance before expensive operations. Call this to set spending limits before spawning child agents. The server holds TWO wallets — one on Base, one on Solana — but pays on ONE active chain at a time. status shows both addresses/balances and which is active. Default chain is Base. To pay on Solana (no env vars, no file editing, no restart): 1. action:"chain" chain:"solana" → provisions + activates the Solana wallet 2. action:"setup" → Solana address + funding QR (send USDC SPL on Solana) Switch back with action:"chain" chain:"base". Base-only — these ignore Solana and need Base: blockrun_music, blockrun_speech, blockrun_video, blockrun_realface, paid blockrun_price, blockrun_chat routing:"smart", and native Anthropic (claude-*). blockrun_image pays on either chain. Actions: - status (default): Both wallet addresses + USDC balances, active chain, session spending - deposit: Buy USDC with a card — mints a one-time Coinbase Onramp link and opens it in the browser (Base only; funds settle into your own wallet). Paid tools auto-open this on an out-of-funds failure; call it directly to fund up front. - setup: Get funding instructions + QR code for the ACTIVE chain (call this when balance is 0) - qr: Open QR code (active chain) in system viewer - chain + chain:"base"|"solana": Switch the active payment chain (omit chain: to just see the current one) Budget controls: - budget + budget_action:"set" + budget_amount:1.00 → Set global spend cap - budget + budget_action:"clear" → Remove global spend cap Multi-agent orchestration: - delegate + agent_id:"research" + agent_limit:2.00 → Allocate $2 to a child agent - revoke + agent_id:"research" → Remove a child agent's budget - report → See per-agent spending breakdown Usage pattern for multi-agent systems: 1. blockrun_wallet action:"delegate" agent_id:"worker-1" agent_limit:1.00 2. Pass agent_id:"worker-1" to all blockrun_chat/search/etc calls for that agent 3. blockrun_wallet action:"report" to audit spending Do NOT call this for actual AI queries — use blockrun_chat for that.

Get a second opinion from another AI model, or use a specialized model for a specific task. Notable modes: - mode:"powerful" → Claude Opus 4.8, GPT-5.6-sol, Claude Fable 5 (frontier, 1M context) - mode:"reasoning" → Claude Opus 4.8, GPT-5.6-sol, Kimi K3, Grok 4.3, deepseek-v4-pro - mode:"coding" → Claude Opus 4.8, GPT-5.3-codex, Kimi K3, Grok Build, GLM-5.2 - mode:"cheap" → deepseek-v4-pro, MiniMax M3, GLM-5, NVIDIA free - mode:"glm" → Zhipu GLM-5 / 5.2 / 5.1 / 5-Turbo (cheap, strong at coding) - mode:"free" → NVIDIA models (no cost) Pick directly: model:"moonshot/kimi-k3", model:"openai/gpt-5.6-sol", model:"anthropic/claude-opus-4.8", model:"xai/grok-4.5", model:"nvidia/deepseek-v4-flash" (free). Run blockrun_models to see all available models with pricing.

List available AI models with pricing. Use to discover models and compare costs.

Generate or edit images via BlockRun. Pays with USDC on the ACTIVE chain — Base or Solana (see blockrun_wallet) — no separate API keys needed. Actions: - generate (default): Create image from text prompt - edit: Transform an existing image using img2img Generation models (1024x1024 base price; larger sizes cost more on gpt-image-*): - openai/gpt-image-2 ($0.06–0.12) — flagship, reasoning-driven, multilingual on-image text + character consistency (default) - openai/gpt-image-1 ($0.02–0.04) — GPT native image generation - google/nano-banana ($0.05) — Gemini-family image model - google/nano-banana-2 ($0.09) — Gemini 3.1 Flash, pro-level quality at Flash speed (1024x1024 only) - google/nano-banana-pro ($0.10; $0.15 at 4096px) — up to 4K, strongest photorealism - xai/grok-imagine-image ($0.02) — stylized, fast - xai/grok-imagine-image-pro ($0.07) — higher quality Grok Imagine - zai/cogview-4 ($0.015) — cheapest, photorealistic detailed scenes - bytedance/seedream-5-pro ($0.045; $0.09 when both dimensions exceed 1024) — Seedream 5.0 Pro; cheap widescreen at 1280x720 / 2048x1024, large formats up to 2848x1600 Edit (img2img) models: openai/gpt-image-2 (default), openai/gpt-image-1, google/nano-banana, google/nano-banana-2, google/nano-banana-pro Multi-image edit: pass an array of 2–4 source images to "image" to fuse them in one render (openai/* up to 4, google/* up to 3) — e.g. a subject plus a sprite layout guide, or a reference plus a brand logo. Source images and masks accept a base64 data URI, an http(s) URL, or a local file path (auto-encoded). Inpaint mask (openai/gpt-image-* only) via "mask"; not combinable with multiple source images.

Generate music tracks via BlockRun x402 (async, client-polled). Generates a full-length ~3 minute MP3 track. Takes 1-3 minutes to complete. The tool submits the job and, for slower tracks, polls until it is ready; payment settles only when a finished track is returned — if it fails or times out, you are not charged. Models: minimax/music-2.5+ ($0.1575), minimax/music-2.5 ($0.1575) Returns a permanent BlockRun-hosted URL.

ElevenLabs voice via BlockRun x402 — speak text aloud, generate sound effects, list voices. Actions: - speak (default): text-to-speech. E.g. "speak this with the sarah voice". Price = chars/1000 × rate (min $0.001), quoted before payment. - sound_effect: cinematic sound effects from a text prompt, up to 22s ($0.0525/clip) - voices: list available voices (free) Models (speak): elevenlabs/flash-v2.5 ($0.05/1k chars, ~75ms, default), elevenlabs/turbo-v2.5 ($0.05/1k), elevenlabs/multilingual-v2 ($0.10/1k, narration), elevenlabs/v3 ($0.10/1k, most expressive) Voice aliases: sarah (default), george, laura, charlie, river, roger, callum, harry — or any raw ElevenLabs voice_id. Returns a hosted audio URL — download immediately if you need to keep the file.