Convex Testnet MCP

MCP Endpoint

Convex MCP v0.8.3-SNAPSHOT

Tools (33)

• query Convex Query

  Execute a Convex Lisp query. Queries are read-only, free, and instant.

• prepare Prepare Transaction

  Prepare a Convex transaction for signing. Returns a hash to pass to 'signAndSubmit' or 'submit'.

• transact Convex Transaction (Quick)

  Execute a Convex transaction in one step. Sends seed over network — use HTTPS with trusted peers only. For sensitive operations prefer prepare → signAndSubmit.

• encode Encode CAD3

  Encode a CVM literal into CAD3 multi-cell hex bytes.

• decode Decode CAD3

  Decode CAD3 multi-cell hex bytes back into a CVM literal.

• submit Submit Prepared Transaction

  Submit a previously prepared transaction with hash, public key, and signature.

• signAndSubmit Sign and Submit Transaction

  Sign and submit a prepared transaction. Use after 'prepare'. Sends seed over network — HTTPS only.

• hash Hash Calculator

  Compute a SHA-256 or SHA3 hash of supplied data.

• sign Value Signer

  Sign raw hex data with an Ed25519 seed. For transactions, sign the 'hash' from prepare.

• peerStatus Peer Status

  Return current Convex peer status including consensus point and network state.

• keyGen Key Pair Generator

  Generate a new Ed25519 key pair. Provide a seed for deterministic output, or omit for secure random.

• validate Signature Validator

  Validate an Ed25519 signature against a public key and message bytes.

• createAccount Create Account

  Create a new Convex account with the specified public key. Optionally fund via faucet (1 CVM = 1,000,000,000 copper, max 1 CVM).

• describeAccount Describe Account

  Get account info: balance, sequence number, defined symbols with metadata.

• lookup Symbol Lookup

  Look up a symbol in a Convex account environment. Returns existence, value (with optional path navigation), and metadata.

• resolveCNS Resolve CNS Name

  Resolve a CNS name to its record: value (usually an address), controller, metadata, and child node.

• getTransaction Get Transaction

  Look up a transaction by hash. Returns signed data, consensus position, and execution result.

• getBalance Get Balance

  Get coin or token balance for an account. Returns balance in copper (1 CVM = 1,000,000,000 copper).

• transfer Transfer

  Transfer CVM coins or fungible tokens to another account. Amounts in copper for CVM (1 CVM = 1,000,000,000 copper).

• watchState Watch State

  Watch a path in the global CVM state for changes. Returns a watchId. Changes are delivered as SSE notifications on the session's GET /mcp stream. Requires an active session (Mcp-Session-Id).

• unwatchState Unwatch State

  Stop watching state paths. Provide a watchId to remove a single watch, or a path to remove all watches whose path starts with the given prefix. At least one of watchId or path must be provided.

• signingServiceInfo Signing Service Info

  Check if the peer's signing service is available. No authentication required.

• signingCreateKey Create Signing Key

  Create a new Ed25519 key pair in the signing service. Private key stored encrypted server-side. Authenticated.

• signingListKeys List Signing Keys

  List all public keys stored in the signing service for the authenticated identity.

• signingSign Sign with Stored Key

  Sign hex-encoded bytes using a stored signing service key. Authenticated.

• signingGetJWT Get Self-Signed JWT

  Create a self-signed EdDSA JWT (did:key identity) using a stored signing key. Authenticated.

• signingTransact Transact via Signing Service

  Execute a Convex transaction using a stored signing key. Private key never leaves the server. Authenticated.

• signingCreateAccount Create Account via Signing Service

  Create a new signing key and on-chain account in one step. Optionally fund via faucet. Authenticated.

• signingListAccounts List Signing Accounts

  List signing keys and associated on-chain addresses for the authenticated identity.

• signingImportKey Import Key (Signing Service)

  Import an Ed25519 seed into the signing service. Elevated: first call returns confirmUrl for browser approval, retry with confirmToken.

• signingExportKey Export Key (Signing Service)

  Export (reveal) the private seed for a stored key. Elevated: first call returns confirmUrl, retry with confirmToken.

• signingDeleteKey Delete Key (Signing Service)

  Permanently delete a key from the signing service. Irreversible. Elevated: first call returns confirmUrl, retry with confirmToken.

• signingChangePassphrase Change Passphrase (Signing Service)

  Change the passphrase for a stored signing key. Elevated: first call returns confirmUrl, retry with confirmToken.

Last checked 2026-04-19T08:15:26.117Z