# Goldrush Cli

> 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 f…

- **Type:** Skill
- **Install:** `agentstack add skill-covalenthq-goldrush-agent-skills-goldrush-cli`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [covalenthq](https://agentstack.voostack.com/s/covalenthq)
- **Installs:** 0
- **Category:** [Search](https://agentstack.voostack.com/c/search)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [covalenthq](https://github.com/covalenthq)
- **Source:** https://github.com/covalenthq/goldrush-agent-skills/tree/main/goldrush-cli

## Install

```sh
agentstack add skill-covalenthq-goldrush-agent-skills-goldrush-cli
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# 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  ` — full token portfolio with USD values and 24h changes
- `goldrush transfers  ` — transfer history for any wallet
- `goldrush watch  ` — real-time wallet activity streaming

### Market Discovery
- `goldrush new_pairs  [protocols...]` — live stream of new DEX liquidity pairs
- `goldrush ohlcv_pairs   [-i interval]` — live OHLCV candlestick charts in ASCII

### Trading Intelligence
- `goldrush traders  ` — top traders ranked by unrealized PnL
- `goldrush gas [chain]` — real-time gas price estimates
- `goldrush search ` — 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 & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [covalenthq](https://github.com/covalenthq)
- **Source:** [covalenthq/goldrush-agent-skills](https://github.com/covalenthq/goldrush-agent-skills)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-covalenthq-goldrush-agent-skills-goldrush-cli
- Seller: https://agentstack.voostack.com/s/covalenthq
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.