BlockRunBlockRun

Installing agent-wallet

Claude Code (Recommended)

Method 1: Direct Install

claude mcp add @blockrun/agent-wallet

Method 2: Via npx

npx @anthropic-ai/claude-code install @blockrun/agent-wallet

Method 3: Manual Configuration

Add to your Claude Code settings (~/.claude/settings.json):

{
  "mcpServers": {
    "blockrun": {
      "command": "npx",
      "args": ["@blockrun/agent-wallet"]
    }
  }
}

Verify Installation

Restart Claude Code, then:

claude mcp list

You should see blockrun or @blockrun/agent-wallet in the list.

Setup Wallet

agent-wallet needs a funded wallet for:

  • Sentiment analysis queries (paid via x402)
  • Trade execution (USDC for swaps)
# In Claude Code
blockrun setup

Then fund with USDC on Base. See Wallet Setup.

Configuration

agent-wallet uses environment variables for configuration:

# Optional: Custom RPC endpoint
export BASE_RPC_URL=https://mainnet.base.org

# Optional: Custom wallet location
export BLOCKRUN_WALLET_PATH=~/.blockrun/trading-wallet.json

Test It Works

In Claude Code:

What's the current RSI for ETH?

Claude should call alpha_signal and return technical indicators.

Requirements

  • Claude Code CLI
  • Node.js 18+
  • Funded wallet on Base (for paid features)

Troubleshooting

"MCP not found"

Restart Claude Code after installation:

# Kill any running instances
pkill -f "claude"

# Start fresh
claude

"Wallet not configured"

Run wallet setup:

blockrun setup

"Permission denied"

Check npm permissions:

npm config set prefix ~/.npm-global
export PATH=~/.npm-global/bin:$PATH

"Network error"

Verify Base RPC is accessible:

curl https://mainnet.base.org \
  -X POST \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","method":"eth_blockNumber","params":[],"id":1}'

Next Steps