get_variable_context
Search variable definitions by scope and keyword, or read one variable by id. Read-only. Returns { variables, total, returned, truncated } — compare returned against total to detect a cut-off result set and re-call with a higher limit. Values are withheld unless includeValues is true; in a list each value is cut to a 500-character preview, while variableId + includeValues returns that one value in full (read it this way before update_variable, which replaces the whole value). A bot variable holds one value per bot: with includeValues it carries botValues [{ botId, botName, value }] for every bot of the application (value null = that bot has none yet); set one with update_variable data.botId. Variables marked secret stay redacted either way. Variables come in the order the variables list shows, scope by scope; move one with update_variable data.placeAfter / data.placeBefore. Use the returned ids in {{var|<id>}} references.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "get_variable_context"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Maximum variables to return. Defaults to 30; values above 50 are clamped to 50. | |
| query | No | Case-insensitive substring filter matched against the variable name, full path, description, type, and scope. Omit to list without filtering. | |
| scope | No | Restrict to one variable scope. Defaults to "all". | |
| variableId | No | Read exactly this variable (its id or persistentId). With includeValues=true the value comes back in full, not as a preview. scope, query and limit are ignored. | |
| applicationId | No | Application (workspace) id. Optional: an application-scoped key (app_...) defaults to its own application, but a personal key (usr_...) has no default and omitting it fails with MCP_APPLICATION_REQUIRED. Call list_applications to get the id. | |
| includeValues | No | Set true to include stored values: previewed to 500 characters in a list, in full with variableId. Defaults to false — leave it off unless you need the data, since values may hold personal data. Secret variables remain redacted regardless. |