Hermes Agent + GoldRush
by Nous ResearchTerminal
Standalone
Quick Start
1
Install Hermes Agent
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
2
Enable MCP supportInstall the MCP extras if your current Hermes environment does not already include them.
pip install "hermes-agent[mcp]"
3
Run the Hermes setup wizardConfigure your preferred inference provider before you connect external tools.
hermes setup
4
Add GoldRush MCP Server to
~/.hermes/config.yamlmcp_servers:
goldrush:
command: "npx"
args: ["-y", "@covalenthq/goldrush-mcp-server"]
env:
GOLDRUSH_API_KEY: "YOUR_API_KEY"5
Start Hermes and assign a blockchain taskAsk: "Use GoldRush to monitor this wallet, summarize new transfers every hour, and remember the reporting format I prefer"
hermes
Example Prompts
“Create a reusable Hermes skill for wallet portfolio analysis with GoldRush”
“Spawn subagents to compare token balances across Ethereum, Base, and Arbitrum”
“Set up a recurring wallet monitor and notify me when transfers exceed a threshold”
“Use GoldRush to build a daily markdown report for this treasury wallet”
“Write and execute code that classifies this wallet's recent transactions”
“Remember my preferred chain list and reporting layout for future GoldRush tasks”
“Investigate suspicious token approvals for this address and summarize the risk”
“Run a chain-by-chain analysis and aggregate the results into one report”
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
Persistent Wallet Monitoring
1Configure GoldRush once in
~/.hermes/config.yaml2Ask Hermes to watch a wallet and remember your preferred alert format
3Let Hermes call GoldRush on a schedule and store the workflow as a skill
4Reuse the same long-running agent instead of rebuilding context each session
Parallel Multi-Chain Analysis
1Give Hermes a wallet or protocol to analyze
2Ask it to spawn subagents for different chains or data domains
3Each subagent queries GoldRush independently and reports back
4Hermes merges the findings into a single summary or action plan
Teach Hermes a GoldRush Skill
1Solve a real blockchain task end-to-end with Hermes once
2Ask it to package the winning approach into a reusable skill
3Store the skill so future GoldRush tasks start from working procedure, not scratch
4Share that skill across environments if your team reuses the same workflow
Server-Side Blockchain Automation
1Deploy Hermes on a VPS or server environment
2Connect GoldRush through MCP and set the required API key
3Run long-lived treasury, whale-tracking, or compliance workflows
4Use Hermes memory to keep user preferences and reporting conventions stable
Tips for Success
Keep GoldRush in the Hermes YAML config so long-running agents can restart without losing tool access
Teach Hermes one good wallet-analysis pattern and convert it into a reusable skill quickly
Use subagents for per-chain or per-wallet fanout instead of forcing one conversation to do all analysis serially
Hermes is strongest when it stays alive over time, so prefer server deployment for recurring blockchain automation
Hermes Agent FAQ
Yes. Hermes supports MCP servers through the
mcp_servers section in ~/.hermes/config.yaml, so GoldRush can be exposed as a first-class tool without custom glue code.Troubleshooting
Hermes is not showing any MCP toolsMake sure the MCP extras are installed and that the
mcp_servers section is valid YAML. If needed, run pip install "hermes-agent[mcp]" again in the same environment Hermes uses.GoldRush MCP tool calls time outIncrease the MCP timeout in
~/.hermes/config.yaml, paginate large blockchain queries, and avoid asking Hermes to fetch huge multi-chain datasets in one call.Hermes cannot start the GoldRush serverEnsure Node.js and
npx are installed on the host where Hermes runs. Test npx -y @covalenthq/goldrush-mcp-server manually to confirm the binary and API key are available.Explore More Agents
Claude Code
AnthropicTerminal
Cloud
IDE
Full codebase understanding and editing
MCP server integration for live data
Autonomous multi-step task execution
Terminal-native workflow
Codex
OpenAITerminal
Cloud
IDE
Sandboxed cloud execution environment
Autonomous task completion
Git-aware with PR creation
Parallel task execution
OpenCode
OpenCodeTerminal
IDE
Extension
Build and Plan agents for controlled execution
Config-based MCP integration
Project-scoped agents and commands
Terminal-first workflow with IDE options
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.
© 2026 Covalent. All rights reserved.
© 2026 Covalent. All rights reserved.