Astra: play a target now
astra_playStart playing a track, album, artist, or playlist in Astra using a ref from astra_search. This replaces the current queue.
Instructions
Start playing a track, album, artist, or playlist in Astra, replacing the current queue. Takes an opaque ref from astra_search — call that first to turn a name into a 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. To resume something already loaded, use astra_control with action "play" instead.
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": {
"targetRef": "<targetRef>"
},
"name": "astra_play"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| targetRef | Yes | An opaque AstraRef from astra_search. 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. |