npx skills add ...
npx skills add convex-dev/convex --skill query
npx skills add convex-dev/convex --skill query
Execute a read-only CVM query on the Convex network. Use when reading on-chain state, checking balances, looking up accounts, or evaluating Convex Lisp expressions.
Execute a read-only query on the Convex network. Queries are free, instant, and never modify state.
Expression: $0
Address (optional): $1 — the account context for the query (e.g. #13)
Use the mcp__convex-testnet__query tool.
# prefix: #13, #42@ prefix for actor lookup: @convex.fungibleimport — use CNS-resolved paths like (@convex.fungible/balance #128 #13)| Task | Expression |
|---|---|
| Coin balance | (balance #13) |
| Own balance | *balance* |
| Account info | (account #13) |
| Token balance | (@convex.fungible/balance #TOKEN #USER) |
| Lookup symbol | (lookup #ADDR 'symbol) |
| Full state | *state* (large!) |
Present balances in human-readable CVM units (e.g. "1.5 CVM" not "1500000000 copper").