SKILL

GoldRush CLI - terminal-first blockchain data tool with MCP support for Claude Desktop and Claude Code. Use this skill whenever the user wants to query blockchain data from the command line, stream DEX pairs or wallet activity in a terminal, set up GoldRush as an MCP tool provider, or run quick one-off queries without writing code (e.g., ‘check a wallet balance’, ‘what’s the gas price’, ‘search for a token’). Also use this when the user mentions ‘goldrush’ CLI commands, ‘npx @covalenthq/goldrush-cli’, or MCP integration with GoldRush. The CLI is the fastest path for ad-hoc blockchain lookups from the terminal. If the user needs programmatic API access in an application, use goldrush-foundational-api or goldrush-streaming-api instead. If the user needs pay-per-request access without an API key, use goldrush-x402 instead.

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

Chain names use kebab-case - eth-mainnet, solana-mainnet (same as Foundational API)
Authentication - API key stored in OS keychain via goldrush auth, not environment variables
MCP requires setup - run goldrush install before Claude can use GoldRush tools
Streaming commands - new_pairs, ohlcv_pairs, and watch use the Streaming API under the hood
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

​GoldRush CLI

​Quick Start

​Commands

​Portfolio & Wallets

​Market Discovery

​Trading Intelligence

​Utilities

​Critical Rules

​MCP Integration

​Reference Files