// MCP TOOL REFERENCE

SHELLY TOOLS

9 tools from the Shelly MCP Server, categorised by risk level.

READ TOOLS

shelly_get_device_info Get model and firmware info via Shelly.GetDeviceInfo. shelly_get_status Get full status for a Shelly device using Shelly.GetStatus. shelly_list_devices List configured Shelly devices available to this MCP server.

WRITE TOOLS

shelly_cover_control Control cover components (open/close/stop/goto). shelly_discover_and_save_devices Discover Shelly devices and write them into a device config JSON file. shelly_discover_save_and_validate Discover devices, save them to JSON, then validate connectivity using Shelly.GetStatus. shelly_rpc_call Call any Shelly RPC method for advanced scenarios. shelly_switch_set Turn a relay switch on/off using Switch.Set. shelly_update_device_credentials Batch-apply credentials to saved devices by name/IP/model filters and optionally validate.

// FAQ

How many tools does the Shelly MCP server have? +

The Shelly MCP server exposes 9 tools across 2 categories: Read, Write.

How do I enforce policies on Shelly tools? +

Use Intercept, the open-source MCP proxy. Write YAML rules for each tool — rate limits, argument validation, or deny rules — then run Intercept in front of the Shelly server.

What risk categories do Shelly tools fall into? +

Shelly tools are categorised as Read (3), Write (6). Each category has a recommended default policy.

Let agents act without letting them run wild.

Deterministic policy on every MCP tool call. Per-identity grants. Full audit log.

GET STARTED →