Read story variables
get_variablesRead specific story variables (SugarCube State.variables) by dot path and return JSON; with no paths, summarize top-level keys.
Instructions
Read specific story variables (SugarCube State.variables) by dot path, e.g. ["haircolour", "background", "player.background"]. Accepts "V.x", "variables.x" or plain "x". With no paths, returns a shallow summary of the top-level keys. Output is JSON.
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": {
"game_id": "<game_id>"
},
"name": "get_variables"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| paths | No | Dot paths to read (default: top-level key summary). | |
| game_id | Yes | Session id returned by open_game. |