query

name	query
description	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.
argument-hint	<cvx-expression> [address]

Query Convex State

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.

CVM Conventions

• Amounts are in copper: 1 CVM = 1,000,000,000 copper (10^9). Always convert to CVM for display.
• Account addresses use # prefix: #13, #42
• CNS paths use @ prefix for actor lookup: @convex.fungible
• Never use import — use CNS-resolved paths like (@convex.fungible/balance #128 #13)

Common Queries

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").