mcpField
G
goldrush-cli

goldrush-cli

github.com/covalenthqData & databases4114 installsUpdated 34w ago
Repository

About goldrush-cli

GoldRush CLI is a terminal-based blockchain data tool for developers and AI agents to query wallet, market, and trading information. It provides live data streams and MCP support for making on-chain data available to Claude.

Key features

  1. 01Query wallet balances and transfer history
  2. 02Stream real-time wallet activity
  3. 03Find new DEX trading pairs
  4. 04View OHLCV and trader data
  5. 05Check gas prices and search tokens

Use cases

  1. 01Reviewing wallet portfolios and changes
  2. 02Monitoring live on-chain wallet activity
  3. 03Discovering new DEX liquidity pairs
  4. 04Providing Claude with on-chain data tools

MCP support

GoldRush CLI acts as an MCP server, registering GoldRush tools for Claude. After running `goldrush install`, agents can call the tools directly.

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/covalenthq/goldrush-agent-skills --skill goldrush-cli

After installing, type/goldrush-cliin Claude Code to confirm it loaded.

Bundled filesreferences/overview.md

Details

From the project README

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

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

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

FileWhen to read
overview.mdNeed full command reference with parameters, usage examples, or MCP setup details

Comments

Markdown supported