GoldRush MCP Skill
Use this skill to run GoldRush MCP operations through uxc using a fixed stdio endpoint.
Reuse the uxc skill for generic protocol discovery, output parsing, and auth/error handling rules.
Prerequisites
- -
uxc is installed and available in PATH. - INLINECODE4 is available in
PATH (Node.js installed). - Network access for first-time
@covalenthq/goldrush-mcp-server package fetch. - A GoldRush API key is available.
Core Workflow
Endpoint candidate inputs before finalizing:
- - Raw package form from docs: INLINECODE7
- Reliable non-interactive form: INLINECODE8
- This skill defaults to:
- INLINECODE9
- 1. Verify protocol/path from official source and probe:
- Official source:
https://goldrush.dev/docs/goldrush-mcp-server
- probe candidate endpoint with:
-
uxc --inject-env GOLDRUSH_API_KEY=$GOLDRUSH_API_KEY "npx -y @covalenthq/goldrush-mcp-server@latest" -h
- cold start can take longer on first run because
npx may need to download the package
- 2. Configure credential for repeatable auth:
-
uxc auth credential set goldrush-mcp --auth-type bearer --secret-env GOLDRUSH_API_KEY
-
uxc auth credential set goldrush-mcp --auth-type bearer --secret-op op://Engineering/goldrush/api-key
- 3. Use fixed link command by default:
-
command -v goldrush-mcp-cli
- If missing, create it:
-
uxc link goldrush-mcp-cli "npx -y @covalenthq/goldrush-mcp-server@latest" --credential goldrush-mcp --inject-env GOLDRUSH_API_KEY={{secret}}
-
goldrush-mcp-cli -h
- 4. Inspect operation schema before execution:
-
goldrush-mcp-cli getAllChains -h
-
goldrush-mcp-cli multichain_balances -h
-
goldrush-mcp-cli transactions_for_address -h
-
goldrush-mcp-cli historical_portfolio_value -h
- 5. Prefer read-only discovery first, then expand into broader wallet-history or NFT scans.
Capability Map
-
getAllChains
-
multichain_address_activity
-
multichain_balances
-
multichain_transactions
- - Wallet balances and portfolio:
-
token_balances
-
historical_token_balances
-
native_token_balance
-
historical_portfolio_value
-
historical_token_prices
- - Transfers and transactions:
-
erc20_token_transfers
-
transaction
-
transaction_summary
-
transactions_for_address
-
transactions_for_block
-
nft_for_address
-
nft_check_ownership
-
token_approvals
-
gas_prices
-
log_events_by_address
-
log_events_by_topic
-
block
- INLINECODE43
GoldRush also exposes MCP resources such as config://supported-chains, config://quote-currencies, and status://all-chains. Inspect the live server after auth setup for the current full tool and resource list.
Recommended Usage Pattern
- 1. Start with one focused read goal:
- multichain balances for a wallet
- recent transfers for an address
- historical portfolio value over time
- NFT ownership or token approval review
- 2. Run
-h on the specific tool before the first real call. - Prefer a single wallet and chain first before running wide history scans.
- Parse the JSON envelope first, then inspect
data.
Guardrails
- - Keep automation on JSON output envelope; do not rely on
--text. - Parse stable fields first:
ok, kind, protocol, data, error. - Use
goldrush-mcp-cli as default command path. - INLINECODE56 is equivalent to
uxc --auth goldrush-mcp --inject-env GOLDRUSH_API_KEY={{secret}} "npx -y @covalenthq/goldrush-mcp-server@latest" <operation> ... when the link is created as documented above. - GoldRush uses a stdio MCP server started through
npx, not a hosted HTTPS MCP endpoint. Expect slower cold starts on the first run. - If help or the first call times out during initialization:
- rerun the same command after the package download finishes
- confirm
npx is available in
PATH
- confirm the key is being injected as
GOLDRUSH_API_KEY
- - The skill docs use bearer credential storage only as a secret container for
--inject-env; GoldRush auth actually happens through the child environment variable, not an HTTP bearer header. - Prefer wallet-scoped reads before wide transaction or log scans because some tools can produce large result sets.
- Do not assume tool argument names from memory; inspect
<operation> -h first because GoldRush may revise MCP schemas independently of this skill.
References
- INLINECODE64
GoldRush MCP 技能
使用此技能通过固定 stdio 端点运行 uxc 执行 GoldRush MCP 操作。
复用 uxc 技能进行通用协议发现、输出解析以及认证/错误处理规则。
前置条件
- - uxc 已安装并位于 PATH 环境变量中。
- npx 已安装并位于 PATH 环境变量中(已安装 Node.js)。
- 首次获取 @covalenthq/goldrush-mcp-server 包需要网络访问权限。
- 拥有有效的 GoldRush API 密钥。
核心工作流程
最终确定前的端点候选输入:
- - 文档中的原始包形式:npx @covalenthq/goldrush-mcp-server@latest
- 可靠的非交互形式:npx -y @covalenthq/goldrush-mcp-server@latest
- 此技能默认使用:
- npx -y @covalenthq/goldrush-mcp-server@latest
- 1. 从官方来源验证协议/路径并进行探测:
- 官方来源:https://goldrush.dev/docs/goldrush-mcp-server
- 使用以下命令探测候选端点:
- uxc --inject-env GOLDRUSH
APIKEY=$GOLDRUSH
APIKEY npx -y @covalenthq/goldrush-mcp-server@latest -h
- 首次运行时冷启动可能需要更长时间,因为 npx 可能需要下载包
- 2. 配置凭证以实现可重复认证:
- uxc auth credential set goldrush-mcp --auth-type bearer --secret-env GOLDRUSH
APIKEY
- uxc auth credential set goldrush-mcp --auth-type bearer --secret-op op://Engineering/goldrush/api-key
- 3. 默认使用固定链接命令:
- command -v goldrush-mcp-cli
- 如果缺失,则创建:
- uxc link goldrush-mcp-cli npx -y @covalenthq/goldrush-mcp-server@latest --credential goldrush-mcp --inject-env GOLDRUSH
APIKEY={{secret}}
- goldrush-mcp-cli -h
- 4. 执行前检查操作模式:
- goldrush-mcp-cli getAllChains -h
- goldrush-mcp-cli multichain_balances -h
- goldrush-mcp-cli transactions
foraddress -h
- goldrush-mcp-cli historical
portfoliovalue -h
- 5. 优先进行只读发现,然后扩展到更广泛的钱包历史或 NFT 扫描。
能力图谱
- getAllChains
- multichain
addressactivity
- multichain_balances
- multichain_transactions
- token_balances
- historical
tokenbalances
- native
tokenbalance
- historical
portfoliovalue
- historical
tokenprices
- erc20
tokentransfers
- transaction
- transaction_summary
- transactions
foraddress
- transactions
forblock
- nft
foraddress
- nft
checkownership
- token_approvals
- gas_prices
- log
eventsby_address
- log
eventsby_topic
- block
- block_heights
GoldRush 还提供 MCP 资源,例如 config://supported-chains、config://quote-currencies 和 status://all-chains。在认证设置后检查实时服务器以获取当前完整的工具和资源列表。
推荐使用模式
- 1. 从一个聚焦的读取目标开始:
- 某个钱包的多链余额
- 某个地址的近期转账
- 一段时间内的历史投资组合价值
- NFT 所有权或代币授权审查
- 2. 在首次实际调用前对特定工具运行 -h。
- 在运行广泛的历史扫描前,优先使用单个钱包和单条链。
- 首先解析 JSON 信封,然后检查 data。
安全护栏
- - 保持自动化处理 JSON 输出信封;不要依赖 --text。
- 首先解析稳定字段:ok、kind、protocol、data、error。
- 使用 goldrush-mcp-cli 作为默认命令路径。
- 当按照上述文档创建链接后,goldrush-mcp-cli ... 等同于 uxc --auth goldrush-mcp --inject-env GOLDRUSHAPIKEY={{secret}} npx -y @covalenthq/goldrush-mcp-server@latest ...。
- GoldRush 使用通过 npx 启动的 stdio MCP 服务器,而非托管的 HTTPS MCP 端点。首次运行时冷启动速度较慢。
- 如果帮助信息或首次调用在初始化期间超时:
- 在包下载完成后重新运行相同命令
- 确认 npx 在 PATH 中可用
- 确认密钥已作为 GOLDRUSH
APIKEY 注入
- - 技能文档仅将 bearer 凭证存储用作 --inject-env 的密钥容器;GoldRush 认证实际上通过子进程环境变量进行,而非 HTTP bearer 头部。
- 优先进行钱包范围的读取,然后再进行广泛的交易或日志扫描,因为某些工具可能产生大量结果集。
- 不要凭记忆假设工具参数名称;首先检查 -h,因为 GoldRush 可能独立于此技能修改 MCP 模式。
参考
- references/usage-patterns.md