get_settings
Retrieve global Domoticz settings and configuration to access system-wide parameters for home automation control.
Instructions
Get global Domoticz settings and configuration.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |
Implementation Reference
- src/domoticz_mcp/server.py:886-891 (handler)The `get_settings` tool handler function. It is registered as an MCP tool via @mcp.tool() decorator (line 886). It calls the Domoticz API with 'type=command¶m=getsettings' to retrieve global Domoticz settings and configuration.
@mcp.tool() async def get_settings() -> str: """Get global Domoticz settings and configuration.""" async with create_client() as client: response = await _do_request(client, "GET", f"{DOMOTICZ_API_URL}?type=command¶m=getsettings") return response.text - src/domoticz_mcp/server.py:886-886 (registration)The tool is registered using the @mcp.tool() decorator on line 886, which registers `get_settings` as an MCP tool with the FastMCP server instance.
@mcp.tool() - src/domoticz_mcp/server.py:1272-1277 (helper)There is also a corresponding MCP resource handler `get_settings_resource` registered as 'domoticz://settings' that provides the same Domoticz settings data via a resource URI.
@mcp.resource("domoticz://settings") async def get_settings_resource() -> str: """Read global Domoticz settings and configuration.""" async with create_client() as client: response = await _do_request(client, "GET", f"{DOMOTICZ_API_URL}?type=command¶m=getsettings") return response.text