> ## 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.

# CLI Overview

> GoldRush CLI is a terminal-first blockchain data tool with 17 commands, 100+ chains, real-time streaming, and native MCP support for AI agents.

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.

```bash theme={null}
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](https://modelcontextprotocol.io/).

## What It Does

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

<Columns cols={2}>
  <Card title="Portfolio & Wallets" icon="wallet">
    Check token balances across 100+ chains, view transfer history, and stream real-time wallet activity.

    <br />

    <br />

    <b>Commands: `balances`, `transfers`, `watch`</b>
  </Card>

  <Card title="Market Discovery" icon="chart-line">
    Stream new DEX liquidity pairs as they launch and view live OHLCV candlestick charts in ASCII.

    <br />

    <br />

    <b>Commands: `new_pairs`, `ohlcv_pairs`</b>
  </Card>

  <Card title="Trading Intelligence" icon="brain">
    Find top traders for any token, check real-time gas prices, and search tokens by name or address.

    <br />

    <br />

    <b>Commands: `traders`, `gas`, `search`</b>
  </Card>

  <Card title="Agent Integration" icon="robot">
    Register GoldRush as an MCP tool provider for Claude in one command. Agents call GoldRush commands natively.

    <br />

    <br />

    <b>Commands: `install`, `auth`, `config`, `status`</b>
  </Card>
</Columns>

## MCP: Built for Agents

GoldRush CLI is an [MCP server](https://modelcontextprotocol.io/). 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

<Card title="CLI Quickstart" icon="terminal" href="/goldrush-cli/quickstart" cta="Get started">
  Three commands to go from zero to streaming blockchain data in your terminal.
</Card>