@teamnetwork-nz/ninjaone-mcp-server 0.3.0 → 0.4.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -107,7 +107,7 @@ claude mcp add ninjaone \
107
107
  -- npx -y @teamnetwork-nz/ninjaone-mcp-server
108
108
  ```
109
109
 
110
- ## Available tools (24, all read-only)
110
+ ## Available tools (27, all read-only)
111
111
 
112
112
  ### Connection
113
113
  | Tool | Description |
@@ -125,13 +125,15 @@ claude mcp add ninjaone \
125
125
  | Tool | Description |
126
126
  |---|---|
127
127
  | `ninja_list_devices` | List machines — filter by org, location, class, online/offline, or raw `df` |
128
- | `ninja_get_device` | Full device record: identity, OS, system, role policy & policy override, last contact/boot, IPs |
128
+ | `ninja_search_devices` | Fleet search in one call with a total: name, OS (`osContains="Server 2022"`), org, class, role policy, tag, online, policy override. Rows lead with the device ID; backed by a 5-minute fleet snapshot |
129
+ | `ninja_get_device` | Full device record: identity, OS, system, role policy & policy-override sections, last contact/boot, IPs |
129
130
  | `ninja_get_device_disks` | Physical disks — model, capacity, SMART |
130
131
  | `ninja_get_device_volumes` | Logical volumes — capacity, free, % used |
131
132
  | `ninja_get_device_processors` | CPUs — cores, clock |
132
133
  | `ninja_get_device_network` | Network interfaces — IP/MAC/gateway/DNS |
133
134
  | `ninja_get_device_software` | Installed software inventory (system vs user component) |
134
- | `ninja_get_device_os_patches` | OS patch state |
135
+ | `ninja_get_device_os_patches` | OS patches pending/approved/rejected, with status, type and severity (filter by `status`/`type`/`severity`) |
136
+ | `ninja_explain_patch_status` | Evidence for why one KB has its status on one device: patch row, install history, role policy, `patchManagement` override, and the status split across peer devices |
135
137
  | `ninja_get_device_last_user` | Last logged-on user |
136
138
  | `ninja_get_device_activities` | Device activity log, newest first (200 default, page older with `after`) |
137
139
  | `ninja_get_device_custom_fields` | Custom field values |
@@ -144,7 +146,7 @@ claude mcp add ninjaone \
144
146
  | `ninja_query_computer_systems` | Make/model/serial/RAM per device |
145
147
  | `ninja_query_volumes` | Disk capacity/usage fleet-wide |
146
148
  | `ninja_query_antivirus_status` | AV product & protection status (one row per product per device); `multipleActiveProducts=true` lists devices with 2+ products ON |
147
- | `ninja_query_os_patches` | Pending OS patches fleet-wide |
149
+ | `ninja_query_os_patches` | Pending OS patches fleet-wide, with type; filter by `type`/`severity` |
148
150
 
149
151
  ### Alerts & activities
150
152
  | Tool | Description |
@@ -156,6 +158,7 @@ claude mcp add ninjaone \
156
158
  | Tool | Description |
157
159
  |---|---|
158
160
  | `ninja_list_policies` | List policies (id, name, node class) — resolves the names shown in `ninja_get_device`'s `rolePolicy` / `policyOverride` |
161
+ | `ninja_query_policy_overrides` | Devices with a device-level policy override and which sections (e.g. `patchManagement`) are overridden |
159
162
 
160
163
  ## Agent guidance
161
164
 
@@ -190,6 +193,14 @@ Use `json` when paging through results or computing over them (e.g. filtering
190
193
  Set `NINJAONE_FORMAT=json` to make JSON the server-wide default for headless/automation use.
191
194
  `ninja_test_connection` and all `get_*`/`list_*`/`query_*` tools support it.
192
195
 
196
+ ### Device names
197
+ NinjaOne's `systemName` is the 15-character NetBIOS name, so long hostnames arrive
198
+ truncated (`SALT-NZAKL-5CG140B0HF` → `SALT-NZAKL-5CG1`) and the NinjaOne portal's breadcrumb
199
+ shows the same truncated name. This server shows the full DNS host label whenever it is a
200
+ longer extension of that name, and appends `[id N]` in name-only tables when two devices
201
+ genuinely share a name. JSON output also carries `systemName` and `dnsName` plus the numeric
202
+ device id — key on the id, never the name.
203
+
193
204
  ### Argument names
194
205
  Arguments are camelCase: `ninja_get_device(deviceId=3)`. snake_case spellings
195
206
  (`device_id`) are accepted and converted.
@@ -240,6 +251,44 @@ is only whether the agent is online (🟢) or offline (🔴). A device can be on
240
251
  `multipleActiveProducts=true` to list only devices with **2+ products `ON`** (the genuine
241
252
  conflict case); it scans the whole result set server-side.
242
253
 
254
+ ### Patches and policies: what the API can and cannot tell you
255
+ NinjaOne's public API has **no get-policy endpoint** (`/v2/policies/{id}` is 404; the list
256
+ returns only id/name/class) and a patch row carries **no reason** for its status — only
257
+ `status`, `type`, `severity`, `kbNumber`. So a policy's patch rules and deferral windows
258
+ cannot be read, and "why is this KB MANUAL?" cannot be answered authoritatively. Use these
259
+ instead:
260
+
261
+ - `ninja_explain_patch_status(deviceId, kb)` gathers the available evidence: the device's patch
262
+ row, install history (an absent KB may simply be installed or not applicable), role policy
263
+ vs what the org maps the role to, any `patchManagement` override, and how the same KB is
264
+ distributed across devices on the same role policy / type / severity. It says explicitly
265
+ when the policy alone cannot explain a difference.
266
+ - **Role policy is not the whole story.** A device can override a policy *section*
267
+ (`patchManagement`) — `ninja_get_device` shows `policyOverride`, and
268
+ `ninja_query_policy_overrides` / `ninja_search_devices(policyOverride="patchManagement")`
269
+ list the devices. Two devices on the same role policy behave differently if one is overridden.
270
+ - Even without overrides, status is **not** a function of (policy, type, severity): on this
271
+ tenant the same KB on the same policy is split across MANUAL / DELAYED / APPROVED. Treat
272
+ status as per-device state; compare peers rather than expecting a rule lookup.
273
+ - Status meanings (NinjaOne semantics, not returned by the API): `MANUAL` = no rule
274
+ auto-approves it; `DELAYED` = a rule approves it after a deferral window; `APPROVED` = will
275
+ install at the next window. `os-patches` lists pending/approved/rejected patches only;
276
+ installed ones are in install history (`/v2/device/{id}/os-patch-installs`).
277
+ - NinjaOne's server-side `status` filter on patch queries is unreliable (`MANUAL` also returns
278
+ `DELAYED`; lowercase `manual` returns only `DELAYED`), so this server filters status
279
+ itself on the device tool and does not offer it on the fleet query. `type` and `severity`
280
+ filters are exact.
281
+
282
+ ### Finding devices and stable identifiers
283
+ Per-device tools take the numeric `deviceId` only — never a name — because names are not
284
+ unique or stable (see above). To go from a hostname to an id, or to ask fleet questions such
285
+ as "how many Server 2022 devices does org X have?", call `ninja_search_devices`: it matches
286
+ name / OS / org / class / policy / tag in one call (all devices are fetched in a single
287
+ ~0.5 s request and reused for 5 minutes; pass `refresh=true` after a change). For the
288
+ `ninja_query_*` fleet reports pass `pageSize=1000` — the default of 100 is why a full
289
+ listing otherwise needs many pages. Device IDs appear in every table that
290
+ lists devices.
291
+
243
292
  ### Alerts
244
293
  `ninja_list_alerts` supports client-side `severity`, `priority`, `sourceType` and `since`
245
294
  filters and always reports `N of M active alerts in scope`, so an empty result can be told
package/dist/client.d.ts CHANGED
@@ -1,4 +1,5 @@
1
1
  import { NinjaConfig } from './config.js';
2
+ import { Device } from './types.js';
2
3
  export interface DeviceFilterOptions {
3
4
  organizationId?: number | string;
4
5
  locationId?: number | string;
@@ -21,6 +22,8 @@ export declare class NinjaClient {
21
22
  private locationNameCache;
22
23
  private deviceLabelCache;
23
24
  private policyNameCache;
25
+ private deviceSnapshot;
26
+ private overrideSnapshot;
24
27
  constructor(config: NinjaConfig);
25
28
  authenticate(): Promise<void>;
26
29
  private ensureToken;
@@ -39,14 +42,25 @@ export declare class NinjaClient {
39
42
  buildPaging(paging?: PagingParams): Record<string, unknown>;
40
43
  buildDeviceFilter(opts?: DeviceFilterOptions): string | undefined;
41
44
  private ensureOrgCache;
45
+ private loadOrgCache;
42
46
  private ensureLocationCache;
47
+ private loadLocationCache;
43
48
  resolveOrgName(id: number | undefined): Promise<string>;
44
49
  resolveTeamlinkId(id: number | undefined): Promise<string>;
45
50
  resolveLocationName(id: number | undefined): Promise<string>;
46
51
  private ensureDeviceCache;
52
+ private loadDeviceCache;
47
53
  resolveDeviceLabel(id: number | undefined): Promise<string>;
48
54
  private ensurePolicyCache;
55
+ private loadPolicyCache;
49
56
  resolvePolicyName(id: number | undefined): Promise<string>;
50
57
  clearNameCaches(): void;
58
+ getAllQueryRows<T>(path: string, params?: Record<string, unknown>, maxRows?: number): Promise<T[]>;
59
+ getDeviceSnapshot(refresh?: boolean): Promise<{
60
+ devices: Device[];
61
+ fetchedAt: number;
62
+ }>;
63
+ getPolicyOverrides(refresh?: boolean): Promise<Map<number, string[]>>;
64
+ getDeviceOverrides(deviceId: number): Promise<string[]>;
51
65
  }
52
66
  //# sourceMappingURL=client.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAI1C,MAAM,WAAW,mBAAmB;IAClC,cAAc,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACjC,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC7B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAKD,eAAO,MAAM,cAAc,QAI8F,CAAC;AAE1H,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;CACzB;AAED,qBAAa,WAAW;IACtB,OAAO,CAAC,IAAI,CAAgB;IAC5B,OAAO,CAAC,MAAM,CAAc;IAC5B,OAAO,CAAC,WAAW,CAAuB;IAC1C,OAAO,CAAC,cAAc,CAAK;IAC3B,OAAO,CAAC,YAAY,CAAuB;IAG3C,OAAO,CAAC,YAAY,CAAoC;IACxD,OAAO,CAAC,iBAAiB,CAAoC;IAC7D,OAAO,CAAC,gBAAgB,CAAoC;IAC5D,OAAO,CAAC,eAAe,CAAoC;gBAE/C,MAAM,EAAE,WAAW;IAUzB,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC;YA2CrB,WAAW;IAMzB,OAAO,CAAC,UAAU;IAKlB,eAAe,IAAI,MAAM,GAAG,IAAI;IAIhC,UAAU,IAAI,MAAM;IAIpB,kBAAkB,IAAI,MAAM;YAMd,OAAO;IAkDrB,WAAW,IAAI,OAAO;IAItB,OAAO,CAAC,oBAAoB;IAQtB,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAIlE,IAAI,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC;IAKhD,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC;IAKhD,KAAK,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC;IAKjD,MAAM,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC;IAOzC,WAAW,CAAC,MAAM,CAAC,EAAE,YAAY,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAS3D,iBAAiB,CAAC,IAAI,CAAC,EAAE,mBAAmB,GAAG,MAAM,GAAG,SAAS;YAenD,cAAc;YAed,mBAAmB;IAe3B,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC;IAQvD,iBAAiB,CAAC,EAAE,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC;IAM1D,mBAAmB,CAAC,EAAE,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC;YAMpD,iBAAiB;IAsBzB,kBAAkB,CAAC,EAAE,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC;YAMnD,iBAAiB;IAezB,iBAAiB,CAAC,EAAE,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC;IAOhE,eAAe,IAAI,IAAI;CAMxB"}
1
+ {"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"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"}
package/dist/client.js CHANGED
@@ -1,5 +1,6 @@
1
1
  import axios from 'axios';
2
2
  import { extractTeamlinkId } from './teamlink.js';
3
+ import { deviceName } from './format.js';
3
4
  // Device-filter (df) syntax verified live against the oc tenant (2026-10-03). NinjaOne
4
5
  // answers an unrecognised field/operator with a bare `500 FAILURE`, so this text is both
5
6
  // the tool-schema documentation and the hint appended to df errors.
@@ -7,6 +8,8 @@ export const DF_SYNTAX_HELP = 'Supported fields: org, loc, class, role, id, stat
7
8
  'Operators: = / eq, <> / neq, in (a,b). Combine with AND (OR is unreliable — use `in (...)` instead). ' +
8
9
  'Examples: "offline", "org = 4 AND offline", "class in (WINDOWS_SERVER, MAC)", "status eq APPROVED". ' +
9
10
  'NOT supported: last-contact age, free space, name, tags, policy, group, health, "not"/"!" — filter those client-side.';
11
+ // How long the fleet-wide device snapshot / override map is reused before refetching.
12
+ const FLEET_TTL_MS = 5 * 60_000;
10
13
  export class NinjaClient {
11
14
  http;
12
15
  config;
@@ -14,10 +17,15 @@ export class NinjaClient {
14
17
  tokenExpiresAt = 0; // epoch millis
15
18
  grantedScope = null;
16
19
  // In-memory name caches, populated on first use (see resolveOrgName / resolveLocationName).
20
+ // Held as promises so concurrent resolvers (e.g. Promise.all over a page of devices)
21
+ // share one fetch instead of each triggering their own.
17
22
  orgNameCache = null;
18
23
  locationNameCache = null;
19
24
  deviceLabelCache = null;
20
25
  policyNameCache = null;
26
+ // Fleet-wide snapshots (see getDeviceSnapshot / getPolicyOverrides), reused for FLEET_TTL_MS.
27
+ deviceSnapshot = null;
28
+ overrideSnapshot = null;
21
29
  constructor(config) {
22
30
  this.config = config;
23
31
  this.http = axios.create({
@@ -178,9 +186,10 @@ export class NinjaClient {
178
186
  return clauses.join(' AND ');
179
187
  }
180
188
  // ---- Org / location name resolution (cached) ------------------------------
181
- async ensureOrgCache() {
182
- if (this.orgNameCache)
183
- return this.orgNameCache;
189
+ ensureOrgCache() {
190
+ return (this.orgNameCache ??= this.loadOrgCache());
191
+ }
192
+ async loadOrgCache() {
184
193
  const cache = new Map();
185
194
  try {
186
195
  const orgs = await this.get('/v2/organizations', { pageSize: 1000 });
@@ -192,12 +201,12 @@ export class NinjaClient {
192
201
  catch {
193
202
  // Leave cache empty on failure; callers fall back to raw ids.
194
203
  }
195
- this.orgNameCache = cache;
196
204
  return cache;
197
205
  }
198
- async ensureLocationCache() {
199
- if (this.locationNameCache)
200
- return this.locationNameCache;
206
+ ensureLocationCache() {
207
+ return (this.locationNameCache ??= this.loadLocationCache());
208
+ }
209
+ async loadLocationCache() {
201
210
  const cache = new Map();
202
211
  try {
203
212
  const locs = await this.get('/v2/locations', { pageSize: 1000 });
@@ -209,7 +218,6 @@ export class NinjaClient {
209
218
  catch {
210
219
  // ignore
211
220
  }
212
- this.locationNameCache = cache;
213
221
  return cache;
214
222
  }
215
223
  async resolveOrgName(id) {
@@ -232,9 +240,10 @@ export class NinjaClient {
232
240
  const cache = await this.ensureLocationCache();
233
241
  return cache.get(id) ?? String(id);
234
242
  }
235
- async ensureDeviceCache() {
236
- if (this.deviceLabelCache)
237
- return this.deviceLabelCache;
243
+ ensureDeviceCache() {
244
+ return (this.deviceLabelCache ??= this.loadDeviceCache());
245
+ }
246
+ async loadDeviceCache() {
238
247
  const cache = new Map();
239
248
  try {
240
249
  // Page through every device (1000/page); unresolved ids fall back to the raw id.
@@ -243,7 +252,7 @@ export class NinjaClient {
243
252
  const devices = await this.get('/v2/devices', { pageSize: 1000, ...(after ? { after } : {}) });
244
253
  for (const d of devices ?? []) {
245
254
  if (d.id !== undefined)
246
- cache.set(d.id, d.displayName ?? d.systemName ?? d.dnsName ?? String(d.id));
255
+ cache.set(d.id, deviceName(d) || String(d.id));
247
256
  }
248
257
  if (!devices || devices.length < 1000)
249
258
  break;
@@ -251,11 +260,18 @@ export class NinjaClient {
251
260
  if (after === undefined)
252
261
  break;
253
262
  }
263
+ // Genuinely duplicated names (case-insensitive) get their id appended so rows in
264
+ // name-only tables stay distinguishable.
265
+ const counts = new Map();
266
+ for (const n of cache.values())
267
+ counts.set(n.toLowerCase(), (counts.get(n.toLowerCase()) ?? 0) + 1);
268
+ for (const [id, n] of cache)
269
+ if ((counts.get(n.toLowerCase()) ?? 0) > 1)
270
+ cache.set(id, `${n} [id ${id}]`);
254
271
  }
255
272
  catch {
256
273
  // ignore
257
274
  }
258
- this.deviceLabelCache = cache;
259
275
  return cache;
260
276
  }
261
277
  async resolveDeviceLabel(id) {
@@ -264,9 +280,10 @@ export class NinjaClient {
264
280
  const cache = await this.ensureDeviceCache();
265
281
  return cache.get(id) ?? String(id);
266
282
  }
267
- async ensurePolicyCache() {
268
- if (this.policyNameCache)
269
- return this.policyNameCache;
283
+ ensurePolicyCache() {
284
+ return (this.policyNameCache ??= this.loadPolicyCache());
285
+ }
286
+ async loadPolicyCache() {
270
287
  const cache = new Map();
271
288
  try {
272
289
  const policies = await this.get('/v2/policies');
@@ -278,7 +295,6 @@ export class NinjaClient {
278
295
  catch {
279
296
  // ignore
280
297
  }
281
- this.policyNameCache = cache;
282
298
  return cache;
283
299
  }
284
300
  async resolvePolicyName(id) {
@@ -293,6 +309,72 @@ export class NinjaClient {
293
309
  this.locationNameCache = null;
294
310
  this.deviceLabelCache = null;
295
311
  this.policyNameCache = null;
312
+ this.deviceSnapshot = null;
313
+ this.overrideSnapshot = null;
314
+ }
315
+ // ---- Fleet snapshots ------------------------------------------------------
316
+ // Page through a whole /v2/queries/* report (1000 rows/page, cursor-driven). NinjaOne omits
317
+ // the cursor when everything fits in one page. Bounded so a runaway tenant cannot loop.
318
+ async getAllQueryRows(path, params = {}, maxRows = 20000) {
319
+ const rows = [];
320
+ let cursor;
321
+ while (rows.length < maxRows) {
322
+ const resp = await this.get(path, {
323
+ ...params,
324
+ pageSize: 1000,
325
+ ...(cursor ? { cursor } : {}),
326
+ });
327
+ const got = resp?.results ?? [];
328
+ rows.push(...got);
329
+ const next = resp?.cursor?.name;
330
+ if (!got.length || !next || (resp.cursor?.offset ?? 0) + got.length >= (resp.cursor?.count ?? 0))
331
+ break;
332
+ cursor = next;
333
+ }
334
+ return rows;
335
+ }
336
+ // Every device with OS / role policy / tags in one pass (/v2/devices-detailed, ~0.5s and
337
+ // ~1.4MB for 834 devices). Cached for FLEET_TTL_MS; pass refresh=true to force a refetch.
338
+ async getDeviceSnapshot(refresh = false) {
339
+ const s = this.deviceSnapshot;
340
+ if (!refresh && s && Date.now() - s.at < FLEET_TTL_MS)
341
+ return { devices: s.devices, fetchedAt: s.at };
342
+ const devices = [];
343
+ let after;
344
+ for (let page = 0; page < 50; page++) {
345
+ const batch = await this.get('/v2/devices-detailed', {
346
+ pageSize: 1000,
347
+ ...(after !== undefined ? { after } : {}),
348
+ });
349
+ devices.push(...(batch ?? []));
350
+ if (!batch || batch.length < 1000)
351
+ break;
352
+ after = batch[batch.length - 1]?.id;
353
+ if (after === undefined)
354
+ break;
355
+ }
356
+ this.deviceSnapshot = { at: Date.now(), devices };
357
+ return { devices, fetchedAt: this.deviceSnapshot.at };
358
+ }
359
+ // deviceId → policy sections overridden on that device (e.g. ["patchManagement"]); devices
360
+ // with no override are absent. Cached like the device snapshot.
361
+ async getPolicyOverrides(refresh = false) {
362
+ const s = this.overrideSnapshot;
363
+ if (!refresh && s && Date.now() - s.at < FLEET_TTL_MS)
364
+ return s.map;
365
+ const rows = await this.getAllQueryRows('/v2/queries/policy-overrides');
366
+ const map = new Map();
367
+ for (const r of rows) {
368
+ if (r.deviceId !== undefined && r.overrides?.length)
369
+ map.set(r.deviceId, r.overrides);
370
+ }
371
+ this.overrideSnapshot = { at: Date.now(), map };
372
+ return map;
373
+ }
374
+ // Policy sections overridden on one device. NinjaOne returns {"overrides": null} when none.
375
+ async getDeviceOverrides(deviceId) {
376
+ const r = await this.get(`/v2/device/${deviceId}/policy/overrides`);
377
+ return r?.overrides ?? [];
296
378
  }
297
379
  }
298
380
  //# sourceMappingURL=client.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"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"}
package/dist/format.d.ts CHANGED
@@ -1,7 +1,8 @@
1
- import type { ToolResult } from './types.js';
1
+ import type { ToolResult, Device } from './types.js';
2
2
  export declare function humanBytes(bytes: number | undefined | null): string;
3
3
  export declare function formatClock(value: number | undefined | null): string;
4
4
  export declare function joinList(value: unknown): string;
5
+ export declare function deviceName(d: Pick<Device, 'displayName' | 'systemName' | 'dnsName'>): string;
5
6
  export declare function percentUsedNum(free: number | undefined, capacity: number | undefined): number | null;
6
7
  export declare function percentUsed(free: number | undefined, capacity: number | undefined): string;
7
8
  export declare function toList(value: unknown): string[];
@@ -1 +1 @@
1
- {"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../src/format.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAG7C,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,GAAG,MAAM,CAOnE;AAID,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,GAAG,MAAM,CAIpE;AAID,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAK/C;AAGD,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,EAAE,QAAQ,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,IAAI,CAGpG;AAGD,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,EAAE,QAAQ,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAG1F;AAGD,wBAAgB,MAAM,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,EAAE,CAI/C;AAMD,MAAM,WAAW,MAAM,CAAC,CAAC;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,OAAO,CAAC;IAC5B,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,MAAM,CAAC;IAC9B,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,YAAY;IAC3B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAOD,wBAAgB,WAAW,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,IAAI,GAAE,YAAiB,GAAG,UAAU,CAYhH;AAGD,wBAAgB,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,GAAG,MAAM,CAUhF;AAID,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAK/E"}
1
+ {"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../src/format.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAGrD,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,GAAG,MAAM,CAOnE;AAID,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,GAAG,MAAM,CAIpE;AAID,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAK/C;AAMD,wBAAgB,UAAU,CAAC,CAAC,EAAE,IAAI,CAAC,MAAM,EAAE,aAAa,GAAG,YAAY,GAAG,SAAS,CAAC,GAAG,MAAM,CAK5F;AAGD,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,EAAE,QAAQ,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,IAAI,CAGpG;AAGD,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,EAAE,QAAQ,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAG1F;AAGD,wBAAgB,MAAM,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,EAAE,CAI/C;AAMD,MAAM,WAAW,MAAM,CAAC,CAAC;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,OAAO,CAAC;IAC5B,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,MAAM,CAAC;IAC9B,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,YAAY;IAC3B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAOD,wBAAgB,WAAW,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,IAAI,GAAE,YAAiB,GAAG,UAAU,CAYhH;AAGD,wBAAgB,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,GAAG,MAAM,CAUhF;AAID,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAK/E"}
package/dist/format.js CHANGED
@@ -31,6 +31,17 @@ export function joinList(value) {
31
31
  return '';
32
32
  return String(value);
33
33
  }
34
+ // Best human label for a device. NinjaOne's systemName is the 15-character NetBIOS name,
35
+ // so long hostnames arrive truncated ("SALT-NZAKL-5CG1" for SALT-NZAKL-5CG140B0HF) and
36
+ // several machines collapse to one name. When the DNS host label is a longer extension of
37
+ // that name, use it; otherwise displayName ?? systemName ?? dnsName.
38
+ export function deviceName(d) {
39
+ const name = d.displayName ?? d.systemName ?? d.dnsName ?? '';
40
+ const host = (d.dnsName ?? '').split('.')[0];
41
+ if (host.length > name.length && host.toUpperCase().startsWith(name.toUpperCase()))
42
+ return host;
43
+ return name;
44
+ }
34
45
  // Percent used given free & capacity (both bytes), as a number (null when unknowable).
35
46
  export function percentUsedNum(free, capacity) {
36
47
  if (!capacity || free === undefined)
@@ -1 +1 @@
1
- {"version":3,"file":"format.js","sourceRoot":"","sources":["../src/format.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"format.js","sourceRoot":"","sources":["../src/format.ts"],"names":[],"mappings":"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"}
package/dist/index.js CHANGED
@@ -17,57 +17,57 @@ function camelCaseKeys(args) {
17
17
  }
18
18
  const config = loadConfig();
19
19
  const client = new NinjaClient(config);
20
- const server = new Server({ name: 'ninjaone-mcp-server', version: '0.3.0' }, {
20
+ const server = new Server({ name: 'ninjaone-mcp-server', version: '0.4.0' }, {
21
21
  capabilities: { tools: {} },
22
- instructions: `
23
- NinjaOne RMM MCP server — remote monitoring and management via the NinjaOne Public API v2.
24
-
25
- ## Mode
26
- - Read-only by default (Phase 1 exposes only read tools). Write operations require NINJAONE_READWRITE=true, and the API app must hold the "management" scope.
27
- - Check the startup banner / ninja_test_connection for the active mode and granted scope.
28
-
29
- ## Hierarchy
30
- - Devices belong to an Organization (the client) and a Location. Call ninja_list_organizations first to discover organization ids, then filter devices with organizationId.
31
- - Organization and location ids are resolved to names automatically (cached).
32
-
33
- ## Device filtering
34
- - ninja_list_devices and the ninja_query_* tools accept organizationId, locationId, deviceClass, online, or a raw NinjaOne device-filter (df) via deviceFilter.
35
- - Device classes include WINDOWS_WORKSTATION, WINDOWS_SERVER, MAC, LINUX_SERVER, etc.
36
- - deviceFilter (df) accepts ONLY: fields org, loc, class, role, id, status; keywords online / offline (lowercase); operators = / eq, <> / neq, in (a,b); joined with AND. Examples: "offline", "org = 4 AND offline", "class in (WINDOWS_SERVER, MAC)". OR is unreliable (use in (...)). Anything else (last-contact age, free space, name, tags, policy, health, "not") makes NinjaOne return an opaque 500 — filter those client-side from the returned rows.
37
-
38
- ## Common workflows
39
-
40
- ### Find a machine
41
- ninja_list_devices with organizationId (and optionally deviceClass or online).
42
-
43
- ### Inspect one machine
44
- - ninja_get_device — identity, OS, system, last contact/boot, rolePolicy & policyOverride.
45
- - ninja_get_device_volumes / _disks / _processors / _network — hardware & capacity.
46
- - ninja_get_device_software / _os_patches — inventory & patch state.
47
-
48
- ### Policy assignment
49
- - ninja_get_device reports rolePolicy (inherited from org/location + device role) and policyOverride (device-specific override, if any — usually "(none — inherits role policy)").
50
- - ninja_list_policies resolves policy ids/names for reference.
51
-
52
- ### Fleet stats & reporting
53
- - ninja_query_device_health — health rollup, ONE ROW PER DEVICE (its footer total is the fleet device count). "Health" is NinjaOne's HEALTHY/NEEDS_ATTENTION/UNHEALTHY/UNKNOWN bucket; "Connectivity" is just online/offline and is independent of Health. Drive alerting from Health plus the alert/patch/threat/vuln counts.
54
- - ninja_query_volumes — disk capacity/usage fleet-wide (one row per VOLUME, several per device).
55
- - ninja_query_operating_systems / _computer_systems — one row per device.
56
- - ninja_query_antivirus_status / _os_patches — one row per AV product / patch per device, so totals are record counts, not device counts. antivirus_status has multipleActiveProducts=true to find devices running 2+ AV products ON.
57
-
58
- ### Alerts
59
- - ninja_list_alerts — currently triggered conditions (scope by device or org; filter by severity/priority/sourceType/since). The footer reports "N of M in scope", so an empty result is distinguishable from "nothing active".
60
-
61
- ## Pagination
62
- - List tools use cursor pagination: pass the reported after=<id>. ninja_list_devices/organizations have no total — page until a short page returns.
63
- - ninja_query_* tools return a cursor name; pass it back as cursor=<name>. The name is the same on every page — NinjaOne holds the position server-side and each call advances it, so never reuse a cursor to repeat a page. The footer states "rows X–Y of TOTAL".
64
- - Tool arguments are camelCase (deviceId); snake_case (device_id) is also accepted.
65
-
66
- ## Output format
67
- - Every tool takes format="markdown" | "json". Markdown = readable tables for presenting to a person. JSON = the same data, typed (raw numbers/booleans, ISO-8601 UTC timestamps) with totals and cursors as fields (total, hasMore, nextCursor / nextAfter) — choose it when paging through results or computing over them. Omit it to use the server default (NINJAONE_FORMAT).
68
-
69
- ## Datetime
70
- - All NinjaOne timestamps are UTC (ISO or epoch). The server renders them in NINJAONE_DATETIMEFORMAT (default: system local). Present values as-is.
22
+ instructions: `
23
+ NinjaOne RMM MCP server — remote monitoring and management via the NinjaOne Public API v2.
24
+
25
+ ## Mode
26
+ - Read-only by default (Phase 1 exposes only read tools). Write operations require NINJAONE_READWRITE=true, and the API app must hold the "management" scope.
27
+ - Check the startup banner / ninja_test_connection for the active mode and granted scope.
28
+
29
+ ## Hierarchy
30
+ - Devices belong to an Organization (the client) and a Location. Call ninja_list_organizations first to discover organization ids, then filter devices with organizationId.
31
+ - Organization and location ids are resolved to names automatically (cached).
32
+
33
+ ## Device filtering
34
+ - ninja_list_devices and the ninja_query_* tools accept organizationId, locationId, deviceClass, online, or a raw NinjaOne device-filter (df) via deviceFilter.
35
+ - Device classes include WINDOWS_WORKSTATION, WINDOWS_SERVER, MAC, LINUX_SERVER, etc.
36
+ - deviceFilter (df) accepts ONLY: fields org, loc, class, role, id, status; keywords online / offline (lowercase); operators = / eq, <> / neq, in (a,b); joined with AND. Examples: "offline", "org = 4 AND offline", "class in (WINDOWS_SERVER, MAC)". OR is unreliable (use in (...)). Anything else (last-contact age, free space, name, tags, policy, health, "not") makes NinjaOne return an opaque 500 — filter those client-side from the returned rows.
37
+
38
+ ## Common workflows
39
+
40
+ ### Find a machine
41
+ ninja_list_devices with organizationId (and optionally deviceClass or online).
42
+
43
+ ### Inspect one machine
44
+ - ninja_get_device — identity, OS, system, last contact/boot, rolePolicy & policyOverride.
45
+ - ninja_get_device_volumes / _disks / _processors / _network — hardware & capacity.
46
+ - ninja_get_device_software / _os_patches — inventory & patch state.
47
+
48
+ ### Policy assignment
49
+ - ninja_get_device reports rolePolicy (inherited from org/location + device role) and policyOverride (device-specific override, if any — usually "(none — inherits role policy)").
50
+ - ninja_list_policies resolves policy ids/names for reference.
51
+
52
+ ### Fleet stats & reporting
53
+ - ninja_query_device_health — health rollup, ONE ROW PER DEVICE (its footer total is the fleet device count). "Health" is NinjaOne's HEALTHY/NEEDS_ATTENTION/UNHEALTHY/UNKNOWN bucket; "Connectivity" is just online/offline and is independent of Health. Drive alerting from Health plus the alert/patch/threat/vuln counts.
54
+ - ninja_query_volumes — disk capacity/usage fleet-wide (one row per VOLUME, several per device).
55
+ - ninja_query_operating_systems / _computer_systems — one row per device.
56
+ - ninja_query_antivirus_status / _os_patches — one row per AV product / patch per device, so totals are record counts, not device counts. antivirus_status has multipleActiveProducts=true to find devices running 2+ AV products ON.
57
+
58
+ ### Alerts
59
+ - ninja_list_alerts — currently triggered conditions (scope by device or org; filter by severity/priority/sourceType/since). The footer reports "N of M in scope", so an empty result is distinguishable from "nothing active".
60
+
61
+ ## Pagination
62
+ - List tools use cursor pagination: pass the reported after=<id>. ninja_list_devices/organizations have no total — page until a short page returns.
63
+ - ninja_query_* tools return a cursor name; pass it back as cursor=<name>. The name is the same on every page — NinjaOne holds the position server-side and each call advances it, so never reuse a cursor to repeat a page. The footer states "rows X–Y of TOTAL".
64
+ - Tool arguments are camelCase (deviceId); snake_case (device_id) is also accepted.
65
+
66
+ ## Output format
67
+ - Every tool takes format="markdown" | "json". Markdown = readable tables for presenting to a person. JSON = the same data, typed (raw numbers/booleans, ISO-8601 UTC timestamps) with totals and cursors as fields (total, hasMore, nextCursor / nextAfter) — choose it when paging through results or computing over them. Omit it to use the server default (NINJAONE_FORMAT).
68
+
69
+ ## Datetime
70
+ - All NinjaOne timestamps are UTC (ISO or epoch). The server renders them in NINJAONE_DATETIMEFORMAT (default: system local). Present values as-is.
71
71
  `.trim(),
