GoldRush CLI

Terminal-first blockchain data tool with MCP support for AI agents. Query wallets, stream DEX pairs, and pipe live on-chain data directly into Claude — all from the command line.

Quick Start

# Install and authenticate
npx @covalenthq/goldrush-cli auth

# Query wallet balances
goldrush balances eth-mainnet vitalik.eth

# Stream new DEX pairs
goldrush new_pairs solana-mainnet raydium

# Set up MCP for Claude
goldrush install

Commands

Commands span portfolio management, market discovery, trading intelligence, and utilities. For the full reference with all parameters and examples, see overview.md.

Portfolio & Wallets

• goldrush balances <chain> <address> — full token portfolio with USD values and 24h changes
• goldrush transfers <address> <chain> — transfer history for any wallet
• goldrush watch <address> <chain> — real-time wallet activity streaming

Market Discovery

• goldrush new_pairs <chain> [protocols...] — live stream of new DEX liquidity pairs
• goldrush ohlcv_pairs <pair> <chain> [-i interval] — live OHLCV candlestick charts in ASCII

Trading Intelligence

• goldrush traders <token> <chain> — top traders ranked by unrealized PnL
• goldrush gas [chain] — real-time gas price estimates
• goldrush search <query> — find tokens by name, symbol, or address

Utilities

• goldrush chains — list supported chains
• goldrush auth — set API key (stored in OS keychain)
• goldrush install — configure Claude for MCP integration
• goldrush config — view/update settings
• goldrush status — check API key and connectivity
• goldrush logout — clear session data

Critical Rules

1. Chain names use kebab-case — eth-mainnet, solana-mainnet (same as Foundational API)
2. Authentication — API key stored in OS keychain via goldrush auth, not environment variables
3. MCP requires setup — run goldrush install before Claude can use GoldRush tools
4. Streaming commands — new_pairs, ohlcv_pairs, and watch use the Streaming API under the hood
5. Output is formatted tables — designed for human-readable terminal output; pipe into Claude for AI processing

MCP Integration

The CLI is an MCP server. Running goldrush install registers GoldRush as a tool provider for Claude. Agents can then call GoldRush commands natively — no wrappers or manual configuration needed.

Reference Files

File	When to read
overview.md	Need full command reference with parameters, usage examples, or MCP setup details