MCP Endpoint
POST requests to https://mikera1337-convex-testnet.hf.space/mcp
This peer provides MCP JSON-RPC access for LLMs and AI tools
MCP Server Info
| Field | Value | Notes |
|---|---|---|
| networkId | "72738e0e66eed1fa3e9c985a2aa0e440948a32c5bb088536d31a1d2d7ba06646" | |
| title | "Convex MCP" | |
| peerKey | "ff5671e6242112b706bb4ba47507ac1e90c00bf223e2df043b9b25b50a00ba60" | |
| name | "convex-mcp" | |
| version | "0.8.3-SNAPSHOT" |
Registered Tools
| Title | Name | Description |
|---|---|---|
| Convex Query | query | Execute a Convex Lisp query. Queries are read-only, free, and instant. Common patterns: - (balance #13) — coin balance in copper (1 CVM = 1,000,000,000 copper) - *balance* — caller's own balance - (account #13) — full account record - (@convex.fungible/balance #TOKEN #USER) — fungible token balance - (call #ACTOR (fn-name args)) — call actor function read-only - (lookup #ADDR 'symbol) — look up a definition - *state* — full network state (large!) |
| Prepare Transaction | prepare | Prepare a Convex transaction for signing. Returns a hash to pass to 'signAndSubmit' or 'submit'. Common source patterns: - Transfer: (transfer #DEST AMOUNT) - Deploy actor: (deploy '(do (defn greet [x] (str "Hello " x)) (export greet))) - Call actor: (call #ACTOR (function-name arg1 arg2)) - Define value: (def my-var 42) - Set controller: (set-controller #ADDR) - Register CNS: (call #9 (cns-update 'my.name *address*)) Amounts in copper (1 CVM = 1,000,000,000 copper). |
| Convex Transaction (Quick) | transact | Execute a Convex transaction in one step. Sends seed over network — use HTTPS with trusted peers only. For sensitive operations prefer prepare → signAndSubmit. Transactions update global state atomically. Amounts in copper (1 CVM = 1,000,000,000 copper). |
| Encode CAD3 | encode | Encode a CVM literal into CAD3 multi-cell hex bytes. |
| Decode CAD3 | decode | Decode CAD3 multi-cell hex bytes back into a CVM literal. |
| Submit Prepared Transaction | submit | Submit a previously prepared transaction with hash, public key, and signature. |
| Sign and Submit Transaction | signAndSubmit | Sign and submit a prepared transaction. Use after 'prepare'. Sends seed over network — HTTPS only. |
| Hash Calculator | hash | Compute a SHA-256 or SHA3 hash of supplied data. |
| Value Signer | sign | Sign raw hex data with an Ed25519 seed. For transactions, sign the 'hash' from prepare. |
| Peer Status | peerStatus | Return current Convex peer status including consensus point and network state. |
| Key Pair Generator | keyGen | Generate a new Ed25519 key pair. Provide a seed for deterministic output, or omit for secure random. |
| Signature Validator | validate | Validate an Ed25519 signature against a public key and message bytes. |
| Create Account | createAccount | Create a new Convex account with the specified public key. Optionally fund via faucet (1 CVM = 1,000,000,000 copper, max 1 CVM). |
| Describe Account | describeAccount | Get account info: balance, sequence number, defined symbols with metadata. |
| Symbol Lookup | lookup | Look up a symbol in a Convex account environment. Returns existence, value (with optional path navigation), and metadata. |
| Resolve CNS Name | resolveCNS | Resolve a CNS name to its record: value (usually an address), controller, metadata, and child node. |
| Get Transaction | getTransaction | Look up a transaction by hash. Returns signed data, consensus position, and execution result. |
| Get Balance | getBalance | 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). |
| Watch State | watchState | 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). |
| Unwatch State | unwatchState | 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. |
| Signing Service Info | signingServiceInfo | Check if the peer's signing service is available. No authentication required. |
| Create Signing Key | signingCreateKey | Create a new Ed25519 key pair in the signing service. Private key stored encrypted server-side. Authenticated. |
| List Signing Keys | signingListKeys | List all public keys stored in the signing service for the authenticated identity. |
| Sign with Stored Key | signingSign | Sign hex-encoded bytes using a stored signing service key. Authenticated. |
| Get Self-Signed JWT | signingGetJWT | Create a self-signed EdDSA JWT (did:key identity) using a stored signing key. Authenticated. |
| Transact via Signing Service | signingTransact | Execute a Convex transaction using a stored signing key. Private key never leaves the server. Authenticated. |
| Create Account via Signing Service | signingCreateAccount | Create a new signing key and on-chain account in one step. Optionally fund via faucet. Authenticated. |
| List Signing Accounts | signingListAccounts | List signing keys and associated on-chain addresses for the authenticated identity. |
| Import Key (Signing Service) | signingImportKey | Import an Ed25519 seed into the signing service. Elevated: first call returns confirmUrl for browser approval, retry with confirmToken. |
| Export Key (Signing Service) | signingExportKey | Export (reveal) the private seed for a stored key. Elevated: first call returns confirmUrl, retry with confirmToken. |
| Delete Key (Signing Service) | signingDeleteKey | Permanently delete a key from the signing service. Irreversible. Elevated: first call returns confirmUrl, retry with confirmToken. |
| Change Passphrase (Signing Service) | signingChangePassphrase | Change the passphrase for a stored signing key. Elevated: first call returns confirmUrl, retry with confirmToken. |