io.github.wyre-technology/domotz-mcp

Official

by wyre-technology · TypeScript

Domotz

MCP server for Domotz network monitoring — agents, devices, alerts, and network discovery.

Domotz network monitoring for agents, devices, alerts, and network discovery.

Topics

domotzmcp-servermspnetwork-monitoringtypescriptwyre-technologymsp-mcp

README.md2 KBView on GitHub

Domotz MCP Server

A Model Context Protocol (MCP) server for Domotz network monitoring and management. Enables AI assistants to monitor network devices, view alerts, check device status, and manage network infrastructure.

This is a Model Context Protocol (MCP) server that connects Claude (or any MCP-compatible AI) to your Domotz environment.

Part of the MSP Claude Plugins ecosystem — a growing suite of AI integrations for the MSP stack. Built by MSPs, for MSPs.

Installation

bash

npm install @wyre-technology/domotz-mcp

Configuration

Set the following environment variables:

Variable	Required	Description
`DOMOTZ_API_KEY`	Yes	Your Domotz API key
`DOMOTZ_REGION`	No	API region: us or eu (default: us)
`MCP_TRANSPORT`	No	Transport mode: stdio (default) or http

Usage

Running with Claude Desktop

Add to your Claude Desktop claude_desktop_config.json:

json

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

Running with Claude Code (CLI)

bash

claude mcp add domotz-mcp \
  -e DOMOTZ_API_KEY=your-value \
  -- npx -y @wyre-technology/domotz-mcp

Docker

bash

docker build -t domotz-mcp .
docker run \
  -e DOMOTZ_API_KEY=your-value \
  -p 8080:8080 domotz-mcp

Available Domains

Agents

Manage Domotz monitoring agents

Alerts

View and manage network alerts

Devices

Device discovery and status monitoring

Metrics

Network performance metrics

Network

Network topology and configuration

Power

Power management for managed devices

Development

bash

# Clone the repository
git clone https://github.com/wyre-technology/domotz-mcp.git
cd domotz-mcp

# Install dependencies
npm install

# Build
npm run build

# Run tests
npm test

Contributing

Contributions are welcome! Please see CONTRIBUTING.md if present, or open an issue to discuss changes.

License

Licensed under the Apache License, Version 2.0. See LICENSE for details.

Install

Configuration

Environment variables

DOMOTZ_API_KEYrequiredsecret

Domotz Public API key (generated in the Domotz portal)

DOMOTZ_API_URL

Domotz Public API base URL for the regional endpoint (e.g. https://api-us-east-1-cell-1.domotz.com/public-api/v1)

MCP_TRANSPORTdefault stdio

Transport mode for the server. Set to 'stdio' for local CLI use; the image defaults to 'http' for gateway hosting.

AUTH_MODEdefault env

Credential source: 'env' reads vars locally, 'gateway' expects header injection from the WYRE MCP Gateway.

LOG_LEVELdefault info

Log verbosity: debug, info, warn, error

claude_desktop_config.json

{
  "mcpServers": {
    "domotz-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/wyre-technology/domotz-mcp:v1.1.7"
      ],
      "env": {
        "DOMOTZ_API_KEY": "<YOUR_DOMOTZ_API_KEY>",
        "DOMOTZ_API_URL": "<YOUR_DOMOTZ_API_URL>",
        "MCP_TRANSPORT": "stdio",
        "AUTH_MODE": "env",
        "LOG_LEVEL": "info"
      }
    }
  }
}