query

от convex-dev

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…

npx skills add https://github.com/convex-dev/convex --skill query

Скачать ZIP GitHub

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

Больше skills от convex-dev

Create or inspect Convex accounts. Use when the user wants to set up a new account, check account details, or manage keys.

Собрать проект Convex из исходного кода. Используйте, когда участник хочет скомпилировать, протестировать или упаковать Convex.

Разрешение или регистрация имен Convex Name System (CNS). Используется, когда пользователь хочет найти имя CNS, зарегистрировать новое имя или обновить цель имени.

Используйте Convex DB — реляционную базу данных на основе решёток. Используйте, когда помогаете пользователям писать запросы, подключаться через JDBC или клиенты PostgreSQL, создавать таблицы, вставлять/запрашивать данные,…

Развернуть актор (смарт-контракт) в сети Convex. Используется, когда пользователь хочет создать новый ончейн-актор с экспортируемыми функциями.

Create and manage fungible tokens on Convex. Use when the user wants to create a new token, check token balances, or manage token supply.

Execute a CVM transaction on the Convex network. Use when the user wants to modify on-chain state, call actor functions, or define values.

Transfer CVM coins or fungible tokens between Convex accounts. Use when the user wants to send coins or tokens to another account.