Skip to main content

Documentation Index

Fetch the complete documentation index at: https://goldrush.dev/docs/llms.txt

Use this file to discover all available pages before exploring further.

GoldRush CLI is a terminal-first tool for blockchain data. 17 commands, 100+ chains, real-time streaming, and native MCP support for AI agents. One install, and you’ve got live onchain data in your terminal or piped directly into Claude. 
npx @covalenthq/goldrush-cli

​
Two Modes, Same Data

GoldRush CLI serves both humans and AI agents from a single tool:
  • Humans get a rich terminal experience with live charts, interactive tables, and formatted output.
  • Agents get MCP tools with structured, streaming data via the Model Context Protocol.

​
What It Does

Seventeen commands across portfolio management, market discovery, trading intelligence, and agent integration.

Portfolio & Wallets

Check token balances across 100+ chains, view transfer history, and stream real-time wallet activity.

Commands: balances, transfers, watch

Market Discovery

Stream new DEX liquidity pairs as they launch and view live OHLCV candlestick charts in ASCII.

Commands: new_pairs, ohlcv_pairs

Trading Intelligence

Find top traders for any token, check real-time gas prices, and search tokens by name or address.

Commands: traders, gas, search

Agent Integration

Register GoldRush as an MCP tool provider for Claude in one command. Agents call GoldRush commands natively.

Commands: install, auth, config, status

​
MCP: Built for Agents

GoldRush CLI is an MCP server. When you run goldrush install, it registers GoldRush as a tool provider for Claude. The agent can then call GoldRush commands the same way it calls any other tool - no wrappers, no glue code. Three core loops define how agents use blockchain data:
  1. Continuous Market Monitoring - An agent subscribes to new_pairs and receives every new liquidity pair in real time. It evaluates, filters, scores, and decides whether to act.
  2. Wallet Surveillance - An agent watches specific wallets using watch. Whale wallets, smart money, protocol treasuries. Every swap, transfer, and deposit surfaces in real time.
  3. Portfolio Intelligence - An agent pulls balances on a schedule, analyzes composition across chains, evaluates concentration risk, and recommends rebalancing.
These aren’t one-shot queries - they’re persistent loops. Subscribe, process, act, repeat.

​
Get Started

CLI Quickstart

Three commands to go from zero to streaming blockchain data in your terminal.