---
name: goldrush-cli-eaece05fd309
description: "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

```bash
# 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](references/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](references/overview.md) | Need full command reference with parameters, usage examples, or MCP setup details |


---
Source attribution: covalenthq
Original project: https://github.com/covalenthq/goldrush-agent-skills/blob/f5ead024b00bf58b20fc2a01ab269bb434fc66c1/goldrush-cli/SKILL.md
License: MIT
License information: https://opensource.org/license/mit
Original upstream instructions; downloaded from Dave AI.

## Upstream license notice

MIT License

Copyright (c) 2026 Covalent

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.



# Dave AI resource metadata

Creator / publisher: covalenthq
Original project: https://github.com/covalenthq/goldrush-agent-skills/blob/f5ead024b00bf58b20fc2a01ab269bb434fc66c1/goldrush-cli/SKILL.md
Attribution basis: Source repository record

Fields of work: Data & Analytics, Development & Engineering
Roles: Backend Developer, Data Analyst, ML / AI Engineer
Specialties: API, Backend
Tools: Goldrush Cli
Country applicability: Country not specified
Classification basis: Source catalog labels
Instruction SHA-256: f35b4d968443c8e3412b82e8b7c723f20c026e3551eefeab084ba9a207335441
