How to integrate Domotz MCP with Atomic Agent

Connect Atomic Agent 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

Atomic Agent is an open-source AI agent that runs on your machine and supports local models through llama.cpp. Connect it to 1,500+ apps through Composio, including Domotz.

This guide uses Atomic Agent's built-in Composio integration. You need Atomic Agent v0.5.6 or later, your own Composio API key, and a Domotz account. See the Atomic Agent documentation for installation instructions.

Also integrate Domotz MCP with

How Atomic Agent connects to Domotz

Atomic Agent connects to Composio's Tool Router over Streamable HTTP MCP. It discovers the tools needed for your request, and Composio handles account authentication.

Execution and account-connection tools follow Atomic Agent's configured approval policy. Review any approval prompt before allowing an action on your connected account.

Connect Domotz to Atomic Agent

  1. Sign up or sign in to the Composio dashboard. Copy your API key.
  2. In Atomic Agent, open the Integrations tab and select Composio. Select API key, press e, paste the key, and press Enter. The tools become available immediately, without a restart.
  3. Ask Atomic Agent to do something in Domotz. It searches Composio for the right tool.
  4. On first use, open the sign-in link returned in the chat. Connect your Domotz account, then return to Atomic Agent to continue.

Headless setup

Add the following line to ~/.atomic-agent/.env, replacing YOUR_COMPOSIO_API_KEY with your key. Start Atomic Agent after saving the file.

bash
COMPOSIO_API_KEY=YOUR_COMPOSIO_API_KEY

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.

Use Domotz from Atomic Agent

With your account connected, ask Atomic Agent to work with Domotz in natural language. You can connect more apps through the same Composio integration as you need them.

Visit the Atomic Agent website or inspect the Atomic Agent source code.

Troubleshooting

Why is my API key rejected?

Copy the key directly from the Composio dashboard. Atomic Agent requires ASCII characters because it sends the key in an HTTP header. Remove any extra characters introduced when copying.

Why are Composio tools unavailable after saving a key?

Check that you use Atomic Agent v0.5.6 or later and that Composio is enabled in your configuration. A "composio": { "enabled": false } setting disables the integration while keeping the saved key on disk.

Does Composio have a free plan?

The Hobby plan includes 100,000 tool calls per month. Composio-managed OAuth apps have a lower included allowance. See Composio pricing for the current limits that apply to your connection.

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.

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. Atomic Agent 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