OpenCode + GoldRush

Set up OpenCode with GoldRush

1. 1Install OpenCode

   curl -fsSL https://opencode.ai/install | bash

2. 2Install GoldRush CLI

   Use the CLI to validate blockchain queries before turning them into OpenCode tasks.

   npm install -g @covalenthq/goldrush-cli

3. 3Add GoldRush MCP server to your OpenCode config

   Put this in ~/.config/opencode/opencode.json or a project-level opencode.json file.

   {
     "$schema": "https://opencode.ai/config.json",
     "mcp": {
       "goldrush": {
         "type": "local",
         "command": ["npx", "-y", "@covalenthq/goldrush-mcp-server"],
         "enabled": true,
         "environment": {
           "GOLDRUSH_API_KEY": "YOUR_API_KEY"
         }
       }
     }
   }

4. 4Start OpenCode

   Use Build for implementation and switch to Plan when you want analysis without writes.

   opencode

5. 5Run your first GoldRush task

   Ask: "Use the GoldRush MCP tools to summarize token balances for vitalik.eth across Ethereum, Base, and Polygon"

Things to ask OpenCode

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

• “Use GoldRush to build a wallet portfolio dashboard in this repo”
• “Analyze recent transactions for this address and explain the wallet activity”
• “Create a reusable OpenCode command that fetches token holders for any ERC-20”
• “Debug why this GoldRush balance query is returning an empty dataset”
• “Scaffold a webhook worker that tracks large token transfers”
• “Add a typed GoldRush client and wire it into this Next.js app”
• “Compare gas costs across Ethereum, Base, and Arbitrum for the last 24 hours”
• “Generate a markdown report for this wallet's NFTs and token positions”

Common workflows

• Plan then build a portfolio feature

  1. Start in Plan mode to inspect the codebase and define the GoldRush integration points
  2. Switch to Build mode once the architecture is clear
  3. Have OpenCode create the client utility, API route, and UI components
  4. Use live GoldRush tool calls to verify response shapes before final edits

• Create reusable blockchain commands

  1. Ask OpenCode to turn a successful GoldRush workflow into a project command
  2. Store the command in your shared OpenCode config for repeatable usage
  3. Parameterize wallet addresses, chains, and token contracts
  4. Reuse the command across future sessions without rewriting prompts

• Debug an onchain integration

  1. Open the failing project in OpenCode and explain the bug
  2. Let OpenCode inspect the code and call GoldRush tools against real data
  3. Ask it to patch the implementation and rerun the relevant checks
  4. Capture the fixed behavior as a reusable workflow or prompt

• Ship a wallet analytics MVP

  1. Ask OpenCode to scaffold a minimal dashboard with GoldRush SDK support
  2. Use MCP tools to sample balances, transfers, and pricing data
  3. Have OpenCode build summary cards and portfolio views from those responses
  4. Refine the UX after it validates the data path end-to-end

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.