Windsurf + GoldRush
by CodeiumIDE
Quick Start
1
Install WindsurfDownload Windsurf from windsurf.com and open your project.
2
Install GoldRush CLIQuery onchain data directly from your terminal, useful for testing queries before using them in Windsurf.
npm install -g @covalenthq/goldrush-cli
3
Add GoldRush MCP ServerOpen Windsurf Settings > MCP and add the GoldRush server configuration.
{
"mcpServers": {
"goldrush": {
"command": "npx",
"args": ["-y", "@covalenthq/goldrush-mcp-server"],
"env": { "GOLDRUSH_API_KEY": "YOUR_API_KEY" }
}
}
}4
Open CascadeUse Cmd+L to open Cascade and start an agentic conversation.
5
Build with onchain dataAsk: "Use GoldRush to add multi-chain token balance fetching to this project"
Example Prompts
“Fetch token balances for this wallet using GoldRush”
“Add a multi-chain portfolio tracker to this Next.js app”
“Create API routes for GoldRush transaction data”
“Build a component that displays NFT holdings”
“Set up the GoldRush SDK with proper TypeScript types”
“Add real-time price feeds using GoldRush pricing API”
“Create a wallet analytics page with GoldRush data”
“Refactor this code to use GoldRush instead of raw RPC calls”
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
Multi-File Web3 Integration
1Start a Cascade flow describing your blockchain feature
2Windsurf plans the implementation across multiple files
3It creates SDK client, API routes, and UI components in one flow
4Review and accept the coordinated changes
Add Blockchain Features
1Ask Cascade to add token balance display to your app
2Windsurf indexes your codebase and plans the integration
3It adds GoldRush SDK, creates utilities, and updates components
Debug Onchain Queries
1Highlight failing blockchain code and ask Cascade to debug
2Windsurf uses MCP tools to test the query live
3It suggests fixes with real data context
Migrate to GoldRush
1Ask Cascade to migrate your existing blockchain data layer to GoldRush
2It analyzes your current implementation across all files
3Windsurf generates a migration plan and executes multi-file changes
4Review the comprehensive diff and accept
Tips for Success
Cascade excels at multi-file changes. Ask for complete feature implementations
Use @file to reference specific files when asking about GoldRush integration
Let Windsurf index your project fully before starting complex blockchain tasks
Cascade can chain MCP tool calls for complex data queries
Windsurf FAQ
Cascade can call GoldRush MCP tools during its multi-step planning. It uses live data to validate approaches, test queries, and generate code with real response structures.
Troubleshooting
MCP Server not connecting in WindsurfCheck the MCP panel in Windsurf settings. Ensure npx is accessible from Windsurf's terminal. Try running the MCP server command manually to verify.
Cascade not using GoldRush toolsExplicitly ask Cascade to 'use the GoldRush MCP tools' in your prompt. If issues persist, check that the server status shows green in MCP settings.
Large project indexing taking too longAdd node_modules and build directories to .windsurfignore. This speeds up indexing so Cascade can focus on your application code.
Explore More Agents
Claude Code
AnthropicTerminal
IDE
Full codebase understanding and editing
MCP server integration for live data
Autonomous multi-step task execution
Terminal-native workflow
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
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.