Domotz API Patterns — independently scanned and version-tracked by SaferSkills.
SaferSkills independently audited Domotz API Patterns (Agent Skill) and scored it 100/100 (green). The audit ran 55 deterministic rules across Security, Supply Chain, Maintenance, Transparency, and Community; it found 0 high-severity and 0 lower-severity findings. The full rule-by-rule trace and per-finding evidence are below. Free, methodology-open.
Findings & checks · 0 flagged
Every scanned point with the score it earned and what moved between them.
First recorded scan — no prior version to compare against.
The primary manifest — the file an agent reads to learn what this artifact does.
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~30 seconds. Free. No account. Every finding cites a rule and a line of evidence.