Cursor + GoldRush

Set up Cursor with GoldRush

1. 1Install Cursor

   Download Cursor from cursor.com and open your project.

2. 2Install GoldRush CLI

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

   npm install -g @covalenthq/goldrush-cli

3. 3Add GoldRush MCP server

   Open 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. 4Open Cursor Chat

   Use Cmd+L (Mac) or Ctrl+L (Windows) to open the AI chat panel.

5. 5Start querying onchain data

   Ask: "Use the GoldRush MCP tools to get the token balances for vitalik.eth on Ethereum"

Things to ask Cursor

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

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

Common workflows

• Build a Web3 component

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

• Add API routes

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

• Refactor to GoldRush SDK

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

• Debug blockchain queries

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

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.