Send Device Command
device.registry.commandSends commands to a linked physical device—such as toggling a plug or setting AC temperature—while enforcing device-class safety bounds and confirmation flags.
Instructions
⚡ ACTION: Send a command to a physical device the calling agent owns via a linked vendor connection (e.g. turn a plug on/off, set an AC temperature). Numeric setpoints are bounds-checked against the device class's configured safety limits (config/device-classes.json); some device classes require confirm:true. Requires connection_id, device_id, command, value.
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": {
"connection_id": "<connection_id>",
"device_id": "<device_id>",
"command": "<command>",
"value": "<value>"
},
"name": "device.registry.command"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| value | Yes | The value to set for this command | |
| command | Yes | The device's data-point code, e.g. 'switch_1', 'temp_set' | |
| confirm | No | Must be true for any device class flagged confirm_required in the safety layer (locks, valves, etc.) | |
| device_id | Yes | The vendor's device id (from device.list) | |
| connection_id | Yes | Your device-connection id from /connect/device/connections |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| error | No | Present only when the call failed. Includes error code, message, request_id, and any provider-specific extras. | |
| result | No | Tool response payload. Shape varies per tool — consult the tool description and inputSchema. May be an object, array, string, or number depending on the upstream provider response. |