Variables and modes
fig_variablesList design tokens in a local Figma file, showing variable collections, modes, and values per mode. Filter by collection or variable name to inspect specific tokens.
Instructions
List the design tokens in the file: every variable collection (VARIABLE_SET) with its modes, and every variable with its value per mode — colours as hex, numbers and strings verbatim. Aliases are followed when the target variable lives in this file; a variable published from another library is returned as its opaque assetRef instead. Filter with set (collection name or guid) or query (substring of the variable name).
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": {
"file": "<file>"
},
"name": "fig_variables"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| set | No | Only variables from this collection (name or guid). | |
| file | Yes | Path to the .fig / .figma file (absolute, or relative to the server CWD). | |
| limit | No | Default 100. | |
| query | No | Case-insensitive substring of the variable name. | |
| cursor | No | Opaque nextCursor from a previous truncated response; resumes where it stopped. | |
| includeSets | No | Include the collection list with their modes (default true). |