mcp-ninjaone

Instructions

Implementation Reference

• src/tools/maintenance.ts:93-105 (handler)

  Handler function for cancel_device_maintenance tool. Makes a DELETE request to /device/{device_id}/maintenance endpoint to cancel the maintenance window and re-enable alerting.

  async ({ device_id }) => {
    try {
      await client.delete(`/device/${device_id}/maintenance`);
      return toolResult(
        `Maintenance window cancelled for device ${device_id}. Alerting is now re-enabled.`,
      );
    } catch (error) {
      return toolResult(
        `Error cancelling maintenance window: ${error}`,
        true,
      );
    }
  },

• src/tools/maintenance.ts:88-91 (schema)

  Zod schema definition for the cancel_device_maintenance tool input. Defines device_id as a required number parameter describing the NinjaOne device ID.

  {
    device_id: z
      .number()
      .describe("NinjaOne device ID to remove from maintenance"),

• src/tools/maintenance.ts:85-106 (registration)

  Registration of cancel_device_maintenance tool with MCP server. Includes tool name, description, input schema, and handler function.

  server.tool(
    "cancel_device_maintenance",
    "Cancel an active maintenance window for a device, immediately re-enabling alerting.",
    {
      device_id: z
        .number()
        .describe("NinjaOne device ID to remove from maintenance"),
    },
    async ({ device_id }) => {
      try {
        await client.delete(`/device/${device_id}/maintenance`);
        return toolResult(
          `Maintenance window cancelled for device ${device_id}. Alerting is now re-enabled.`,
        );
      } catch (error) {
        return toolResult(
          `Error cancelling maintenance window: ${error}`,
          true,
        );
      }
    },
  );