iaqualink_set_aux
Turn a pool or spa auxiliary circuit on or off by number, name, or label, with confirmation and a state re-read to verify the change.
Instructions
Turn an auxiliary circuit on or off — cleaner, waterfall, bubbler, landscape or pool/spa lights wired to an aux relay. Identify it by number ("3"), name ("aux_3") or label as shown by iaqualink_get_status. On iAqua, dimmable lights turn on at 100% and color lights at their first color, as the iAqualink app does. Sends nothing if already in that state, then re-reads to confirm. Asks the user to confirm first: a confirmation prompt where the client supports one; otherwise the first call returns a preview and a confirmToken, and only a repeat call with that token proceeds (see MCP_CONFIRM_MODE).
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": {
"serial": "<serial>",
"aux": "<aux>",
"on": "<on>"
},
"name": "iaqualink_set_aux"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| on | Yes | true = turn on, false = turn off | |
| aux | Yes | Aux number, aux_<n> name, or label | |
| serial | Yes | System serial number, from iaqualink_list_systems | |
| confirmToken | No | ONLY for the two-step confirmation fallback (a client without MCP elicitation). The confirmToken from this same tool's phase-1 "confirmation-required" response, passed back ONLY after the user has seen that preview and explicitly approved it in chat — never on the first call, never invented, never reused. Call again with the same arguments. Ignored when the client supports elicitation. |