Claude Code logo

Claude Code + GoldRush

By Anthropic. Runs in 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.

Get a free API keyGoldRush MCP ServerGoldRush DocsClaude Code Docs

Step 3: Configure GoldRush MCP server

claude mcp add goldrush -- npx -y @covalenthq/goldrush-mcp-server

Set up Claude Code with GoldRush

  1. 1Install Claude Code

    curl -fsSL https://claude.ai/install.sh | bash

  2. 2Install GoldRush CLI

    Query onchain data directly from your terminal, useful for testing queries before using them in your agent.

    npm install -g @covalenthq/goldrush-cli

  3. 3Configure GoldRush MCP server

    Set your GOLDRUSH_API_KEY environment variable before running.

    claude mcp add goldrush -- npx -y @covalenthq/goldrush-mcp-server

  4. 4Launch Claude Code in your project

    claude

  5. 5Query onchain data

    Ask: "Get the token balances for vitalik.eth across Ethereum, Base, and Polygon"

Things to ask Claude Code

Once GoldRush is connected, ask in plain words. Claude Code picks the calls.

  • “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”

Common workflows

  • Deploy a portfolio tracker

    1. Ask Claude to scaffold a Next.js app with GoldRush SDK
    2. Request multi-chain balance fetching for a given wallet
    3. Have Claude build a React component to display token balances
    4. Ask Claude to add historical portfolio chart using GoldRush data

  • Analyze a wallet

    1. Provide a wallet address and ask for a complete analysis
    2. Claude fetches token balances, transaction history, and NFTs
    3. Request a summary of DEX activity and token transfers
    4. Ask Claude to export the analysis as a formatted report

  • Debug a smart contract interaction

    1. Provide a transaction hash and ask Claude to decode it
    2. Claude uses GoldRush to fetch decoded event logs
    3. Request analysis of state changes and internal transactions
    4. Ask for suggestions on fixing any identified issues

The 37 MCP tools Claude Code can call

Each tool is a GoldRush API call or analytics query. Claude Code reads the descriptions and picks the tools a request needs.

Cross-chain

  • multichain_balances

    Fetch spot and historical balances for an address on up to 10 EVM chains.

  • multichain_transactions

    Fetch paginated transactions for up to 10 addresses and 10 chains.

  • multichain_address_activity

    Locate chains an address is active on with a single API call.

Balances

  • token_balances

    Get native and ERC20 token balances with spot prices and metadata.

  • historical_token_balances

    Get token balances at a specific block height or date.

  • historical_portfolio_value

    Get daily portfolio balance broken down by token.

  • erc20_token_transfers

    Get transfer-in and transfer-out events with historical prices.

  • token_holders

    Get paginated current or historical holders of a token.

  • native_token_balance

    Get native token balance with current market value.

Transactions

  • transaction

    Fetch a single transaction with decoded log events.

  • transaction_summary

    Get earliest/latest transactions and count for a wallet.

  • transactions_for_address

    Get paginated transactions with decoded logs for an address.

  • transactions_for_block

    Get all transactions in a block with decoded events.

Bitcoin

  • bitcoin_hd_wallet_balances

    Get balances for child addresses from an HD wallet xpub key.

  • bitcoin_transactions

    Get full transaction history for a Bitcoin wallet.

  • bitcoin_non_hd_wallet_balances

    Get balance for a non-HD Bitcoin address.

NFTs

  • nft_for_address

    Get ERC721 and ERC1155 NFTs held by an address.

  • nft_check_ownership

    Verify NFT ownership within a collection.

  • nft_check_ownership_token_id

    Verify ownership of a specific NFT by token ID.

Pricing

  • historical_token_prices

    Get historical prices for ERC20 and native tokens.

  • pool_spot_prices

    Get spot prices for a Uniswap V2/V3 pool.

Security

  • token_approvals

    Get token approvals categorized by spender with risk levels.

Utility

  • gas_prices

    Get real-time gas estimates for low, medium, and high speeds.

  • block

    Fetch a single block with timestamp, tx count, and miner info.

  • block_heights

    Get block heights within a date range.

  • log_events_by_address

    Get event logs emitted from a contract address.

  • log_events_by_topic

    Get event logs by topic hash across all contracts.

  • resolve_address

    Resolve an ENS, RNS or Unstoppable Domains name to an address.

Protocol analytics

  • list_entities

    List every dataset with live analytics, with its metrics and dimensions.

  • search_catalog

    Find a dataset, metric, dimension or ticker before querying it.

  • get_metadata

    Read what a dataset's metrics measure, how they split and what they can't answer.

  • get_metric

    Get one metric of a dataset as a daily, weekly or monthly series.

  • get_metrics

    Get several metrics of one dataset in a single call.

  • get_breakdown

    Split a metric by a dimension such as chain, asset or market.

  • list_members

    List the values a dimension holds, ranked, to filter on one of them.

  • compare_entities

    Compare two to ten named datasets on one metric.

  • rank_entities

    Rank every dataset that serves a metric.

GoldRush Agent Skills

Agent Skills give your agent the context it needs for every GoldRush endpoint: parameters, response shapes and credit costs. One command installs all of them.

Agent Skills docsEvery skill on GitHub
npx skills add covalenthq/goldrush-agent-skills

  • Foundational API

    REST endpoints for historical blockchain data. Balances, transactions, NFTs, token prices, security checks, cross-chain queries across 100+ networks.

  • x402

    Pay-per-request access without API keys. Agents pay with stablecoins using the HTTP 402 protocol. No accounts, no rate limits, no key management.

  • CLI

    Terminal-first blockchain data with native MCP support. 17 commands that work for both humans and AI agents.

Tips

  • 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

Troubleshooting

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

More agents

  • Codex

    OpenAI's cloud-native coding agent that runs tasks in a sandboxed environment with full autonomy.

  • Gemini CLI

    Google's open-source terminal AI agent powered by Gemini models with built-in MCP support and a file-based skill system.

  • OpenCode

    Open-source AI coding agent with a terminal-first UI, configurable agents, and MCP-native tool access.

See every agent

Claude Code and GoldRush 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.