MCP Server 🐳 Docker

Domotz MCP

MCP server for Domotz network monitoring. Monitor agents, devices, network topology, metrics, alerts, and power outlets.

Installation

Run the MCP server with npx:

npx domotz-mcp

Or install the package:

npm install domotz-mcp

Claude Desktop Configuration

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "domotz": {
      "command": "npx",
      "args": [
        "domotz-mcp"
      ],
      "env": {
        "DOMOTZ_API_KEY": "your-domotz-api-key"
      }
    }
  }
}

Authentication

Variable	Required	Description
`DOMOTZ_API_KEY`	Yes	Your Domotz API key
`DOMOTZ_REGION`	No	API region endpoint (default: us-east-1)

Architecture

Single TypeScript MCP server supporting both stdio and Streamable HTTP transports.

Available Tools (15)

Tools are organized into 4 domains:

Agents

List and inspect Domotz monitoring agents.

Tool	Description
`List agents`	List all Domotz agents
`Get agent`	Get details for a specific agent

Devices

Monitor and inspect network devices.

Tool	Description
`List devices`	List all devices on an agent
`Get device`	Get details for a specific device
`Device uptime`	Get device uptime history
`Device history`	Get device status history
`Device inventory`	Get device inventory details

Network

View network topology and detect conflicts.

Tool	Description
`Network topology`	Get network topology map
`Network interfaces`	List network interfaces
`IP conflicts`	Detect IP address conflicts

Metrics & Alerts

Monitor SNMP sensors and alert profiles.

Tool	Description
`List metric variables`	List available SNMP metric variables
`Variable history`	Get metric variable history
`SNMP sensors`	List SNMP sensors
`Alert profiles`	List alert profiles
`Device alerts`	List alerts for a device