Claude Code + GoldRush
by AnthropicTerminal
IDE
Quick Start
1
Install Claude Code
npm install -g @anthropic-ai/claude-code
2
Install GoldRush CLIQuery onchain data directly from your terminal, useful for testing queries before using them in your agent.
npm install -g @covalenthq/goldrush-cli
3
Configure GoldRush MCP ServerSet your GOLDRUSH_API_KEY environment variable before running.
claude mcp add goldrush -- npx -y @covalenthq/goldrush-mcp-server
4
Launch Claude Code in your project
claude
5
Query onchain dataAsk: "Get the token balances for vitalik.eth across Ethereum, Base, and Polygon"
Example Prompts
“Get my wallet balance 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”
“Set up a monitoring script that alerts on large token transfers”
“Compare gas costs across Ethereum, Arbitrum, and Base”
“Build an API endpoint that returns NFT ownership 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 Claude to scaffold a Next.js app with GoldRush SDK
2Request multi-chain balance fetching for a given wallet
3Have Claude build a React component to display token balances
4Ask Claude to add historical portfolio chart using GoldRush data
Analyze a Wallet
1Provide a wallet address and ask for a complete analysis
2Claude fetches token balances, transaction history, and NFTs
3Request a summary of DEX activity and token transfers
4Ask Claude to export the analysis as a formatted report
Monitor DEX Activity
1Ask Claude to set up a WebSocket connection to GoldRush Streaming API
2Configure filters for new pair creation on specific DEXs
3Have Claude build alerting logic for liquidity thresholds
Debug a Smart Contract Interaction
1Provide a transaction hash and ask Claude to decode it
2Claude uses GoldRush to fetch decoded event logs
3Request analysis of state changes and internal transactions
4Ask for suggestions on fixing any identified issues
Tips for Success
Install the GoldRush MCP Server first. Claude Code will auto-discover available tools
Set GOLDRUSH_API_KEY as an environment variable to avoid passing it each time
Start with simple queries like balance checks before building complex workflows
Use Claude's /compact command to manage context in long sessions
Claude Code FAQ
Yes, Claude Code 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 @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 Claude Code 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
Codex
OpenAITerminal
Cloud
Sandboxed cloud execution environment
Autonomous task completion
Git-aware with PR creation
Parallel task execution
OpenClaw
Peter SteinbergerTerminal
Standalone
Self-improving via skill creation
Multi-platform messaging integration
Cron jobs and webhook automation
Local-first with MCP support
Cursor
CursorIDE
Inline code generation and editing
Full codebase context awareness
MCP server support via settings
Multi-file editing and refactoring
Get Started
Get started with GoldRush API in minutes. Sign up for a free API key and start building.
Support
Explore multiple support options! From FAQs for self-help to real-time interactions on Discord.
Contact Sales
Interested in our professional or enterprise plans? Contact our sales team to learn more.
© 2026 Covalent. All rights reserved.
© 2026 Covalent. All rights reserved.