Run Query Tool
run-queryRun a read-only SQL SELECT. Only SELECT is allowed. The default limit is 10 rows and the maximum is 50. A successful run deducts 2 space credits. Put filters on partition, sort, or primary key columns first when validating a query, then remove those temporary filters.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"query": "<query>"
},
"name": "run-query"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Maximum rows to return. Defaults to 10 and is capped at 50. | |
| query | Yes | A single SELECT statement. Writes and DDL are rejected. | |
| space | No | Space slug. Required when the token is bound to more than one space. Omit it when the token has one space. |