instruments_presets
List installed plugin presets (.fxp) for a track with name, category, and path. Filter by query words and paginate to locate specific patches.
Instructions
Preset files (.fxp) installed with the external plugin on a track, e.g. Surge XT's factory patches: name, category (their folders) and path. Filter with query words ("bass reese", "leads"); pages of up to 200.
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": {
"track": "<track>"
},
"name": "instruments_presets"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | At most this many (default 200). | |
| query | No | Words that must all appear in the name or category. | |
| track | Yes | Track id (UUID string from tracks.list, stable) or 0-based index (shifts when tracks are added or moved). | |
| offset | No | Skip this many matches. |