Agents/Kilo Code
Kilo Code logo

Kilo Code + GoldRush

by Kilo Code
IDE
Extension
Terminal
Cloud
Kilo Code is an open-source coding agent available in VS Code, JetBrains, and CLI workflows. It combines specialist modes like Code, Architect, Ask, and Debug with project-scoped rules and MCP integrations. When connected to GoldRush, Kilo Code can inspect live blockchain data inside the editor, generate typed integrations, and automate feature or debugging work with onchain context.

Quick Start

1
Install Kilo CodeYou can also install the JetBrains plugin or the optional CLI if that matches your workflow.
code --install-extension kilocode.kilo-code
2
Install GoldRush CLIUse the CLI to verify balances, transactions, and token data before automating them in Kilo.
npm install -g @covalenthq/goldrush-cli
3
Add GoldRush MCP Server to the projectCreate .kilocode/mcp.json in the repository root so the whole team shares the same server config.
{
  "mcpServers": {
    "goldrush": {
      "command": "npx",
      "args": ["-y", "@covalenthq/goldrush-mcp-server"],
      "env": {
        "GOLDRUSH_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}
4
Add Kilo project rulesPut GoldRush-specific guidance in .kilocode/rules/ so Kilo keeps using the right chains, pagination, and API key handling patterns.
5
Start in the right modeUse Architect or Ask to scope the change, then switch to Code or Debug and ask: "Use GoldRush to add multi-chain wallet balances to this project"

Example Prompts

Use GoldRush to add a typed balance service to this TypeScript app
Switch to Debug mode and find why this transaction query fails on Base
Create an Architect-mode plan for migrating our RPC data layer to GoldRush
Build a wallet holdings page with balances, transfers, and NFT sections
Generate a project rule that standardizes GoldRush API usage in this repo
Create a CLI task that exports token holders for a contract to CSV
Use the GoldRush MCP tools to validate the shape of this API response
Refactor this feature to use GoldRush instead of three separate chain providers

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

Architect Then Implement

1Open Kilo in Architect mode and define the GoldRush integration plan
2Capture file-by-file changes and edge cases before writing code
3Switch to Code mode to implement the approved plan
4Use GoldRush tool calls to validate real response payloads while coding

Debug a Failing Web3 Feature

1Switch Kilo into Debug mode and point it at the broken blockchain flow
2Let it inspect the code and run targeted commands
3Use GoldRush tools to compare expected chain data against the app output
4Apply the fix and rerun the smallest useful verification steps

Ship a Wallet Dashboard

1Add the GoldRush MCP config at the project level
2Ask Kilo to build the client utility, route handler, and UI cards
3Use real GoldRush data to tune loading, formatting, and empty states
4Save the final guidance as a project rule for future blockchain work

Standardize Team Setup

1Commit .kilocode/mcp.json with the GoldRush server config
2Add project rules covering API key usage, supported chains, and pagination
3Ask Kilo to validate the setup from a clean repo checkout
4Share the repo so teammates get the same MCP behavior automatically

Tips for Success

Prefer project-level .kilocode/mcp.json for shared GoldRush setup and global config for personal experiments
Use Architect mode before large blockchain changes so Kilo does not jump into editing too early
Store repo-specific GoldRush conventions in .kilocode/rules/ to keep generations consistent
Allow only the tools you actually need. Narrow approvals reduce noise and accidental drift

Kilo Code FAQ

Yes. Kilo Code detects project-level MCP config in .kilocode/mcp.json and applies it to the current workspace. That makes it a good place to keep shared GoldRush configuration.

Troubleshooting

Kilo is not picking up the GoldRush MCP serverConfirm the file is named .kilocode/mcp.json at the repo root and that the JSON is valid. If the server still does not appear, restart the extension so it reloads workspace-level MCP config.
Kilo cannot start npx from the editorMake sure Node.js and npx are on the PATH used by VS Code or JetBrains. Launch the editor from a shell with the correct environment if necessary.
Tool approvals are slowing down repetitive GoldRush tasksKeep the config project-scoped and use Kilo's allowed tool settings for safe, repeatable read-only GoldRush tools. Avoid blanket approval for write-heavy workflows.

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.