Shelly Smart Home

Call any **read-only** RPC method (``*.Get*``/``*.List*``/``*.Check*``) on a device. Mutating methods are refused here — use ``shelly_rpc_write``. The method name is classified server-side; unknown methods are treated as writes and rejected.

Call any **mutating** RPC method. Requires ``confirm:true``; audit-logged. Read methods are rejected (use ``shelly_rpc``). Destructive methods (factory reset, wipe-all, reset-wifi) need a second gate: ``params.i_understand_data_loss = true``.

Define (save) a named scene from an ordered list of ``{device, method, params}``. Every method must be a non-destructive mutating method; every device must be known. Fails if the name already exists unless ``overwrite=true``. Prefer absolute ``Set`` methods over ``Toggle`` so the scene is safe to run twice (you'll get a warning otherwise).

Delete a named scene. Requires ``confirm:true``.

Show a scene's full definition (its ordered actions). Read-only.

List defined scenes (name, description, action count). Read-only.

Run a named scene: attempt every action in order, report per-action results. Best-effort and sequential — a failing action does **not** abort the rest. ``status`` is ``ok`` (all succeeded), ``partial`` (some failed), or ``failed`` (none succeeded). A partial run can simply be re-run later to finish it (scenes use absolute states, so re-running is safe). Every action is audit-logged.

Create a schedule: ``timespec`` + ``calls`` (1-5 × {method, params}). ``timespec``: cron ``"sec min hour day month dow"`` (e.g. ``"0 0 22 * * MON-THU"``; 5 or 7 fields also accepted), a shorthand (``@daily``), or sun-relative ``"@sunset"``, ``"@sunset+30m"``, ``"@sunrise-1h * * MON-FRI"`` (offset max ±12 h; the device needs its location set). Validates the timespec, ≤5 calls, the ≤20-per-device limit, and each call's method. Audit-logged.

Delete a schedule by ``id``. Requires ``confirm:true``. Audit-logged.

List the schedules configured on a device. Local-only (cloud can't manage schedules).

Update fields of an existing schedule by ``id``. Audit-logged.

Create an empty script (optionally named). Returns its ``id``. Audit-logged. Use ``shelly_script_put_code`` to give it code (that step is confirm-gated).

Delete a script by ``id``. Requires ``confirm:true``. Audit-logged.

Evaluate an expression inside a running script. **Arbitrary code** → ``confirm:true``. Returns the stringified result. Audit-logged.

Get a script's full source, reassembling the device's paginated ``GetCode``.

List scripts on a device (id, name, enable, running). Local-only.

Upload code into a script (chunked). **Arbitrary code on the device** → ``confirm:true``. ``append=false`` replaces the script body; ``true`` appends. Large code is split into ≤1 KB chunks automatically. Audit-logged.

Start a script by ``id``. Returns ``was_running``. Audit-logged.

Stop a script by ``id``. Returns ``was_running``. Audit-logged.

Turn a switch/relay channel on or off (optionally auto-revert after N seconds). Returns the post-action ``ChannelState``. Audit-logged.

Toggle a switch/relay channel. Returns the post-action ``ChannelState``. Audit-logged.

Reboot a device. Requires ``confirm:true``. Audit-logged.

Enable/rotate the device login password (≥12 chars). Requires ``confirm:true``. The password is write-only — never returned, and redacted in the audit log.

Trigger a firmware update (``channel`` = stable|beta). Requires ``confirm:true``.

Return the shelly-mcp server version (health check).

Add a virtual component of ``type`` (boolean/number/text/enum/button/group). Optional ``config`` and ``id`` (200-299). Returns the new component id. Audit-logged.

Delete a virtual component by ``key`` (``<type>:<cid>``). Requires ``confirm:true``.

List the device's virtual (dynamic) components via ``Shelly.GetComponents``.

Create a webhook: ``event`` (e.g. 'switch.on'), ``cid`` component id, ``urls`` 1-5. Optional ``condition`` (JS expression) and ``repeat_period`` (seconds; 0=always, negative=once). Audit-logged.

Delete a webhook by ``id``. Requires ``confirm:true``. Audit-logged.

List webhooks configured on a device. Local-only.

Update fields of an existing webhook by ``id``. Audit-logged.