MUSIC_CONTROL
Control Apple Music playback.
macOS only
This capability uses native Apple apps and is available in the macOS edition. The Linux editions offer equivalent cross-platform capabilities instead.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
command | play | pause | next | previous | stop | yes | Playback command |
track | string | — | Optional track name to play |
How to use it
You normally trigger this by describing what you want in chat — the agent selects MUSIC_CONTROL automatically. For example:
Try saying
“use mac media to music …”
In a workflow
As a step in a multi-step workflow DAG:
json
{
"id": "s1",
"agent": "mac_media",
"action": "MUSIC_CONTROL",
"args": {
"command": "play",
"track": "…"
},
"depends_on": [],
"outputs": []
}Direct call
For scripting, call it directly via POST /execute_tool. Every tool returns { success, message, data }.
bash
curl -X POST http://127.0.0.1:8000/execute_tool \
-H "Content-Type: application/json" \
-d '{"tool_name":"MUSIC_CONTROL","args":{"command":"play","track":"…"}}'Part of the mac_media plugin. Browse the full Plugin & Tool Catalog or the relevant feature guide.