From domotz
Guides Domotz MCP tools for network monitoring agents, devices, alerts, scans, SNMP, ports, speed tests: API key auth, regions, structure, pagination, rate limits, error handling.
npx claudepluginhub wyre-technology/msp-claude-plugins --plugin domotzThis skill uses the workspace's default tool permissions.
The Domotz MCP server provides AI tool integration with the Domotz network monitoring and management platform. It exposes tools covering agents, devices, alerts, network scanning, SNMP, port monitoring, speed tests, and Domotz Eyes sensors. The API authenticates with an API key passed via the `X-Api-Key` header.
Searches, retrieves, and installs Agent Skills from prompts.chat registry using MCP tools like search_skills and get_skill. Activates for finding skills, browsing catalogs, or extending Claude.
Searches prompts.chat for AI prompt templates by keyword or category, retrieves by ID with variable handling, and improves prompts via AI. Use for discovering or enhancing prompts.
Guides implementation of event-driven hooks in Claude Code plugins using prompt-based validation and bash commands for PreToolUse, Stop, and session events.
The Domotz MCP server provides AI tool integration with the Domotz network monitoring and management platform. It exposes tools covering agents, devices, alerts, network scanning, SNMP, port monitoring, speed tests, and Domotz Eyes sensors. The API authenticates with an API key passed via the X-Api-Key header.
Domotz authenticates using an API key passed as an HTTP header:
| Header | Description |
|---|---|
X-Domotz-API-Key | Your Domotz API key |
X-Domotz-Region | API region (us-east-1 or eu-central-1) |
Generate credentials at: Domotz Portal > User Menu > API Keys
Environment Variables:
export DOMOTZ_API_KEY="your-api-key"
export DOMOTZ_REGION="us-east-1"
IMPORTANT: Never hardcode credentials. Always use environment variables.
Domotz operates region-specific API endpoints:
| Region | API Host |
|---|---|
us-east-1 (default) | api-us-east-1-cell-1.domotz.com |
eu-central-1 | api-eu-central-1-cell-1.domotz.com |
Ensure your region matches your Domotz account's region. Using the wrong region returns authentication errors.
| Tool | Description |
|---|---|
domotz_list_agents | List all Domotz agents/collectors |
domotz_get_agent | Get details for a specific agent |
domotz_get_agent_status | Get agent connectivity status |
| Tool | Description |
|---|---|
domotz_list_devices | List devices monitored by an agent |
domotz_get_device | Get device details by ID |
domotz_search_devices | Search devices by name, IP, or MAC |
domotz_get_device_status | Get device online/offline status |
| Tool | Description |
|---|---|
domotz_list_alerts | List active alerts |
domotz_get_alert | Get alert details |
domotz_list_alert_profiles | List configured alert profiles |
| Tool | Description |
|---|---|
domotz_scan_network | Trigger a network discovery scan |
domotz_list_snmp_data | Get SNMP polled data for a device |
domotz_list_ports | List open ports on a device |
domotz_run_speed_test | Run a speed test from an agent |
| Tool | Description |
|---|---|
domotz_list_eyes | List Domotz Eyes sensors for an agent |
domotz_get_eye | Get sensor details and status |
domotz_list_eye_results | Get historical results for a sensor |
The Domotz API uses offset-based pagination:
page (1-indexed) and page_size to control result pagescount for total number of resultsExample workflow:
domotz_list_devices with agent_id and page=1, page_size=50count exceeds 50, call again with page=2Domotz enforces API rate limits per API key.
| Code | Meaning | Resolution |
|---|---|---|
| 401 | Unauthorized | Check API key; verify region matches account |
| 403 | Forbidden | Insufficient permissions for this resource |
| 404 | Not Found | Resource doesn't exist or wrong ID |
| 429 | Rate Limited | Wait and retry after delay |
| 500 | Server Error | Retry; contact support if persistent |
{
"error": "Unauthorized",
"message": "Invalid API key"
}
last_seen timestamps to detect offline agents/devices