72
72
  });
73
73
  server.setRequestHandler(ListToolsRequestSchema, async () => ({
@@ -62,7 +62,7 @@ export const alertTools = [
62
62
  `${filters.length ? ` match ${filters.join(', ')}` : ''}._`;
63
63
  const items = await Promise.all(filtered.map(async (a) => ({ ...a, device: await client.resolveDeviceLabel(a.deviceId) })));
64
64
  const cols = [
65
- { header: 'Device ID', key: 'deviceId', value: (a) => a.deviceId ?? null, jsonOnly: true },
65
+ { header: 'Device ID', key: 'deviceId', value: (a) => a.deviceId ?? null },
66
66
  { header: 'Device', key: 'device', value: (a) => a.device },
67
67
  { header: 'Severity', key: 'severity', value: (a) => a.severity ?? null },
68
68
  { header: 'Priority', key: 'priority', value: (a) => a.priority ?? null },
@@ -108,7 +108,7 @@ export const alertTools = [
108
108
  const cols = [
109
109
  { header: 'ID', key: 'id', value: (a) => a.id ?? null, jsonOnly: true },
110
110
  { header: 'Time', key: 'time', value: (a) => toIso(a.activityTime), display: (a) => fromUtc(a.activityTime) },
111
- { header: 'Device ID', key: 'deviceId', value: (a) => a.deviceId ?? null, jsonOnly: true },
111
+ { header: 'Device ID', key: 'deviceId', value: (a) => a.deviceId ?? null },
112
112
  { header: 'Device', key: 'device', value: (a) => a.device },
113
113
  { header: 'Type', key: 'type', value: (a) => a.activityType ?? a.type ?? null },
114
114
  { header: 'Status', key: 'status', value: (a) => a.status ?? a.statusCode ?? null },