Odel
MCP server: One MCP server.

Datto RMM

@wyre-technologyMCP server · External

MCP server for Datto RMM — devices, alerts, sites, jobs, and audit data.

Application monitoringv1.7.6Apache-2.0TypeScript
Freeno charge per call
How to install

Runs on your machine from its package; the steps are below.

Deploy to Cloudflare Workers
From the README

What it does

  1. Reads
  2. Writes
  3. High impact

At most: moves money, runs code or commands, deletes data, or sends messages for you.

What it costs

Free

Odel charges nothing per call. The publisher may charge for its own service.

Runs locally over stdio

This server isn't hosted — your MCP client launches it from a package registry. Use one of the commands below, or drop the config into your client (e.g. Claude Desktop).

Dockerghcr.io/wyre-technology/datto-rmm-mcp:v1.7.6

Run

docker run -i --rm ghcr.io/wyre-technology/datto-rmm-mcp:v1.7.6

MCP client config

{
  "mcpServers": {
    "datto-rmm": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/wyre-technology/datto-rmm-mcp:v1.7.6"
      ]
    }
  }
}
README9 min read

Datto RMM MCP Server

MCP server for Datto RMM, enabling Claude to interact with your Datto RMM account.

One-Click Deployment

Important

Before you click: this server depends on @wyre-ai/node-datto-rmm, which is hosted on the GitHub Packages npm registry. GitHub Packages has no anonymous access — even though the package is public, every npm install needs a token. The cloud builder runs npm install for you, so you must give it one, or the build fails with npm error 401 Unauthorized ... npm.pkg.github.com.

  1. Create a GitHub Personal Access Token with the read:packages scope (classic token). Any GitHub account works — you do not need to be a member of the wyre-technology org to read its public packages.
  2. Add it as a build variable when prompted by the deploy flow:
    • Cloudflare Workers → set a build variable named NODE_AUTH_TOKEN to your PAT (Workers → Settings → Build → Variables and Secrets).
    • DigitalOcean App Platform → set an encrypted env var named GITHUB_TOKEN with scope Build Time to your PAT (the .do/deploy.template.yaml already declares it). Also set a runtime secret CONDUIT_S2S_SECRET (openssl rand -hex 32). HTTP exits if that value is missing or a known placeholder.

Deploy to DO

Deploy to Cloudflare Workers

Note

The DigitalOcean target builds the full Docker image and runs the complete MCP server over HTTP — this is the recommended path for operators. This repo has no Cloudflare Workers entrypoint (src/worker.ts), so the Workers button is not a supported target yet; prefer DigitalOcean or the prebuilt container image (ghcr.io/wyre-ai/datto-rmm-mcp).

Features

  • Device Management: List, search, and get details for devices
  • Alert Management: View and resolve alerts
  • Interactive Alert Card (MCP Apps): datto_get_alert renders as an interactive card in MCP Apps hosts (Claude Desktop/web) with an in-card "Resolve alert" round-trip; neutral by default, brandable via window.__BRAND__ injection or MCP_BRAND_* env vars; plain-JSON behavior is unchanged in other hosts
  • Site Management: List and view site details
  • Quick Jobs: Run quick jobs on devices
  • Audit Data: Retrieve full device audit or software inventory

Installation

Via MCP Gateway (Recommended)

This server is designed to work with the MCP Gateway which handles authentication and credential management.

On HTTP, the gateway proves it is the caller with X-Gateway-S2S. The value is t=<unix seconds>,v1=<hex hmac-sha256>. The MAC is HMAC-SHA256 over the ASCII string t=<unix seconds> (the same prefix that appears in the header), keyed with CONDUIT_S2S_SECRET. The timestamp must be within 300 seconds of the server clock. A missing or invalid header is 401. The secret is never written to logs.

Attributing jobs to the end user

Datto RMM records the API account that created a job and offers no way to override it, so on a shared service account every quick job in the console reads as the integration rather than the person who asked for it.

If the gateway sends an X-Mcp-User-Upn header, that identity is appended to the job name, which is the only field that reaches the console's activity list:

Restart Service [someone@example.com]

