Agents/Gemini CLI
Gemini CLI logo

Gemini CLI + GoldRush

by Google
Terminal
Gemini CLI is Google's open-source agentic coding tool that runs in your terminal. Powered by Gemini models, it can read and edit files, run shell commands, and search the web. With native MCP support and a file-based skill system, Gemini CLI integrates with GoldRush to give you autonomous blockchain data access directly from the command line. Configure the MCP Server once and Gemini CLI can fetch balances, transactions, and token data across 100+ chains.
GoldRush MCP ServerGoldRush DocsGemini CLI GitHub
Get API Key

Quick Start

1
Install Gemini CLIRequires Node.js 18+. Authenticate with your Google account on first run.
npm install -g @google/gemini-cli
2
Install GoldRush CLIQuery onchain data directly from your terminal, useful for testing queries before using them in Gemini CLI.
npm install -g @covalenthq/goldrush-cli
3
Add GoldRush MCP ServerSet your GOLDRUSH_API_KEY environment variable before running. You can also add it manually to ~/.gemini/settings.json.
gemini mcp add goldrush -- npx -y @covalenthq/goldrush-mcp-server
4
Launch Gemini CLI in your project
gemini
5
Query onchain dataAsk: "Use the GoldRush MCP tools to get token balances for vitalik.eth on Ethereum, Base, and Polygon"

Example Prompts

“Get the token balances for this wallet on Ethereum”
“Show me the top 10 token holders for USDC on Base”
“Track all transactions for this address in the last 24 hours”
“Build a portfolio dashboard showing balances across 5 chains”
“Analyze DEX trading volume on Uniswap v3 for the past week”
“Create a GoldRush skill that monitors large token transfers”
“Compare gas costs across Ethereum, Arbitrum, and Base”
“Write a script that exports NFT ownership data for any wallet”

Available MCP Tools (27)

Cross-Chain

multichain_balancesFetch spot and historical balances for an address on up to 10 EVM chains.
multichain_transactionsFetch paginated transactions for up to 10 addresses and 10 chains.
multichain_address_activityLocate chains an address is active on with a single API call.

Balances

token_balancesGet native and ERC20 token balances with spot prices and metadata.
historical_token_balancesGet token balances at a specific block height or date.
historical_portfolio_valueGet daily portfolio balance broken down by token.
erc20_token_transfersGet transfer-in and transfer-out events with historical prices.
token_holdersGet paginated current or historical holders of a token.
native_token_balanceGet native token balance with current market value.

Transactions

transactionFetch a single transaction with decoded log events.
transaction_summaryGet earliest/latest transactions and count for a wallet.
transactions_for_addressGet paginated transactions with decoded logs for an address.
transactions_for_blockGet all transactions in a block with decoded events.

Bitcoin

bitcoin_hd_wallet_balancesGet balances for child addresses from an HD wallet xpub key.
bitcoin_transactionsGet full transaction history for a Bitcoin wallet.
bitcoin_non_hd_wallet_balancesGet balance for a non-HD Bitcoin address.

NFTs

nft_for_addressGet ERC721 and ERC1155 NFTs held by an address.
nft_check_ownershipVerify NFT ownership within a collection.
nft_check_ownership_token_idVerify ownership of a specific NFT by token ID.

Pricing

historical_token_pricesGet historical prices for ERC20 and native tokens.
pool_spot_pricesGet spot prices for a Uniswap V2/V3 pool.

Security

token_approvalsGet token approvals categorized by spender with risk levels.

Utility

gas_pricesGet real-time gas estimates for low, medium, and high speeds.
blockFetch a single block with timestamp, tx count, and miner info.
block_heightsGet block heights within a date range.
log_events_by_addressGet event logs emitted from a contract address.
log_events_by_topicGet event logs by topic hash across all contracts.

GoldRush Agent Skills

