Tool Details: convexQuery

Basic Information

Tool Name:convexQuery
Asset Name:Convex Query
Description:Execute a read-only query against a Convex peer
Adapter:convex
Asset Hash:0x8d6493ba35cb5be5a0d9d78ef46a64420728d8bf74a83976f6d536faf8af28cb
Input
PropertyTypeDescription
sourcestringConvex Lisp source code to query
peerstringConvex peer endpoint, e.g.: peer.convex.live:18888
addressstringConvex account address e.g. #123
Output
PropertyTypeDescription
errorCodestringError code, if an error occurred
valueanyResult of the query, as JSON (some type distinctions may be lost).
resultstringResult of the query, as Convex printed data structure.

MCP Tool Usage Examples

This tool can be called via the MCP (Model Context Protocol) endpoint. Here are examples of how to use it:

JSON-RPC Call Example:

POST to https://venue-1.covia.ai/mcp

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "convexQuery",
    "arguments": {
      "input": "your input here"
    }
  }
}
cURL Example:
curl -X POST https://venue-1.covia.ai/mcp \\
  -H "Content-Type: application/json" \\
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
      "name": "convexQuery",
      "arguments": {
        "input": "your input here"
      }
    }
  }'
Python Example:
import requests
import json

url = "https://venue-1.covia.ai/mcp"
payload = {
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
        "name": "convexQuery",
        "arguments": {
            "input": "your input here"
        }
    }
}

response = requests.post(url, json=payload)
result = response.json()
print(result)
JavaScript/Node.js Example:
const fetch = require('node-fetch');

const url = 'https://venue-1.covia.ai/mcp';
const payload = {
    jsonrpc: '2.0',
    id: 1,
    method: 'tools/call',
    params: {
        name: 'convexQuery',
        arguments: {
            input: 'your input here'
        }
    }
};

fetch(url, {
    method: 'POST',
    headers: {
        'Content-Type': 'application/json'
    },
    body: JSON.stringify(payload)
})
.then(response => response.json())
.then(data => console.log(data));

Asset Metadata

{
	"name": "Convex Query",
	"description": "Execute a read-only query against a Convex peer",
	"operation": {
		"adapter": "convex:query",
		"toolName": "convexQuery",
		"input": {
			"type": "object",
			"properties": {
				"peer": {
					"type": "string",
					"description": "Convex peer endpoint, e.g.: peer.convex.live:18888",
					"default": "peer.convex.live:18888"
				},
				"address": {
					"type": "string",
					"description": "Convex account address e.g. #123"
				},
				"source": {
					"type": "string",
					"description": "Convex Lisp source code to query"
				}
			}
		},
		"output": {
			"type": "object",
			"description": "Result of the Convex query",
			"properties": {
				"errorCode": {
					"type": "string",
					"description": "Error code, if an error occurred",
					"default": "peer.convex.live:18888"
				},
				"result": {
					"type": "string",
					"description": "Result of the query, as Convex printed data structure."
				},
				"value": {
					"type": "any",
					"description": "Result of the query, as JSON (some type distinctions may be lost)."
				}
			}
		},
		"peer": "peer.convex.live:18888"
	}
}

Navigation

Back to adapter details

Back to all adapters

Back to index