List the Twinkly devices this server knows about (from configuration and any prior discovery). Returns each device name, IP, where it came from, and which one is used when a tool omits the device argument. Use these names as the device argument on other tools.

Actively scan the local network (UDP) for Twinkly devices and add any newly found ones to the registry. Returns the full device inventory afterwards. Use this when a device is not yet listed by list_devices.

Get static hardware/firmware details for a Twinkly device: product, model, LED count and profile, MAC, UUID, firmware family, and uptime. Use get_state for the current mode/color/brightness.

Get a quick overview of a Twinkly device: current mode, color, on/off timer, music state, and active filters (brightness/saturation). Available since firmware 2.5.6.

Get the current state of a Twinkly device in one call: operation mode, brightness, saturation, and color. This is the go-to read tool before changing anything.

Turn a Twinkly device on or off. "off" stops the LEDs; "on" resumes movie playback (the usual powered-on state). For a specific mode like a static color or the demo loop, use set_mode.

Set the LED operation mode directly. Modes: off, color (static color), demo (built-in loop), movie (a saved movie), effect (a predefined effect — pass effectId), rt (realtime), playlist. To pick which movie/effect plays, use set_movie / set_effect.

Set a single static color and switch the device into color mode so it shows immediately. Provide exactly one of rgb ({r,g,b}, 0–255) or hsv ({h,s,v}; hue 0–359, sat/val 0–255).

Set the overall brightness of a Twinkly device to an absolute level from 0 to 100.

Set the color saturation of a Twinkly device to an absolute level from 0 (black-and-white) to 100 (full color).

List the predefined effects available on a Twinkly device (count + unique ids) and which effect is currently selected. Some firmware cannot report a numeric id for the current effect, in which case only currentEffectUniqueId is set. Use set_effect with an effect id to play one.

Select a predefined effect by its numeric id and switch the device into effect mode so it plays. Call list_effects first to see how many effects exist (ids start at 0).

List the movies (saved animations) uploaded to a Twinkly device — id, name, frames, fps — and which movie is current. Use set_movie with an id to play one.

Select a saved movie by its numeric id and switch the device into movie mode so it plays. Call list_movies first to see the available ids.