list_variables
Retrieve local Figma variables in the current file, filter by resolvedType, and optionally include scopes or per-mode values with paged results.
Instructions
List local variables in the current file (optionally filtered by resolvedType). Pass includeScopes: true to also return each variable's scopes, or includeValues: true to also return each variable's value in EVERY mode (valuesByMode by modeId, valuesByModeName by mode name, defaultValue from the collection's first mode, and the mode list) — use this to read theme/dark-mode values, not just the default mode. Results are paged: default limit 500 per call with total/offset/pageCount so you can page through every variable instead of reading them all at once.
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": "list_variables"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Max entries per page (default 500). | |
| offset | No | Skip this many entries (default 0). Page with offset until you reach `total`. | |
| resolvedType | No | ||
| includeScopes | No | Include per-variable scopes arrays. Default false to keep output small. | |
| includeValues | No | Include per-variable values for every mode (valuesByMode, valuesByModeName, defaultValue, modes). Default false. |