Agents/Claude Code
Claude Code logo

Claude Code + GoldRush

by Anthropic
Terminal
Cloud
IDE
Claude Code is Anthropic's agentic coding assistant that operates directly in your terminal. It can read, edit, and reason about your entire codebase. When paired with GoldRush via the MCP Server, Claude Code can autonomously fetch onchain data, build blockchain-powered applications, and debug Web3 integrations.
GoldRush MCP ServerGoldRush DocsClaude Code Docs
Get API Key

Quick Start

1
Install Claude Code
curl -fsSL https://claude.ai/install.sh | bash
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 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 →
OpenClaw logo

OpenClaw

Peter Steinberger
Terminal
Standalone
Open-source personal AI agent with 68k+ GitHub stars that runs locally and self-improves by writing its own skills.
Self-improving via skill creation
Multi-platform messaging integration
Cron jobs and webhook automation
Local-first with MCP support
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.