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

> Get started with GoldRush CLI in three commands. Query wallets, stream DEX pairs, and set up MCP for AI agents.

## Prerequisites

Using GoldRush CLI requires an API key.

<CardGroup cols={2}>
  <Card icon="wand-magic-sparkles" title="Vibe Coders" href="https://goldrush.dev/platform/auth/register/?plan=vibe">
    \$10/mo - Built for solo builders and AI-native workflows.
  </Card>

  <Card icon="users" title="Teams" href="https://goldrush.dev/platform/auth/register/?plan=professional">
    \$250/mo - Production-grade with 50 RPS and priority support.
  </Card>
</CardGroup>

## Install and Authenticate

Run the CLI with `npx` - no global install needed:

```bash theme={null}
npx @covalenthq/goldrush-cli auth
```

This prompts you for your API key and stores it securely in your OS keychain (not a config file).

<Note>
  After the first run, you can use `goldrush` directly without `npx`.
</Note>

## Query Wallet Balances

Get a full token portfolio for any address across 100+ chains:

```bash theme={null}
goldrush balances aave.eth eth-mainnet
```

This returns ERC20s, native tokens, NFTs, USD values, and 24h changes in a formatted table.

## Stream New DEX Pairs

Watch new liquidity pairs launch in real time:

```bash theme={null}
goldrush new_pairs solana-mainnet raydium
```

Filter by protocol, navigate with arrow keys, and copy addresses to clipboard. Supports 35+ protocol integrations across 9 chains.

## Set Up MCP for AI Agents

Register GoldRush as a native tool provider for Claude:

```bash theme={null}
goldrush install
```

That's it. Claude can now call GoldRush commands directly - no wrappers or manual JSON configuration needed. This works with both Claude Desktop and Claude Code.

<Note>
  For manual MCP configuration (Cursor, Windsurf, or custom setups), see the [MCP Server docs](/goldrush-mcp-server).
</Note>

## What's Next

<CardGroup cols={2}>
  <Card title="Command Reference" icon="rectangle-list" href="/goldrush-cli/commands" cta="View all commands">
    Full reference for all 17 CLI commands with usage examples.
  </Card>

  <Card title="Streaming API" icon="https://mintcdn.com/goldrush/HCWRKGncxpy71D8p/images/icons/streaming.svg?fit=max&auto=format&n=HCWRKGncxpy71D8p&q=85&s=c4a22e003bde989c0cd2d01a67bd6adf" href="/goldrush-streaming-api" cta="Learn more" width="24" height="24" data-path="images/icons/streaming.svg">
    The real-time data layer that powers `new_pairs`, `ohlcv_pairs`, and `watch`.
  </Card>
</CardGroup>