goldrush-mcp-server

Overview

The goldrush-mcp-server is a TypeScript implementation that provides Model Context Protocol (MCP) integration with Covalent's blockchain analytics APIs. It exposes numerous blockchain-related tools including token balances, transaction history, block information, gas prices, and portfolio analysis. The server supports multiple transport protocols (STDIO and HTTP) and can be integrated with various LLM clients like Claude Desktop, Cursor, and Windsurf. The modular architecture makes it easy to maintain and extend with additional blockchain-related functionality.

Try asking AI

After installing, here are 5 things you can ask your AI assistant:

• bitcoin_hd_wallet_balances

  Fetch balances for each active child address derived from a Bitcoin HD wallet.

  Try:Show me the balances for my Bitcoin HD walletTry:Get HD wallet balance details for xpub key
• bitcoin_non_hd_wallet_balances

  Fetch Bitcoin balance for a non-HD address.

  Try:Check the balance of my Bitcoin addressTry:Get balance for wallet 1A1zP1eP5QGefi2DMPTfTL5SLmv7DivfNa
• bitcoin_transactions

  Fetch transactions for a specific Bitcoin address with full transaction details.

  Try:Show recent transactions for my Bitcoin walletTry:List all transactions for address 1A1zP1eP5QGefi2DMPTfTL5SLmv7DivfNa
• block

  Fetch and render a single block for a block explorer.

  Try:Get details for block 15000000 on EthereumTry:Show me information about block 800000 on Bitcoin
• block_heights

  Get all the block heights within a particular date range.

  Try:Find all blocks mined between 2023-01-01 and 2023-01-31Try:Get block heights for last week on Ethereum
• erc20_token_transfers

  Get the transfer-in and transfer-out of a token along with historical prices from an address.

  Try:Show me USDT transfers for my walletTry:Get token transfer history for address 0x742d35Cc6634C0532925a3b8D5eD5B8e8e8e8e8e
• gas_prices

  Get real-time gas estimates for different transaction speeds on a specific network.

  Try:What are current gas prices on Ethereum?Try:Show me gas estimates for a token transfer
• historical_portfolio_value

  Get daily portfolio balance for an address broken down by the token.

  Try:Show my portfolio value history for the last 30 daysTry:Get daily balance breakdown for my wallet
• historical_token_balances

  Fetch historical native and fungible tokens held by an address at a given block height or date.

  Try:What tokens did my wallet hold a month ago?Try:Get token balances for wallet on block 15000000
• historical_token_prices

  Get historic prices of a token between date ranges.

  Try:Show me ETH price history for Q1 2023Try:Get historical prices for USDT between June and July 2023
• log_events_by_address

  Get all the event logs emitted from a particular contract address.

  Try:Show events from Uniswap V3 factory contractTry:Get all logs from address 0x1f9840a85d5aF5bf1D1762F925BDADdC4201F984
• log_events_by_topic

  Get all event logs of the same topic hash across all contracts within a particular chain.

  Try:Find all Transfer events on EthereumTry:Get all events with topic 0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef

Comparable tools

Installation

npm install -g @covalenthq/goldrush-mcp-server

{
    "mcpServers": {
        "goldrush": {
            "command": "npx",
            "args": ["-y", "@covalenthq/goldrush-mcp-server@latest"],
            "env": {
                "GOLDRUSH_API_KEY": "YOUR_API_KEY_HERE"
            }
        }
    }
}

FAQ

What is GoldRush API key?

An API key from Covalent's GoldRush platform (https://goldrush.dev/platform/auth/register/) is required to use the MCP server and access blockchain data.

What transport protocols does this server support?

The server supports both STDIO (recommended for MCP clients) and HTTP transports for different integration scenarios.

Compare goldrush-mcp-server with