Only honoured when AUTH_MODE=gateway. Without a gateway in front, the header is whatever the caller chose to send, so attributing a job to it would look authoritative while being self-declared. It is advisory labelling in either case and never affects authorization. Brackets and control characters are stripped from the value, and it is length-capped, so the suffix cannot be forged or made to corrupt the name.

Local Development

This server's @wyre-technology/* dependencies live on the GitHub Packages npm registry, which requires a token even for public packages. Authenticate once, then install:

bash
# Authenticate npm to GitHub Packages (token needs the read:packages scope)
export NODE_AUTH_TOKEN=$(gh auth token)   # or a PAT with read:packages

npm install
npm run build
npm start

The repo's .npmrc already points the @wyre-technology scope at GitHub Packages and reads the token from NODE_AUTH_TOKEN, so no further config is needed.

Configuration

Copy .env.example. Stdio and AUTH_MODE=env read vendor credentials from the environment. Gateway mode does not.

VariableRequiredDescription
DATTO_API_KEYFor stdio and AUTH_MODE=envDatto RMM API key
DATTO_API_SECRETFor stdio and AUTH_MODE=envDatto RMM API secret
DATTO_PLATFORMNoAPI platform: pinotage, merlot, concord (default), vidal, zinfandel, or syrah
MCP_TRANSPORTNostdio (default) or http
AUTH_MODENoenv (image default) or gateway (Compose default). Gateway mode requires X-Datto-API-Key and X-Datto-API-Secret on each /mcp request and never falls back to DATTO_*. env uses those variables only after S2S auth succeeds.
CONDUIT_S2S_SECRETYes for HTTPService-to-service secret. The HTTP server logs an error and exits non-zero when this is empty or a known placeholder (changeme, placeholder, your-s2s-secret, replace-with-a-real-secret, and the other example values in code). Compose will not start without it. Never commit a real value. Generate one with openssl rand -hex 32.
MCP_ALLOW_INSECURE_DEVNoSet to exactly 1 only for local development to start HTTP without CONDUIT_S2S_SECRET. The process logs a warning and does not enforce X-Gateway-S2S. The listener is forced to 127.0.0.1. A non-loopback MCP_HTTP_HOST (including 0.0.0.0) refuses to start. A known placeholder still refuses to start; unset the secret to use this bypass.
MCP_HTTP_HOSTNoBind address when MCP_TRANSPORT=http. With a real CONDUIT_S2S_SECRET, this is honored and defaults to 0.0.0.0 when unset, so container deploys stay unchanged. The container image sets 0.0.0.0.
MCP_HTTP_PORTNoHTTP port. Defaults to 8080.

/health stays unauthenticated and does not read credentials. The stdio transport does not use CONDUIT_S2S_SECRET.

When used with the MCP Gateway in single-tenant AUTH_MODE=env, credentials may also be injected via X_API_KEY and X_API_SECRET environment variables. That path still requires a valid X-Gateway-S2S header on HTTP.

HTTP authentication

With MCP_TRANSPORT=http and CONDUIT_S2S_SECRET set, every /mcp request must include X-Gateway-S2S: t=<unix seconds>,v1=<hex hmac-sha256 of the string t=...>. A missing or invalid header returns 401 before any vendor credential is read.

In AUTH_MODE=gateway, /mcp also requires X-Datto-API-Key and X-Datto-API-Secret (X-Datto-Platform is optional). Those headers are the only credential source for that request. A request missing them returns 401 and does not fall back to DATTO_API_KEY / DATTO_API_SECRET.

Platform Selection

Datto RMM uses regional API endpoints. Select the platform that matches your account:

PlatformRegion/Description
pinotageSouth Africa
merlotEurope
concordUS East (default)
vidalCanada
zinfandelUS West
syrahAustralia

Available Tools

Tools that only read data from Datto RMM carry annotations: { readOnlyHint: true } in their tools/list definition. Clients that support this MCP hint (e.g. Microsoft 365 Copilot / Copilot Studio) can use it to skip the per-call confirmation prompt for those tools. Tools that create, update, resolve, or run anything are never annotated as read-only.

