Agents/OpenCode

OpenCode + GoldRush

by OpenCode

Terminal

IDE

Extension

OpenCode is an open-source AI coding agent with a fast terminal UI, desktop app, and editor integrations. Its Build and Plan agents make it easy to switch between read-only analysis and full implementation. With GoldRush configured as an MCP server, OpenCode can inspect live onchain data, generate Web3 features, and turn recurring blockchain tasks into reusable commands or project-level agents.

GoldRush MCP Server GoldRush Docs OpenCode Docs

Get API Key

Quick Start

Install OpenCode

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

Install GoldRush CLIUse the CLI to validate blockchain queries before turning them into OpenCode tasks.

npm install -g @covalenthq/goldrush-cli

Add GoldRush MCP Server to your OpenCode configPut 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"
      }
    }
  }
}

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

opencode

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

Example Prompts

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

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

Plan Then Build a Portfolio Feature

1Start in Plan mode to inspect the codebase and define the GoldRush integration points

2Switch to Build mode once the architecture is clear

3Have OpenCode create the client utility, API route, and UI components

4Use live GoldRush tool calls to verify response shapes before final edits

Create Reusable Blockchain Commands

1Ask OpenCode to turn a successful GoldRush workflow into a project command

2Store the command in your shared OpenCode config for repeatable usage

3Parameterize wallet addresses, chains, and token contracts

4Reuse the command across future sessions without rewriting prompts

Debug an Onchain Integration

1Open the failing project in OpenCode and explain the bug

2Let OpenCode inspect the code and call GoldRush tools against real data

3Ask it to patch the implementation and rerun the relevant checks

4Capture the fixed behavior as a reusable workflow or prompt

Ship a Wallet Analytics MVP

1Ask OpenCode to scaffold a minimal dashboard with GoldRush SDK support

2Use MCP tools to sample balances, transfers, and pricing data

3Have OpenCode build summary cards and portfolio views from those responses

4Refine the UX after it validates the data path end-to-end

Tips for Success

Keep GoldRush in a project-level opencode.json when you want teammates to share the same MCP setup

Use Plan mode for architecture work, then switch to Build only when you're ready to apply changes

Turn successful blockchain prompts into reusable commands or agents instead of repeating long instructions

Be selective with enabled MCP servers. Extra tool catalogs add noise and context cost

OpenCode FAQ

Yes. OpenCode merges config from project-level opencode.json files and the global ~/.config/opencode/opencode.json, so you can share GoldRush setup with a repo or keep it user-specific.

Troubleshooting

GoldRush tools are not showing in OpenCodeReload the session after editing opencode.json and verify the server entry is enabled. If it still fails, run npx -y @covalenthq/goldrush-mcp-server manually to check for local Node or API key issues.

OpenCode is reading the wrong config fileConfirm whether the repo has a project-level opencode.json that overrides your global config. OpenCode merges configs, so duplicate server names can hide unexpected values.

GoldRush queries consume too much contextAsk OpenCode for targeted queries, paginate large result sets, and disable unused MCP servers. Broad tool catalogs and oversized blockchain responses can crowd the context window quickly.

Explore More Agents

Get Started

Get started with GoldRush API in minutes. Sign up for a free API key and start building.

Get API Key

Support

Explore multiple support options! From FAQs for self-help to real-time interactions on Discord.

Explore Support

Contact Sales

Interested in our professional or enterprise plans? Contact our sales team to learn more.

Contact Sales

Get API KeyPlatformAgentsLoginDocsGitHub

BlogGuidesCase StudiesSupportTeamCareers

XDiscordLinkedInYoutube

Privacy PolicyTerms of UseCookie Policy

OpenCode + GoldRush

Quick Start

Example Prompts

Available MCP Tools (27)

Cross-Chain

Balances

Transactions

Bitcoin

NFTs

Pricing

Security

Utility

GoldRush Agent Skills

Common Workflows

Plan Then Build a Portfolio Feature

Create Reusable Blockchain Commands

Debug an Onchain Integration

Ship a Wallet Analytics MVP

Tips for Success

OpenCode FAQ

Troubleshooting

Explore More Agents

Claude Code

Codex

OpenClaw

Get Started

Support

Contact Sales

OpenCode + GoldRush

Quick Start

Example Prompts

Available MCP Tools (27)

Cross-Chain

Balances

Transactions

Bitcoin

NFTs

Pricing

Security

Utility

GoldRush Agent Skills

Common Workflows

Plan Then Build a Portfolio Feature

Create Reusable Blockchain Commands

Debug an Onchain Integration

Ship a Wallet Analytics MVP

Tips for Success

OpenCode FAQ

Does OpenCode support project-scoped MCP configuration?

Can OpenCode reuse GoldRush workflows across sessions?

Should I use GoldRush MCP or the SDK with OpenCode?

Troubleshooting

Explore More Agents

Claude Code

Codex

OpenClaw

Get Started

Support

Contact Sales