Convex-Dev/query
skills/query/SKILL.md
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.
$ install --global
skillsauthnpx skillsauth add Convex-Dev/convex queryInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Apr 22, 2026, 12:18 AM135.8s1 file scanned
SKILL.md
- 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").
Related Skills
Convex-Dev/transfer
tools
VerifiedTrustedCommunity
Transfer CVM coins or fungible tokens between Convex accounts. Use when the user wants to send coins or tokens to another account.
115SKILL.mdUpdated Apr 21, 2026
Convex-Dev/transact
data-ai
VerifiedTrustedCommunity
Execute a CVM transaction on the Convex network. Use when the user wants to modify on-chain state, call actor functions, or define values.
115SKILL.mdUpdated Apr 21, 2026
Convex-Dev/token
testing
VerifiedTrustedCommunity
Create and manage fungible tokens on Convex. Use when the user wants to create a new token, check token balances, or manage token supply.
115SKILL.mdUpdated Apr 21, 2026
Convex-Dev/deploy
devops
VerifiedTrustedCommunity
Deploy an actor (smart contract) to the Convex network. Use when the user wants to create a new on-chain actor with exported functions.
115SKILL.mdUpdated Apr 21, 2026