ToolDescriptionRead-only
datto_list_devicesList devices with optional site filterYes
datto_find_deviceFind a device by hostname (exact or partial match) and resolve its UIDYes
datto_get_deviceGet device details by UIDYes
datto_list_alertsList open alerts with optional site filterYes
datto_get_alertGet alert details by UID (renders as an interactive card in MCP Apps hosts)Yes
datto_resolve_alertResolve an alertNo
datto_list_sitesList all sitesYes
datto_get_siteGet site detailsYes
datto_list_componentsList components (find a componentUid and its expected variables for datto_run_quickjob), optionally by name substringYes
datto_run_quickjobRun a quick job on a device (returns a job UID for use with the job tools below)No
datto_get_jobGet status/details for a quick job by UIDYes
datto_get_job_componentsGet the components that make up a quick jobYes
datto_get_job_resultsGet a quick job's result for a specific deviceYes
datto_get_job_stdoutGet a quick job's captured stdout for a specific deviceYes
datto_get_job_stderrGet a quick job's captured stderr for a specific deviceYes
datto_get_device_auditGet device audit data (full or software only)Yes
datto_get_device_patchesGet Windows patch installation status for a deviceYes
datto_get_site_patchesGet Windows patch installation status across all devices in a siteYes

Docker

Use the prebuilt image (no build, no token)

The image listens on 0.0.0.0 inside the container (MCP_HTTP_HOST) and defaults to AUTH_MODE=env. Publish the port on loopback and pass the S2S secret. HTTP refuses to start when CONDUIT_S2S_SECRET is empty or a known placeholder.

bash
docker pull ghcr.io/wyre-ai/datto-rmm-mcp:latest

docker run \
  -e CONDUIT_S2S_SECRET="$CONDUIT_S2S_SECRET" \
  -e DATTO_API_KEY=xxx \
  -e DATTO_API_SECRET=xxx \
  -e DATTO_PLATFORM=concord \
  -p 127.0.0.1:8080:8080 \
  ghcr.io/wyre-ai/datto-rmm-mcp:latest

The image is public and pulls anonymously, so this path needs no GitHub token at all.

Gateway mode does not read those vendor variables. Credentials arrive on each request, and the request must also carry X-Gateway-S2S signed with CONDUIT_S2S_SECRET:

bash
docker run \
  -e CONDUIT_S2S_SECRET="$CONDUIT_S2S_SECRET" \
  -e AUTH_MODE=gateway \
  -p 127.0.0.1:8080:8080 \
  ghcr.io/wyre-ai/datto-rmm-mcp:latest

Compose refuses to start when CONDUIT_S2S_SECRET is unset, sets AUTH_MODE=gateway, does not inject DATTO_API_KEY or DATTO_API_SECRET, and publishes 127.0.0.1:8080:8080:

bash
CONDUIT_S2S_SECRET="$CONDUIT_S2S_SECRET" docker compose up

Build from source

The build installs @wyre-ai/node-datto-rmm from GitHub Packages, which requires a token even though the package is public (see One-Click Deployment). The Dockerfile takes it as the GITHUB_TOKEN build arg — omit it and the build fails at npm ci with npm error 401 Unauthorized ... npm.pkg.github.com:

bash
docker build --build-arg GITHUB_TOKEN=$(gh auth token) -t datto-rmm-mcp .

docker run \
  -e CONDUIT_S2S_SECRET="$CONDUIT_S2S_SECRET" \
  -e DATTO_API_KEY=xxx \
  -e DATTO_API_SECRET=xxx \
  -e DATTO_PLATFORM=concord \
  -p 127.0.0.1:8080:8080 \
  datto-rmm-mcp

The token is written to a temporary .npmrc that is deleted in the same layer, so it is never baked into the image.

Note

The image defaults to MCP_TRANSPORT=http on port 8080. Publish it on loopback (-p 127.0.0.1:8080:8080) unless a proxy sits in front. Health check: curl http://127.0.0.1:8080/health (no credentials). HTTP will not start until CONDUIT_S2S_SECRET is a real secret.

Local HTTP without a secret is development-only. It binds 127.0.0.1 and logs a warning. A non-loopback MCP_HTTP_HOST makes startup exit:

bash
MCP_TRANSPORT=http MCP_ALLOW_INSECURE_DEV=1 npm start

License

Apache-2.0

Similar modules

Browse Application monitoring