Agents/Cursor
Cursor logo

Cursor + GoldRush

by Cursor
IDE
Cursor is an AI-native code editor built on VS Code that deeply understands your codebase. With MCP Server integration, Cursor can query live blockchain data while you code, generate GoldRush API integrations inline, and help you build Web3 applications with real-time data context.

Quick Start

1
Install CursorDownload Cursor from cursor.com and open your project.
2
Install GoldRush CLIQuery onchain data directly from your terminal, useful for testing queries before using them in Cursor.
npm install -g @covalenthq/goldrush-cli
3
Add GoldRush MCP ServerOpen Cursor Settings > MCP and add a new server with the configuration below.
{
  "mcpServers": {
    "goldrush": {
      "command": "npx",
      "args": ["-y", "@covalenthq/goldrush-mcp-server"],
      "env": { "GOLDRUSH_API_KEY": "YOUR_API_KEY" }
    }
  }
}
4
Open Cursor ChatUse Cmd+L (Mac) or Ctrl+L (Windows) to open the AI chat panel.
5
Start querying onchain dataAsk: "Use the GoldRush MCP tools to get the token balances for vitalik.eth on Ethereum"

Example Prompts

Get the ETH balance for this wallet address
Show me the recent transactions for 0xd8dA... on Base
Generate a GoldRush SDK client with balance and transaction methods
Add a route that returns NFT holdings for a wallet
Create a React hook that fetches token prices from GoldRush
Build a TypeScript utility for multi-chain balance aggregation
Add error handling to this GoldRush API call
Refactor this component to use the GoldRush SDK instead of raw fetch

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

Build a Web3 Component

1Open a React component file and invoke Cursor Chat
2Ask Cursor to add GoldRush balance fetching with the MCP tools
3Cursor generates the component with live data integration
4Use Tab to accept inline suggestions and iterate

Add API Routes

1Ask Cursor to create Next.js API routes for GoldRush data
2It generates routes for balances, transactions, and pricing
3Review and accept the multi-file changes

Refactor to GoldRush SDK

1Select existing blockchain data fetching code
2Ask Cursor to refactor it to use the GoldRush SDK
3It rewrites the code with proper typing and error handling
4Accept the changes across multiple files

Debug Blockchain Queries

1Highlight a failing GoldRush API call
2Ask Cursor to debug using the MCP tools to test the query
3Cursor identifies the issue and suggests a fix inline

Tips for Success

Enable the GoldRush MCP Server in Cursor Settings for live data access in chat
Use @codebase to give Cursor full context of your Web3 project
Cursor's Composer mode (Cmd+I) is great for multi-file GoldRush integrations
Pin GoldRush documentation files for better inline suggestions

Cursor FAQ

Go to Cursor Settings > MCP, click 'Add Server', and paste the GoldRush MCP configuration. Cursor will automatically connect when you start a chat.

Troubleshooting

MCP Server not appearing in CursorRestart Cursor after adding the MCP configuration. Check the MCP panel in settings to verify the server status shows as 'Connected'.
Cursor not using GoldRush toolsExplicitly mention 'use the GoldRush MCP tools' in your prompt. Cursor may need a direct reference to prefer MCP tools over web search.
Slow responses when using MCPMCP tool calls add latency as they make live API requests. For faster iteration, ask Cursor to generate code with the SDK instead of making live calls.

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.