Windsurf + GoldRush

Set up Windsurf with GoldRush

1. 1Install Windsurf

   Download Windsurf from windsurf.com and open your project.

2. 2Install GoldRush CLI

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

   npm install -g @covalenthq/goldrush-cli

3. 3Add GoldRush MCP server

   Open 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. 4Open Cascade

   Use Cmd+L to open Cascade and start an agentic conversation.

5. 5Build with onchain data

   Ask: "Use GoldRush to add multi-chain token balance fetching to this project"

Things to ask Windsurf

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

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

Common workflows

• Multi-file Web3 integration

  1. Start a Cascade flow describing your blockchain feature
  2. Windsurf plans the implementation across multiple files
  3. It creates SDK client, API routes, and UI components in one flow
  4. Review and accept the coordinated changes

• Add blockchain features

  1. Ask Cascade to add token balance display to your app
  2. Windsurf indexes your codebase and plans the integration
  3. It adds GoldRush SDK, creates utilities, and updates components

• Debug onchain queries

  1. Highlight failing blockchain code and ask Cascade to debug
  2. Windsurf uses MCP tools to test the query live
  3. It suggests fixes with real data context

• Migrate to GoldRush

  1. Ask Cascade to migrate your existing blockchain data layer to GoldRush
  2. It analyzes your current implementation across all files
  3. Windsurf generates a migration plan and executes multi-file changes
  4. Review the comprehensive diff and accept

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.

More agents

• Claude Code

  Anthropic's agentic coding tool that lives in your terminal and understands your codebase end-to-end.

• 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.