How to integrate Domotz MCP with Hermes

Connect Hermes to Domotz MCP. List all devices on site office, show active alerts for site a, and more using natural language, with authentication handled for you.

Domotz MCP logoDomotz MCP
Api Key

Domotz MCP is a network-monitoring service that provides device discovery, alerts, and site telemetry. It helps IT teams monitor, troubleshoot, and manage networks remotely with clear device and alert visibility.

92 Tools

Introduction

Hermes is a 24/7 autonomous agent that lives on your computer or server — it remembers what it learns and evolves as your usage grows.

This guide explains the easiest and most robust way to connect your Domotz account to Hermes. You can do this through either Composio Connect CLI or Composio Connect MCP. For personal use we recommend the CLI, but you won't go wrong with MCP either.

Also integrate Domotz MCP with

What is Composio Connect?

Composio Connect is a consumer offering that lets anyone plug 1,000+ applications directly into their agent harness — including Hermes. It can:

  • Search and load tools from relevant toolkits on-demand, reducing context usage.
  • Chain multiple tools to accomplish complex workflows via a remote workbench, without excessive back-and-forth with the LLM.
  • Manage app authentication end-to-end with zero manual overhead.

Integrating Domotz with Hermes

Using Composio Connect CLI

1. Install the Composio CLI

Run the install script directly, or paste https://composio.dev/hermes into your Hermes chat box to have it installed for you.

bash
curl -fsSL https://composio.dev/install | bash
Hermes authenticating with Composio

2. Authenticate

Once the CLI is installed, ask Hermes to authenticate with Composio.

3. Connect to Domotz

Ask your agent to connect to Domotz, or simply request any Domotz-related task. Hermes will prompt you to authenticate and authorize access.

4. Done. You're all set with a new Domotz connection.


Using Composio Connect MCP

1. Get your MCP URL and API Key

Go to dashboard.composio.dev and copy your Connect MCP URL and API key.

Copy MCP URL and API key from Composio dashboard

2. Open the Hermes config file

bash
nano ~/.hermes/config.yaml

3. Add the Composio Connect MCP server

bash
mcp_servers:
  composio:
    url: "https://connect.composio.dev/mcp"
    headers:
      x-consumer-api-key: "YOUR_COMPOSIO_API_KEY"
    connect_timeout: 60
    timeout: 180

Save with Ctrl + O, Enter, then exit with Ctrl + X.

4. Restart your Hermes agent

Once restarted, ask your agent to connect to Domotz or request any Domotz-related task. It will prompt you to authenticate and authorize access.

5. Done!

What is the Domotz MCP server, and what's possible with it?

The Domotz MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your Domotz account. It provides structured and secure access so your agent can perform Domotz operations on your behalf.

Way Forward

With Domotz connected, Hermes can now act on your behalf whenever it detects a relevant task or you ask it to.

From here, you can extend Hermes further:

  • Connect more apps: Calendar, Slack, Notion, Linear, and hundreds of others are available through the same Composio Connect setup. Each new integration compounds what Hermes can do for you.
  • Build workflows across tools: Once multiple apps are connected, Hermes can chain actions together — turn an email into a calendar invite, a Slack message into a Linear ticket, or a meeting note into a follow-up draft.
  • Let it learn your patterns: The more you use Hermes, the better it gets at anticipating how you'd handle recurring tasks. Give it feedback on drafts and decisions, and it will adapt.

If you run into trouble or want to share what you've built, join the community or check out the Docs for deeper configuration options.

TOOLS

Supported Tools

Every Domotz MCP action and event your agent gets out of the box.

Apply device profile

Applies a device profile (a saved bundle of sensors, and optionally credentials) to one or more devices.

Attach driver

Attach a driver to a device.

Attach sensor

Attach a sensor to a device.

Bind alert rule to collector

Bind an existing alert rule to a collector.

Bind alert rule to device

Bind an existing alert rule to a specific device.

Bind collector to organization

Bind a Collector to an Organization (addressed by its internal `id`).

Bind tags

Bind tags to a device or to a collector, setting which tags it carries.

Collector discovery status

Returns the discovery dashboard data for a collector, including initial discovery progress, device statistics, collector issues, and device categories.

Collector overview