GoldRush Agent Skills give AI agents structured context for every endpoint, parameter, and credit cost. View all skills on GitHub →
Install GoldRush Skills
npx skills add covalenthq/goldrush-agent-skills
Available skills
Foundational APIREST endpoints for historical blockchain data. Balances, transactions, NFTs, token prices, security checks, cross-chain queries across 100+ networks.
Streaming APIReal-time GraphQL subscriptions. OHLCV candles, new DEX pairs, wallet activity monitoring, token search, and PnL queries via WebSocket.
x402Pay-per-request access without API keys. Agents pay with stablecoins using the HTTP 402 protocol. No accounts, no rate limits, no key management.
CLITerminal-first blockchain data with native MCP support. 17 commands that work for both humans and AI agents.

Common Workflows

Deploy a Portfolio Tracker

1Ask Gemini CLI to scaffold a project with GoldRush SDK integration
2Request multi-chain balance fetching for a given wallet
3Have Gemini CLI build display components using the fetched data
4Ask it to add historical portfolio charting with GoldRush pricing data

Analyze a Wallet

1Provide a wallet address and ask for a comprehensive analysis
2Gemini CLI fetches token balances, transaction history, and NFTs via MCP
3Request a summary of DEX activity and token transfer patterns
4Ask Gemini CLI to export the analysis as a formatted markdown report

Create a Reusable GoldRush Skill

1Ask Gemini CLI to build a blockchain query workflow end-to-end
2Save the working approach as a skill in .gemini/skills/
3Reuse the skill in future sessions without rewriting the prompt
4Share the skill with teammates by committing .gemini/ to the repo

Debug a Smart Contract Interaction

1Provide a transaction hash and ask Gemini CLI to decode it
2It uses GoldRush MCP tools to fetch decoded event logs
3Request analysis of state changes and token transfers
4Ask for suggestions on fixing any identified issues

Tips for Success

Use gemini mcp add for quick server setup instead of editing settings.json manually
Set GOLDRUSH_API_KEY as an environment variable to avoid passing it each time
Save successful blockchain workflows as skills in .gemini/skills/ for reuse
Use the /compact command to manage context in long sessions

Gemini CLI FAQ

Yes, Gemini CLI calls the GoldRush API through the MCP Server, which requires an internet connection. The MCP Server runs locally and handles all API communication.

Troubleshooting

MCP Server not connectingEnsure Node.js 18+ is installed. Run npx -y @covalenthq/goldrush-mcp-server manually to check for errors. Verify your GOLDRUSH_API_KEY is set correctly.
API key not recognizedCheck that GOLDRUSH_API_KEY is exported in your shell profile (~/.bashrc or ~/.zshrc). Restart Gemini CLI after setting environment variables.
Rate limiting errorsThe free tier allows 4 requests/second. Add delays between rapid queries, or upgrade your plan at goldrush.dev/pricing for higher limits.

Explore More Agents

Claude Code logo

Claude Code

Anthropic
Terminal
Cloud
IDE
Anthropic's agentic coding tool that lives in your terminal and understands your codebase end-to-end.
Full codebase understanding and editing
MCP server integration for live data
Autonomous multi-step task execution
Terminal-native workflow
Use with GoldRush →
Codex logo

Codex

OpenAI
Terminal
Cloud
IDE
OpenAI's cloud-native coding agent that runs tasks in a sandboxed environment with full autonomy.
Sandboxed cloud execution environment
Autonomous task completion
Git-aware with PR creation
Parallel task execution
Use with GoldRush →
OpenCode logo

OpenCode

OpenCode
Terminal
IDE
Extension
Open-source AI coding agent with a terminal-first UI, configurable agents, and MCP-native tool access.
Build and Plan agents for controlled execution
Config-based MCP integration
Project-scoped agents and commands
Terminal-first workflow with IDE options
Use with GoldRush →

Get Started

Get started with GoldRush API in minutes. Sign up for a free API key and start building.
Get API Key

Support

Explore multiple support options! From FAQs for self-help to real-time interactions on Discord.
Explore Support

Contact Sales

Interested in our professional or enterprise plans? Contact our sales team to learn more.
Contact Sales
Powered by Covalent
© 2026 Covalent. All rights reserved.
Get API KeyPlatformAgentsLoginDocsGitHub
BlogGuidesCase StudiesSupportTeamCareers
XDiscordLinkedInYoutube
Privacy PolicyTerms of UseCookie Policy
Powered by Covalent
© 2026 Covalent. All rights reserved.