Skip to content

claude-code.md

Latest commit

 

History

History
188 lines (128 loc) · 4.11 KB

claude-code.md

File metadata and controls

188 lines (128 loc) · 4.11 KB
Raw
title Claude Code Users
description Install BlockRun MCP in Claude Code, fund a wallet with USDC on Base or Solana, and give your agent 61 models, images, and live data.

Claude Code Users

Get started with BlockRun in 60 seconds. Give your Claude agent superpowers.

:::tip{title="In a hurry?"} The whole setup is three steps below — install, fund, go. No API keys, no subscription. :::

Install, fund, and go

::::steps

:::step{title="Install the MCP"}

claude mcp add blockrun -s user -- npx -y @blockrun/mcp@latest

That's it. The MCP server is now available to Claude Code. :::

:::step{title="Set up your wallet"} In Claude Code, say:

blockrun setup

Claude will:

  1. Generate a new wallet (or use an existing one)
  2. Show you your wallet address
  3. Explain how to fund it :::

:::step{title="Fund your wallet"} Send USDC to your wallet address on Base network:

  • Recommended: $5-20 for regular usage
  • Minimum: $1 to get started

Get USDC on Base:

::::

Prefer Solana?

The MCP holds a Solana wallet too. Switch with two tool calls — no env vars, no file editing, no restart:

blockrun_wallet action:"chain" chain:"solana"
blockrun_wallet action:"setup"

Then send USDC (SPL) on the Solana network (Coinbase → pick "Solana", or Phantom/Solflare/Backpack). Switch back with blockrun_wallet action:"chain" chain:"base".

:::info Image, music, speech, video, paid stock prices, smart routing, and native Anthropic (claude-*) settle on Base only. :::

What You Can Do Now

Image Generation

Generate a logo for a crypto trading bot

Claude uses nano-banana to generate images via Google's Nano Banana, OpenAI GPT Image, CogView-4, or xAI Grok Imagine. ~$0.015-0.15 per image.

Access Other AI Models

Use GPT-5 to get a second opinion on this code

Ask Grok what's trending on X right now

Claude automatically routes to 81 AI models and pays via x402.

Trading (alpha-mcp)

For trading, install the trading-specific MCP:

claude mcp add @blockrun/alpha

Then:

Analyze BTC/USDC for trading signals

See Trading Overview for full details.

Check Your Balance

blockrun balance

or

What's my BlockRun wallet balance?

Available Skills

BlockRun provides Claude Code skills that extend what Claude can do:

Skill What It Does
nano-banana Generate images via micropayments
alpha-mcp AI crypto trading with risk management

Pricing

  • Intelligence: Provider cost + 5% (no subscriptions)
  • Images: $0.015-0.15 per image
  • Trading tools: Free (open source)

$1 gets you approximately:

  • ~500 GPT-5.4 calls
  • ~10,000 DeepSeek calls
  • ~20–65 image generations

Security

  • Your private key stays on your machine (~/.blockrun/)
  • Only cryptographic signatures are sent to servers
  • All payments are verifiable on Basescan
  • You control your wallet — withdraw anytime

Troubleshooting

MCP not loading?

Restart Claude Code after installation:

# Check if MCP is registered
claude mcp list

Wallet not found?

# Check wallet location
ls ~/.blockrun/

Transaction failed?

Check your USDC balance on Base:

blockrun balance

For more help, see MCP Troubleshooting.

What's next?

::::cards

:::card{title="Browse the MCP tools" href="../mcp/blockrun-mcp.md" icon="Boxes"} The full list of 18 blockrun_* tools — chat, image, video, search, markets, RPC, and more. :::

:::card{title="Generate images" href="../products/creation/nano-banana.md" icon="Image"} Create images via micropayments with the nano-banana skill. :::

:::card{title="Explore all models" href="../products/intelligence/overview.md" icon="Brain"} 61 LLMs with live pricing, plus smart routing to cut costs automatically. :::

::::