Astra: set a track favorite
astra_set_favoriteSet or clear a track as favorite in the Astra library. Pass a track ref from search or now playing to mark or unmark it.
Instructions
Mark or unmark a track as a favorite in the Astra library. This sets an explicit state rather than toggling, so it is safe to repeat. Takes a track ref from astra_search or from the current track reported by astra_now_playing. Refs are opaque signed strings from astra_search (or from the current track / queue). Pass them through verbatim — never parse, edit, or invent one. A ref can go stale and return 404.
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": {
"trackRef": "<trackRef>",
"favorite": "<favorite>"
},
"name": "astra_set_favorite"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| favorite | Yes | true to favorite the track, false to un-favorite it. | |
| trackRef | Yes | A track ref. Refs are opaque signed strings from astra_search (or from the current track / queue). Pass them through verbatim — never parse, edit, or invent one. A ref can go stale and return 404. |