Fetch a high-level overview of a collector including its identity, health status, software version, uptime/downtime intervals, device counts, security issues, speed test results, and IP conflict status.

Compare config backup

Compares two configuration backup snapshots of the same device.

Create alert rule

Create an alert rule.

Create contact

Add a Contact to the Organization with the given internal `id`.

Create organization

Create a new Organization for the calling account.

Create tag

Create a new user-defined tag.

Cycle outlet power

Power-cycle a single outlet on a host device (PoE switch / PDU).

Delete alert rule

Delete an alert rule by ID.

Delete contact

Permanently delete a Contact from the Organization with the given internal `id`.

Delete device

PERMANENTLY delete one or more device records from a collector: the device and its history are removed entirely.

Delete driver

Permanently delete a driver from the account.

Delete organization

Permanently delete an Organization.

Delete tag

Delete a user-defined tag by ID.

Detach driver

Remove the binding between a driver and a device on the given collector.

Detach sensor

Detach a preconfigured (overlay) sensor from a device.

Device inventory

Returns detailed information about a single device: identity, status, capabilities, protocol coverage, attached sensors/drivers/profiles, OS info, location, power source, and end-of-life (EOL) status for firmware, software, and hardware.

Device performance

Fetch device performance metrics including round-trip delay, packet loss, uptime, SNMP sensor values, and disk usage over the last 7 days.

Execute driver

Run an action of a driver against a device.

Get account info

Returns identity and account context for the currently authenticated user: user ID, email, billing state, trial end date, whether the user is the account owner, and whether RBAC is enabled.

Get audit log filters

Return the set of values available for filtering Domotz audit logs: the operation categories (each with its operation types), source applications, target entities, actor entities, and outcome statuses currently present in the data.

Get collector alert rule bindings

List alert rules bound to a specific collector, including bindings at the collector level and bindings to variables owned by that collector.

Get collector capabilities

Inspect what the customer's Collector can actually run.

Get collector credential coverage

Collector-wide credential audit.

Get config backup entry

Returns a single configuration backup snapshot's text for a device.

Get config backup status

Lists devices on a collector that have configuration backup ('config backup') enabled, with the active backup driver, mode (READ_WRITE / READ_ONLY / AVAILABLE / INSUFFICIENT_PRIVILEGE / ERROR), status (ENABLED / DISABLED), failed-inspection count, and last inspection time.

Get create tag form

Shows an interactive form to create a new custom tag, with a name field and a color picker.

Get device alert rule bindings

List alert rules bound to a specific device, including device-level bindings and bindings to variables owned by that device.

Get device alerts

Retrieve alert and monitoring configuration status for a specific device.

Get device credentials

Per-device credential status drill-down.

Get device history

Returns the per-device History / Event Log for a single device: the chronological stream of events the device generated, most recent first.

Get device interfaces

Lists the SNMP-collected interfaces on a device.

Get device metrics

Fetch summarised time-series analytics for one or more named metrics on a device within a time range.

Get driver catalog

Lists the account-wide catalog of drivers available for attaching and executing on devices.

Get driver template

