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:0x3dbf6790bd8a97e8e98e80206a19dccdef75e820864a7ee3243a0ec50a6fcff3
Input
PropertyTypeDescription
sourcestringConvex Lisp source code to query
addressstringConvex account address e.g. #123
peerstringConvex peer endpoint, e.g.: peer.convex.live:18888
Output
PropertyTypeDescription
resultstringResult of the query, as Convex printed data structure.
errorCodestringError code, if an error occurred
valueanyResult of the query, as JSON (some type distinctions may be lost).

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://mcp-1st-birthday-agentic-economics.hf.space/mcp

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "convexQuery",
    "arguments": {
      "input": "your input here"
    }
  }
}
cURL Example:
curl -X POST https://mcp-1st-birthday-agentic-economics.hf.space/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://mcp-1st-birthday-agentic-economics.hf.space/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://mcp-1st-birthday-agentic-economics.hf.space/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"
				},
				"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