@covalenthq/goldrush-cli
v3.0.6
Published
Terminal-first blockchain data & algorithmic trading CLI powered by GoldRush API
Readme
@covalenthq/goldrush-cli
Terminal-first algorithmic trading CLI powered by GoldRush API. Built in TypeScript with a proxy server pattern for rich terminal UI alongside Claude MCP integration.
Quick Start
pnpm install
pnpm build
# Set up your API key
goldrush auth
# Check token balances
goldrush balances eth-mainnet 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045
# Stream new DEX pairs
goldrush new_pairs eth-mainnet
# Launch proxy server (for MCP bridge)
goldrush proxy
# Configure Claude MCP integration
goldrush installCommands
| Command | Purpose |
| -------------------------------------- | ------------------------------------ |
| goldrush | Interactive menu |
| goldrush auth | Set up API key (OS keychain) |
| goldrush balances <chain> <address> | Token balances with rich table |
| goldrush transfers <chain> <address> | Transfer history |
| goldrush new_pairs <chain> | Stream new DEX pairs |
| goldrush ohlcv <chain> | OHLCV pairs stream |
| goldrush search <query> | Token search |
| goldrush traders <chain> | Top traders |
| goldrush gas <chain> | Gas prices |
| goldrush chains | List supported chains |
| goldrush watch <chain> <address> | Watch wallet activity |
| goldrush proxy | Launch proxy server |
| goldrush mcp | MCP stdio bridge (invoked by Claude) |
| goldrush install | Configure Claude MCP integration |
| goldrush config | View/edit settings |
| goldrush status | Check connectivity |
| goldrush logout | Clear credentials |
Architecture
Claude Desktop/Code <--stdio--> MCP Bridge <--HTTP--> Proxy Server <--HTTP--> Hosted MCP Server
(goldrush mcp) (goldrush proxy) (goldrush-mcp.vercel.app)The proxy server fetches tool definitions and forwards tool calls to the hosted MCP server (configurable via GOLDRUSH_MCP_URL). The MCP bridge translates between stdio (for Claude) and HTTP (for the proxy), keeping terminal UI output separate from the MCP protocol.
Development
pnpm dev # Run with tsx
pnpm build # Build with tsup
pnpm test # Run tests
pnpm typecheck # TypeScript check