Fetch a single driver template, including its full JS code body and requirement metadata (`requirements.

Get interface traffic

Returns traffic counters for one or more device interfaces over a time range.

Get network configuration

Fetch what a collector actually scans, to answer 'why isn't this device discovered?

Get organization

Get the full details of a single Organization by its internal `id`: name, `organization_id` (the caller-facing reference), its Contacts, and the ids of the Collectors bound to it.

Get snmp credentials form

Shows an interactive form to set or update SNMP credentials on a specific device.

Get uptime

Returns uptime stats for a collector or device over a time range: total uptime percentage, online_seconds, total_seconds, and the list of downtime intervals.

Inspect driver

Static analysis of a driver's JS against the Domotz sandbox.

List alert rules

Lists alert rule definitions in the account.

List collector metrics

Enumerate the metrics available on a collector — speed-test thresholds, IP-conflict status, collector uptime, security-issues counts, and the rest of the collector-scoped metric catalog.

List communication channels

List the user's notification channels (email, webhook, Slack, etc.

List config backup history

Lists configuration backup snapshots for a device on a collector, newest first.

List device drivers

Lists drivers currently attached to a device.

List device metrics

List everything monitorable on a device.

List device profiles

Lists device profiles in the account.

List device sensors

Lists the sensors currently attached to a device, merged across CUSTOM_OID, TCP, CUSTOM_DRIVER, and PRECONFIGURED kinds.

List device types

Returns the device-type catalog used to classify devices (router, switch, AP, server, etc.

List driver templates

List shared driver templates the account can start from.

List metric functions

List the evaluation functions (e.

List organizations

List the account's Organizations with their Contacts and bound Collector ids.

List preconfigured sensors

Returns the account-wide catalog of preconfigured sensors available to attach via `attach_sensor(sensor_spec={kind: 'overlay', overlay_id: .

List tags

Returns the account-wide catalog of user-defined tags applied to devices and collectors.

List variable alert rule candidates

List alert rules that could be bound to a specific device variable.

Manage external hosts

Add or remove an external host on a collector.

Manage ip scan policy

Manage the collector's forced IP scan policy: extra addresses the collector must probe on top of what it discovers by itself.

Manage routed networks

Add, update or remove a routed network on a collector.

Network topology

Returns the network topology discovered by a single collector: device-to-device links and per-outlet (port) details.

Resolve alert

Permanently resolve one or more alert incidents.

Save driver

Create or update a driver on the account.

Search alerts

Search alert history with filters.

Search audit logs

Search Domotz audit logs for the caller's organization.

Search collectors

Search and list Domotz collectors with filtering and pagination (zero-based: first page is page=0).

Search devices

Cross-account device search with filters and pagination (zero-based: first page is page=0).

Search organizations

List and filter the organizations visible to the calling user.

Set collector default snmp credentials

Set the collector's DEFAULT SNMP credentials — the ones used for devices that have no SNMP credentials of their own.

Set device credential

Set or overwrite a device credential.

Set device power

Change the power state of a device: turn it `on`, hold it `off`, `cycle` it, or issue a `software_reboot`.

Set interfaces policy

Set which of the collector's own network interfaces take part in discovery, by name.

Snooze collector alerts

Snooze (temporarily mute) all alerting for a collector for a maintenance window.

Submit feedback

Submit feedback about a gap in available MCP tools or data.

Unbind alert rule from collector

Unbind an alert rule from a collector.

Unbind alert rule from device

Unbind an alert rule from a device.

Unbind collector from organization

Unbind a Collector from an Organization (addressed by its internal `id`).

Unsnooze collector alerts

Resume alerting on a collector immediately, cancelling any active snooze/maintenance window set by `snooze_collector_alerts`.

Update alert rule

Update an existing alert rule in place, preserving its device/collector/variable bindings and alert history (unlike deleting and recreating).

Update collector metadata

Update editable metadata on a collector (the on-site monitoring agent).

Update collector monitoring settings

Update how the collector monitors, as opposed to what it monitors.

Update contact

Update a Contact on the Organization with the given internal `id`.

Update device metadata

Update editable metadata fields on a device: `name`, `importance` (important or not important), `zone`, `room`, `serial`, `notes` (max 256 chars).

Update device monitoring state

Manage or unmanage one or more devices by changing their monitoring state.

Update organization

Update an existing Organization by its internal `id`.

Update tag

Rename an existing user-defined tag, change its colour, or both.

FRAMEWORKS

How to build Domotz MCP Agent with another framework

FAQ

Frequently asked questions

With a standalone Domotz MCP server, the agents and LLMs can only access a fixed set of Domotz tools tied to that server. However, with the Composio Tool Router, agents can dynamically load tools from Domotz and many other apps based on the task at hand, all through a single MCP endpoint.

Yes, you can. Hermes fully supports MCP integration. You get structured tool calling, message history handling, and model orchestration while Tool Router takes care of discovering and serving the right Domotz tools.

Yes, absolutely. You can configure which Domotz scopes and actions are allowed when connecting your account to Composio. You can also bring your own OAuth credentials or API configuration so you keep full control over what the agent can do.

All sensitive data such as tokens, keys, and configuration is fully encrypted at rest and in transit. Composio is SOC 2 Type 2 compliant and follows strict security practices so your Domotz data and credentials are handled as safely as possible.

Start with Domotz MCP.It takes 30 seconds.

Managed auth, hosted MCP servers, and every Domotz MCP tool your agent needs.Free to start.

Start building