@owine/unifi-protect-mcp 2.12.0 → 2.13.0

package/README.md

@@ -1,6 +1,6 @@
 # UniFi Protect MCP Server
 
-An MCP (Model Context Protocol) server that exposes UniFi Protect's Integration REST API as tools for Claude Code and other MCP clients. Aligned with UniFi Protect API **7.1.83** — 73 tools covering cameras, lights, sensors, chimes, viewers, sirens, fobs, relays, speakers, bridges, link stations, alarm hubs, arm profiles, live views, files, users, NVR status, and WebSocket subscriptions.
+An MCP (Model Context Protocol) server that exposes UniFi Protect's Integration REST API as tools for Claude Code and other MCP clients. Aligned with UniFi Protect API **7.3.47** — 74 tools covering cameras, lights, sensors, chimes, viewers, sirens, fobs, relays, speakers, bridges, link stations, alarm hubs, arm profiles, live views, files, users, point-of-sale events, NVR status, and WebSocket subscriptions.
 
 ## Prerequisites
 
@@ -225,6 +225,11 @@ This server provides layered safety controls for responsible operation:
 | `protect_list_ulp_users` | List UniFi Identity (ULP) users with enrolled credentials |
 | `protect_get_ulp_user` | Get a UniFi Identity user by ID |
 
+### Point of Sale (1)
+| Tool | Description |
+|---|---|
+| `protect_ingest_pos_transaction` | Record a POS transaction as a camera event so it can be overlaid on recorded footage |
+
 ## Development
 
 The Node version used for development is pinned in `.nvmrc`. With [fnm](https://github.com/Schniz/fnm) installed, `fnm use` reads it automatically on `cd`.

package/dist/schemas/cameras.d.ts

@@ -1,4 +1,6 @@
 export declare const cameraSchema: import("zod").ZodObject<{
+    type: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+    guid: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
     id: import("zod").ZodOptional<import("zod").ZodString>;
     mac: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
     name: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
@@ -43,6 +45,8 @@ export declare const cameraSchema: import("zod").ZodObject<{
     }, import("zod/v4/core").$loose>>;
 }, import("zod/v4/core").$loose>;
 export declare const cameraOutputSchema: {
+    type: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+    guid: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
     id: import("zod").ZodOptional<import("zod").ZodString>;
     mac: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
     name: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
@@ -88,6 +92,8 @@ export declare const cameraOutputSchema: {
 };
 export declare const cameraListOutputSchema: {
     result: import("zod").ZodArray<import("zod").ZodObject<{
+        type: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+        guid: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
         id: import("zod").ZodOptional<import("zod").ZodString>;
         mac: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
         name: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;

package/dist/schemas/cameras.js

@@ -3,7 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.talkbackSessionOutputSchema = exports.rtspStreamOutputSchema = exports.rtspStreamSchema = exports.cameraListOutputSchema = exports.cameraOutputSchema = exports.cameraSchema = void 0;
 const common_js_1 = require("./common.js");
 /**
- * Verified against live UniFi Protect Integration API 7.1.83 (2026-06-20).
+ * Verified against live UniFi Protect Integration API 7.3.47 (2026-09-14).
  * The Integration API camera object is far smaller than the internal Protect
  * app's camera model — no isRecording/lastMotion/channels/firmwareVersion/etc.
  * `list` and `get-by-id` return the same field set (confirmed live).
@@ -47,6 +47,7 @@ exports.cameraSchema = (0, common_js_1.passthroughObject)({
     name: (0, common_js_1.nullableString)("Camera name"),
     modelKey: (0, common_js_1.nullableString)('Always "camera"'),
     state: (0, common_js_1.nullableString)("CONNECTED | DISCONNECTED | ..."),
+    ...(0, common_js_1.hardwareModelFields)(),
     activePatrolSlot: (0, common_js_1.unknownField)("Active PTZ patrol slot, or null (number|null)"),
     hasPackageCamera: (0, common_js_1.unknownField)("Has a secondary package camera (boolean)"),
     hdrType: (0, common_js_1.nullableString)('HDR mode, e.g. "auto"'),

package/dist/schemas/common.d.ts

@@ -32,6 +32,19 @@ export declare function idField(description?: string): z.ZodOptional<z.ZodString
  * type hint to clients while never failing validation on an API null.
  */
 export declare function nullableString(description: string): z.ZodOptional<z.ZodNullable<z.ZodString>>;
+/**
+ * Hardware-model fields that Protect 7.3.x added to every device resource and
+ * to the NVR.
+ *
+ * VERIFIED LIVE (7.3.47): `guid` identifies the hardware MODEL, not the unit.
+ * Three "UVC G6 Turret" cameras on the test console all return the same guid,
+ * as do two "UP Chime PoE" chimes. Despite the name, it is NOT a per-device
+ * identifier — `id` remains the only device identity.
+ */
+export declare function hardwareModelFields(): {
+    type: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    guid: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+};
 /** Output-schema shape for list endpoints that return a top-level array. */
 export declare function listResultSchema<T extends z.ZodTypeAny>(itemSchema: T): {
     result: z.ZodArray<T>;

package/dist/schemas/common.js

@@ -4,6 +4,7 @@ exports.passthroughObject = passthroughObject;
 exports.unknownField = unknownField;
 exports.idField = idField;
 exports.nullableString = nullableString;
+exports.hardwareModelFields = hardwareModelFields;
 exports.listResultSchema = listResultSchema;
 const zod_1 = require("zod");
 /**
@@ -47,6 +48,22 @@ function idField(description = "Resource ID") {
 function nullableString(description) {
     return zod_1.z.string().nullable().optional().describe(description);
 }
+/**
+ * Hardware-model fields that Protect 7.3.x added to every device resource and
+ * to the NVR.
+ *
+ * VERIFIED LIVE (7.3.47): `guid` identifies the hardware MODEL, not the unit.
+ * Three "UVC G6 Turret" cameras on the test console all return the same guid,
+ * as do two "UP Chime PoE" chimes. Despite the name, it is NOT a per-device
+ * identifier — `id` remains the only device identity.
+ */
+function hardwareModelFields() {
+    return {
+        type: nullableString('Hardware model name, e.g. "UVC G6 Turret", "UP Chime PoE", "UNVR-PRO"'),
+        guid: nullableString("Hardware MODEL GUID, shared by every unit of the same model. NOT a " +
+            "per-device identifier — use `id` to identify a device."),
+    };
+}
 /** Output-schema shape for list endpoints that return a top-level array. */
 function listResultSchema(itemSchema) {
     return {

package/dist/schemas/devices.d.ts

@@ -1,4 +1,6 @@
 export declare const lightSchema: import("zod").ZodObject<{
+    type: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+    guid: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
     id: import("zod").ZodOptional<import("zod").ZodString>;
     modelKey: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
     name: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
@@ -14,12 +16,15 @@ export declare const lightSchema: import("zod").ZodObject<{
     camera: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
 }, import("zod/v4/core").$loose>;
 export declare const sensorSchema: import("zod").ZodObject<{
+    type: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+    guid: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
     id: import("zod").ZodOptional<import("zod").ZodString>;
     modelKey: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
     name: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
     mac: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
     state: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
     mountType: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+    featureFlags: import("zod").ZodOptional<import("zod").ZodUnknown>;
     batteryStatus: import("zod").ZodOptional<import("zod").ZodUnknown>;
     stats: import("zod").ZodOptional<import("zod").ZodUnknown>;
     lightSettings: import("zod").ZodOptional<import("zod").ZodUnknown>;
@@ -43,6 +48,8 @@ export declare const sensorSchema: import("zod").ZodObject<{
     wirelessConnectionState: import("zod").ZodOptional<import("zod").ZodUnknown>;
 }, import("zod/v4/core").$loose>;
 export declare const chimeSchema: import("zod").ZodObject<{
+    type: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+    guid: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
     id: import("zod").ZodOptional<import("zod").ZodString>;
     modelKey: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
     name: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
@@ -52,6 +59,8 @@ export declare const chimeSchema: import("zod").ZodObject<{
     ringSettings: import("zod").ZodOptional<import("zod").ZodUnknown>;
 }, import("zod/v4/core").$loose>;
 export declare const viewerSchema: import("zod").ZodObject<{
+    type: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+    guid: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
     id: import("zod").ZodOptional<import("zod").ZodString>;
     modelKey: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
     name: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
@@ -61,6 +70,8 @@ export declare const viewerSchema: import("zod").ZodObject<{
     streamLimit: import("zod").ZodOptional<import("zod").ZodUnknown>;
 }, import("zod/v4/core").$loose>;
 export declare const sirenSchema: import("zod").ZodObject<{
+    type: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+    guid: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
     id: import("zod").ZodOptional<import("zod").ZodString>;
     modelKey: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
     name: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
@@ -73,6 +84,8 @@ export declare const sirenSchema: import("zod").ZodObject<{
     wirelessConnectionState: import("zod").ZodOptional<import("zod").ZodUnknown>;
 }, import("zod/v4/core").$loose>;
 export declare const fobSchema: import("zod").ZodObject<{
+    type: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+    guid: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
     id: import("zod").ZodOptional<import("zod").ZodString>;
     modelKey: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
     name: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
@@ -81,9 +94,14 @@ export declare const fobSchema: import("zod").ZodObject<{
     awayState: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
     buttonLabels: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
     featureFlags: import("zod").ZodOptional<import("zod").ZodUnknown>;
+    hasKeypad: import("zod").ZodOptional<import("zod").ZodUnknown>;
+    armControlSettings: import("zod").ZodOptional<import("zod").ZodUnknown>;
+    keypadSettings: import("zod").ZodOptional<import("zod").ZodUnknown>;
     wirelessConnectionState: import("zod").ZodOptional<import("zod").ZodUnknown>;
 }, import("zod/v4/core").$loose>;
 export declare const relaySchema: import("zod").ZodObject<{
+    type: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+    guid: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
     id: import("zod").ZodOptional<import("zod").ZodString>;
     modelKey: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
     name: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
@@ -95,6 +113,8 @@ export declare const relaySchema: import("zod").ZodObject<{
     wirelessConnectionState: import("zod").ZodOptional<import("zod").ZodUnknown>;
 }, import("zod/v4/core").$loose>;
 export declare const speakerSchema: import("zod").ZodObject<{
+    type: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+    guid: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
     id: import("zod").ZodOptional<import("zod").ZodString>;
     modelKey: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
     name: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
@@ -107,6 +127,8 @@ export declare const speakerSchema: import("zod").ZodObject<{
     featureFlags: import("zod").ZodOptional<import("zod").ZodUnknown>;
 }, import("zod/v4/core").$loose>;
 export declare const bridgeSchema: import("zod").ZodObject<{
+    type: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+    guid: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
     id: import("zod").ZodOptional<import("zod").ZodString>;
     modelKey: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
     name: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
@@ -117,6 +139,8 @@ export declare const bridgeSchema: import("zod").ZodObject<{
     maxClients: import("zod").ZodOptional<import("zod").ZodUnknown>;
 }, import("zod/v4/core").$loose>;
 export declare const linkStationSchema: import("zod").ZodObject<{
+    type: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+    guid: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
     id: import("zod").ZodOptional<import("zod").ZodString>;
     modelKey: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
     name: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
@@ -126,8 +150,12 @@ export declare const linkStationSchema: import("zod").ZodObject<{
     ledSettings: import("zod").ZodOptional<import("zod").ZodUnknown>;
     lastEvent: import("zod").ZodOptional<import("zod").ZodUnknown>;
     alarmHub: import("zod").ZodOptional<import("zod").ZodUnknown>;
+    deviceTamperStatus: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+    threadState: import("zod").ZodOptional<import("zod").ZodUnknown>;
 }, import("zod/v4/core").$loose>;
 export declare const alarmHubSchema: import("zod").ZodObject<{
+    type: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+    guid: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
     id: import("zod").ZodOptional<import("zod").ZodString>;
     modelKey: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
     name: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
@@ -137,9 +165,13 @@ export declare const alarmHubSchema: import("zod").ZodObject<{
     ledSettings: import("zod").ZodOptional<import("zod").ZodUnknown>;
     lastEvent: import("zod").ZodOptional<import("zod").ZodUnknown>;
     alarmHub: import("zod").ZodOptional<import("zod").ZodUnknown>;
+    deviceTamperStatus: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+    threadState: import("zod").ZodOptional<import("zod").ZodUnknown>;
 }, import("zod/v4/core").$loose>;
 export declare const DEVICE_SCHEMAS: {
     readonly light: import("zod").ZodObject<{
+        type: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+        guid: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
         id: import("zod").ZodOptional<import("zod").ZodString>;
         modelKey: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
         name: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
@@ -155,12 +187,15 @@ export declare const DEVICE_SCHEMAS: {
         camera: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
     }, import("zod/v4/core").$loose>;
     readonly sensor: import("zod").ZodObject<{
+        type: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+        guid: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
         id: import("zod").ZodOptional<import("zod").ZodString>;
         modelKey: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
         name: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
         mac: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
         state: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
         mountType: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+        featureFlags: import("zod").ZodOptional<import("zod").ZodUnknown>;
         batteryStatus: import("zod").ZodOptional<import("zod").ZodUnknown>;
         stats: import("zod").ZodOptional<import("zod").ZodUnknown>;
         lightSettings: import("zod").ZodOptional<import("zod").ZodUnknown>;
@@ -184,6 +219,8 @@ export declare const DEVICE_SCHEMAS: {
         wirelessConnectionState: import("zod").ZodOptional<import("zod").ZodUnknown>;
     }, import("zod/v4/core").$loose>;
     readonly chime: import("zod").ZodObject<{
+        type: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+        guid: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
         id: import("zod").ZodOptional<import("zod").ZodString>;
         modelKey: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
         name: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
@@ -193,6 +230,8 @@ export declare const DEVICE_SCHEMAS: {
         ringSettings: import("zod").ZodOptional<import("zod").ZodUnknown>;
     }, import("zod/v4/core").$loose>;
     readonly viewer: import("zod").ZodObject<{
+        type: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+        guid: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
         id: import("zod").ZodOptional<import("zod").ZodString>;
         modelKey: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
         name: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
@@ -202,6 +241,8 @@ export declare const DEVICE_SCHEMAS: {
         streamLimit: import("zod").ZodOptional<import("zod").ZodUnknown>;
     }, import("zod/v4/core").$loose>;
     readonly siren: import("zod").ZodObject<{
+        type: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+        guid: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
         id: import("zod").ZodOptional<import("zod").ZodString>;
         modelKey: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
         name: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
@@ -214,6 +255,8 @@ export declare const DEVICE_SCHEMAS: {
         wirelessConnectionState: import("zod").ZodOptional<import("zod").ZodUnknown>;
     }, import("zod/v4/core").$loose>;
     readonly fob: import("zod").ZodObject<{
+        type: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+        guid: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
         id: import("zod").ZodOptional<import("zod").ZodString>;
         modelKey: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
         name: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
@@ -222,9 +265,14 @@ export declare const DEVICE_SCHEMAS: {
         awayState: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
         buttonLabels: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
         featureFlags: import("zod").ZodOptional<import("zod").ZodUnknown>;
+        hasKeypad: import("zod").ZodOptional<import("zod").ZodUnknown>;
+        armControlSettings: import("zod").ZodOptional<import("zod").ZodUnknown>;
+        keypadSettings: import("zod").ZodOptional<import("zod").ZodUnknown>;
         wirelessConnectionState: import("zod").ZodOptional<import("zod").ZodUnknown>;
     }, import("zod/v4/core").$loose>;
     readonly relay: import("zod").ZodObject<{
+        type: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+        guid: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
         id: import("zod").ZodOptional<import("zod").ZodString>;
         modelKey: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
         name: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
@@ -236,6 +284,8 @@ export declare const DEVICE_SCHEMAS: {
         wirelessConnectionState: import("zod").ZodOptional<import("zod").ZodUnknown>;
     }, import("zod/v4/core").$loose>;
     readonly speaker: import("zod").ZodObject<{
+        type: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+        guid: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
         id: import("zod").ZodOptional<import("zod").ZodString>;
         modelKey: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
         name: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
@@ -248,6 +298,8 @@ export declare const DEVICE_SCHEMAS: {
         featureFlags: import("zod").ZodOptional<import("zod").ZodUnknown>;
     }, import("zod/v4/core").$loose>;
     readonly bridge: import("zod").ZodObject<{
+        type: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+        guid: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
         id: import("zod").ZodOptional<import("zod").ZodString>;
         modelKey: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
         name: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
@@ -258,6 +310,8 @@ export declare const DEVICE_SCHEMAS: {
         maxClients: import("zod").ZodOptional<import("zod").ZodUnknown>;
     }, import("zod/v4/core").$loose>;
     readonly link_station: import("zod").ZodObject<{
+        type: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+        guid: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
         id: import("zod").ZodOptional<import("zod").ZodString>;
         modelKey: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
         name: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
@@ -267,8 +321,12 @@ export declare const DEVICE_SCHEMAS: {
         ledSettings: import("zod").ZodOptional<import("zod").ZodUnknown>;
         lastEvent: import("zod").ZodOptional<import("zod").ZodUnknown>;
         alarmHub: import("zod").ZodOptional<import("zod").ZodUnknown>;
+        deviceTamperStatus: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+        threadState: import("zod").ZodOptional<import("zod").ZodUnknown>;
     }, import("zod/v4/core").$loose>;
     readonly alarm_hub: import("zod").ZodObject<{
+        type: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+        guid: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
         id: import("zod").ZodOptional<import("zod").ZodString>;
         modelKey: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
         name: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
@@ -278,9 +336,13 @@ export declare const DEVICE_SCHEMAS: {
         ledSettings: import("zod").ZodOptional<import("zod").ZodUnknown>;
         lastEvent: import("zod").ZodOptional<import("zod").ZodUnknown>;
         alarmHub: import("zod").ZodOptional<import("zod").ZodUnknown>;
+        deviceTamperStatus: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+        threadState: import("zod").ZodOptional<import("zod").ZodUnknown>;
     }, import("zod/v4/core").$loose>;
 };
 export declare function itemOutputShape(key: keyof typeof DEVICE_SCHEMAS): {
+    type: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+    guid: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
     id: import("zod").ZodOptional<import("zod").ZodString>;
     modelKey: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
     name: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
@@ -295,12 +357,15 @@ export declare function itemOutputShape(key: keyof typeof DEVICE_SCHEMAS): {
     isPirMotionDetected: import("zod").ZodOptional<import("zod").ZodUnknown>;
     camera: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
 } | {
+    type: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+    guid: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
     id: import("zod").ZodOptional<import("zod").ZodString>;
     modelKey: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
     name: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
     mac: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
     state: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
     mountType: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+    featureFlags: import("zod").ZodOptional<import("zod").ZodUnknown>;
     batteryStatus: import("zod").ZodOptional<import("zod").ZodUnknown>;
     stats: import("zod").ZodOptional<import("zod").ZodUnknown>;
     lightSettings: import("zod").ZodOptional<import("zod").ZodUnknown>;
@@ -323,6 +388,8 @@ export declare function itemOutputShape(key: keyof typeof DEVICE_SCHEMAS): {
     tamperingDetectedAt: import("zod").ZodOptional<import("zod").ZodUnknown>;
     wirelessConnectionState: import("zod").ZodOptional<import("zod").ZodUnknown>;
 } | {
+    type: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+    guid: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
     id: import("zod").ZodOptional<import("zod").ZodString>;
     modelKey: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
     name: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
@@ -331,6 +398,8 @@ export declare function itemOutputShape(key: keyof typeof DEVICE_SCHEMAS): {
     cameraIds: import("zod").ZodOptional<import("zod").ZodUnknown>;
     ringSettings: import("zod").ZodOptional<import("zod").ZodUnknown>;
 } | {
+    type: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+    guid: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
     id: import("zod").ZodOptional<import("zod").ZodString>;
     modelKey: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
     name: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
@@ -339,6 +408,8 @@ export declare function itemOutputShape(key: keyof typeof DEVICE_SCHEMAS): {
     liveview: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
     streamLimit: import("zod").ZodOptional<import("zod").ZodUnknown>;
 } | {
+    type: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+    guid: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
     id: import("zod").ZodOptional<import("zod").ZodString>;
     modelKey: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
     name: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
@@ -350,6 +421,8 @@ export declare function itemOutputShape(key: keyof typeof DEVICE_SCHEMAS): {
     connectionType: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
     wirelessConnectionState: import("zod").ZodOptional<import("zod").ZodUnknown>;
 } | {
+    type: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+    guid: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
     id: import("zod").ZodOptional<import("zod").ZodString>;
     modelKey: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
     name: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
@@ -358,8 +431,13 @@ export declare function itemOutputShape(key: keyof typeof DEVICE_SCHEMAS): {
     awayState: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
     buttonLabels: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
     featureFlags: import("zod").ZodOptional<import("zod").ZodUnknown>;
+    hasKeypad: import("zod").ZodOptional<import("zod").ZodUnknown>;
+    armControlSettings: import("zod").ZodOptional<import("zod").ZodUnknown>;
+    keypadSettings: import("zod").ZodOptional<import("zod").ZodUnknown>;
     wirelessConnectionState: import("zod").ZodOptional<import("zod").ZodUnknown>;
 } | {
+    type: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+    guid: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
     id: import("zod").ZodOptional<import("zod").ZodString>;
     modelKey: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
     name: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
@@ -370,6 +448,8 @@ export declare function itemOutputShape(key: keyof typeof DEVICE_SCHEMAS): {
     inputs: import("zod").ZodOptional<import("zod").ZodUnknown>;
     wirelessConnectionState: import("zod").ZodOptional<import("zod").ZodUnknown>;
 } | {
+    type: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+    guid: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
     id: import("zod").ZodOptional<import("zod").ZodString>;
     modelKey: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
     name: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
@@ -381,6 +461,8 @@ export declare function itemOutputShape(key: keyof typeof DEVICE_SCHEMAS): {
     speakerState: import("zod").ZodOptional<import("zod").ZodUnknown>;
     featureFlags: import("zod").ZodOptional<import("zod").ZodUnknown>;
 } | {
+    type: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+    guid: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
     id: import("zod").ZodOptional<import("zod").ZodString>;
     modelKey: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
     name: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
@@ -390,6 +472,8 @@ export declare function itemOutputShape(key: keyof typeof DEVICE_SCHEMAS): {
     clients: import("zod").ZodOptional<import("zod").ZodUnknown>;
     maxClients: import("zod").ZodOptional<import("zod").ZodUnknown>;
 } | {
+    type: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+    guid: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
     id: import("zod").ZodOptional<import("zod").ZodString>;
     modelKey: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
     name: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
@@ -399,9 +483,13 @@ export declare function itemOutputShape(key: keyof typeof DEVICE_SCHEMAS): {
     ledSettings: import("zod").ZodOptional<import("zod").ZodUnknown>;
     lastEvent: import("zod").ZodOptional<import("zod").ZodUnknown>;
     alarmHub: import("zod").ZodOptional<import("zod").ZodUnknown>;
+    deviceTamperStatus: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+    threadState: import("zod").ZodOptional<import("zod").ZodUnknown>;
 };
 export declare function listOutputShape(key: keyof typeof DEVICE_SCHEMAS): {
     result: import("zod").ZodArray<import("zod").ZodObject<{
+        type: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+        guid: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
         id: import("zod").ZodOptional<import("zod").ZodString>;
         modelKey: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
         name: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
@@ -416,12 +504,15 @@ export declare function listOutputShape(key: keyof typeof DEVICE_SCHEMAS): {
         isPirMotionDetected: import("zod").ZodOptional<import("zod").ZodUnknown>;
         camera: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
     }, import("zod/v4/core").$loose> | import("zod").ZodObject<{
+        type: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+        guid: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
         id: import("zod").ZodOptional<import("zod").ZodString>;
         modelKey: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
         name: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
         mac: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
         state: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
         mountType: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+        featureFlags: import("zod").ZodOptional<import("zod").ZodUnknown>;
         batteryStatus: import("zod").ZodOptional<import("zod").ZodUnknown>;
         stats: import("zod").ZodOptional<import("zod").ZodUnknown>;
         lightSettings: import("zod").ZodOptional<import("zod").ZodUnknown>;
@@ -444,6 +535,8 @@ export declare function listOutputShape(key: keyof typeof DEVICE_SCHEMAS): {
         tamperingDetectedAt: import("zod").ZodOptional<import("zod").ZodUnknown>;
         wirelessConnectionState: import("zod").ZodOptional<import("zod").ZodUnknown>;
     }, import("zod/v4/core").$loose> | import("zod").ZodObject<{
+        type: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+        guid: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
         id: import("zod").ZodOptional<import("zod").ZodString>;
         modelKey: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
         name: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
@@ -452,6 +545,8 @@ export declare function listOutputShape(key: keyof typeof DEVICE_SCHEMAS): {
         cameraIds: import("zod").ZodOptional<import("zod").ZodUnknown>;
         ringSettings: import("zod").ZodOptional<import("zod").ZodUnknown>;
     }, import("zod/v4/core").$loose> | import("zod").ZodObject<{
+        type: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+        guid: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
         id: import("zod").ZodOptional<import("zod").ZodString>;
         modelKey: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
         name: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
@@ -460,6 +555,8 @@ export declare function listOutputShape(key: keyof typeof DEVICE_SCHEMAS): {
         liveview: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
         streamLimit: import("zod").ZodOptional<import("zod").ZodUnknown>;
     }, import("zod/v4/core").$loose> | import("zod").ZodObject<{
+        type: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+        guid: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
         id: import("zod").ZodOptional<import("zod").ZodString>;
         modelKey: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
         name: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
@@ -471,6 +568,8 @@ export declare function listOutputShape(key: keyof typeof DEVICE_SCHEMAS): {
         connectionType: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
         wirelessConnectionState: import("zod").ZodOptional<import("zod").ZodUnknown>;
     }, import("zod/v4/core").$loose> | import("zod").ZodObject<{
+        type: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+        guid: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
         id: import("zod").ZodOptional<import("zod").ZodString>;
         modelKey: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
         name: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
@@ -479,8 +578,13 @@ export declare function listOutputShape(key: keyof typeof DEVICE_SCHEMAS): {
         awayState: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
         buttonLabels: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
         featureFlags: import("zod").ZodOptional<import("zod").ZodUnknown>;
+        hasKeypad: import("zod").ZodOptional<import("zod").ZodUnknown>;
+        armControlSettings: import("zod").ZodOptional<import("zod").ZodUnknown>;
+        keypadSettings: import("zod").ZodOptional<import("zod").ZodUnknown>;
         wirelessConnectionState: import("zod").ZodOptional<import("zod").ZodUnknown>;
     }, import("zod/v4/core").$loose> | import("zod").ZodObject<{
+        type: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+        guid: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
         id: import("zod").ZodOptional<import("zod").ZodString>;
         modelKey: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
         name: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
@@ -491,6 +595,8 @@ export declare function listOutputShape(key: keyof typeof DEVICE_SCHEMAS): {
         inputs: import("zod").ZodOptional<import("zod").ZodUnknown>;
         wirelessConnectionState: import("zod").ZodOptional<import("zod").ZodUnknown>;
     }, import("zod/v4/core").$loose> | import("zod").ZodObject<{
+        type: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+        guid: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
         id: import("zod").ZodOptional<import("zod").ZodString>;
         modelKey: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
         name: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
@@ -502,6 +608,8 @@ export declare function listOutputShape(key: keyof typeof DEVICE_SCHEMAS): {
         speakerState: import("zod").ZodOptional<import("zod").ZodUnknown>;
         featureFlags: import("zod").ZodOptional<import("zod").ZodUnknown>;
     }, import("zod/v4/core").$loose> | import("zod").ZodObject<{
+        type: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+        guid: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
         id: import("zod").ZodOptional<import("zod").ZodString>;
         modelKey: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
         name: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
@@ -511,6 +619,8 @@ export declare function listOutputShape(key: keyof typeof DEVICE_SCHEMAS): {
         clients: import("zod").ZodOptional<import("zod").ZodUnknown>;
         maxClients: import("zod").ZodOptional<import("zod").ZodUnknown>;
     }, import("zod/v4/core").$loose> | import("zod").ZodObject<{
+        type: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+        guid: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
         id: import("zod").ZodOptional<import("zod").ZodString>;
         modelKey: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
         name: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
@@ -520,5 +630,7 @@ export declare function listOutputShape(key: keyof typeof DEVICE_SCHEMAS): {
         ledSettings: import("zod").ZodOptional<import("zod").ZodUnknown>;
         lastEvent: import("zod").ZodOptional<import("zod").ZodUnknown>;
         alarmHub: import("zod").ZodOptional<import("zod").ZodUnknown>;
+        deviceTamperStatus: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+        threadState: import("zod").ZodOptional<import("zod").ZodUnknown>;
     }, import("zod/v4/core").$loose>>;
 };

package/dist/schemas/devices.js

@@ -7,9 +7,9 @@ const common_js_1 = require("./common.js");
 /**
  * Device schemas for the config-driven Protect device types.
  *
- * Field sets are derived from the UniFi Protect Integration API 7.1.83 docs
+ * Field sets are derived from the UniFi Protect Integration API 7.3.47 docs
  * (per-type response samples). Chimes were additionally verified against live
- * console responses (2026-06-20); the rest have no instances on the available
+ * console responses (2026-09-14); the rest have no instances on the available
  * console, so their TOP-LEVEL fields are typed from the published docs while
  * every nested object/array is left as `unknownField()` (z.unknown()) — naming
  * the field for the LLM without risking SDK output-validation failures on a
@@ -26,6 +26,7 @@ const deviceIdentity = () => ({
     name: (0, common_js_1.nullableString)("Device name"),
     mac: (0, common_js_1.nullableString)("MAC address"),
     state: (0, common_js_1.nullableString)("CONNECTED | DISCONNECTED | ..."),
+    ...(0, common_js_1.hardwareModelFields)(),
 });
 exports.lightSchema = (0, common_js_1.passthroughObject)({
     ...deviceIdentity(),
@@ -41,6 +42,8 @@ exports.lightSchema = (0, common_js_1.passthroughObject)({
 exports.sensorSchema = (0, common_js_1.passthroughObject)({
     ...deviceIdentity(),
     mountType: (0, common_js_1.nullableString)('Mount type, e.g. "door", "leak", "garage"'),
+    featureFlags: (0, common_js_1.unknownField)("Sensor capability flags, added in 7.3.x (object: temperature, humidity, " +
+        "light, motion, waterLeak, open, tamper, smoke — each { channelCount })"),
     batteryStatus: (0, common_js_1.unknownField)("Battery status (object: percentage, isLow)"),
     stats: (0, common_js_1.unknownField)("Environmental stats (object: light, humidity, temperature)"),
     lightSettings: (0, common_js_1.unknownField)("Light threshold settings (object)"),
@@ -88,6 +91,10 @@ exports.fobSchema = (0, common_js_1.passthroughObject)({
     awayState: (0, common_js_1.nullableString)('Away state, e.g. "ONLINE"'),
     buttonLabels: (0, common_js_1.nullableString)('Button label preset, e.g. "securityActions"'),
     featureFlags: (0, common_js_1.unknownField)("Feature flags (object: buttons[])"),
+    hasKeypad: (0, common_js_1.unknownField)("Whether this fob has a keypad, added in 7.3.x (boolean)"),
+    armControlSettings: (0, common_js_1.unknownField)("Arm-control config, added in 7.3.x (object: enabled, armProfileId, nightProfileId)"),
+    keypadSettings: (0, common_js_1.unknownField)("Keypad config, added in 7.3.x (object: beepEnabled, beepVolume, " +
+        "backlightEnabled, backlightBrightness)"),
     wirelessConnectionState: (0, common_js_1.unknownField)("Wireless link state (object)"),
 });
 exports.relaySchema = (0, common_js_1.passthroughObject)({
@@ -119,6 +126,10 @@ const linkStationLikeSchema = () => (0, common_js_1.passthroughObject)({
     ledSettings: (0, common_js_1.unknownField)("LED settings (object: isEnabled)"),
     lastEvent: (0, common_js_1.unknownField)("Last event timestamp in epoch ms (number)"),
     alarmHub: (0, common_js_1.unknownField)("Alarm hub status (object: armed, battery, connector, cover, output, input, …)"),
+    deviceTamperStatus: (0, common_js_1.nullableString)('Tamper status, added in 7.3.x, e.g. "tampered"'),
+    threadState: (0, common_js_1.unknownField)("Thread radio state, added in 7.3.x (object: network — status, role, " +
+        "networkName, channel, panId, extendedPanId, joinedDeviceCount, " +
+        "errorReason, lastUpdatedAt)"),
 });
 exports.linkStationSchema = linkStationLikeSchema();
 exports.alarmHubSchema = linkStationLikeSchema();

package/dist/schemas/misc.d.ts

@@ -1,8 +1,8 @@
 import { z } from "zod";
 /**
- * Schemas below are verified against live UniFi Protect Integration API 7.1.83
- * responses (Melrose NVR Pro console, 2026-06-20) where instances exist, and
- * against the 7.1.83 published docs otherwise (arm profiles, files — no
+ * Schemas below are verified against live UniFi Protect Integration API 7.3.47
+ * responses (Melrose NVR Pro console, 2026-09-14) where instances exist, and
+ * against the 7.3.47 published docs otherwise (arm profiles, files — no
  * instances on the console). The Integration API surface is much thinner than
  * the internal Protect app API — only observed/documented fields are typed;
  * `.passthrough()` still allows anything extra a firmware/hardware mix adds.
@@ -11,9 +11,12 @@ export declare const infoOutputSchema: {
     applicationVersion: z.ZodOptional<z.ZodNullable<z.ZodString>>;
 };
 export declare const nvrSchema: z.ZodObject<{
+    type: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    guid: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     id: z.ZodOptional<z.ZodString>;
     modelKey: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    mac: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     doorbellSettings: z.ZodOptional<z.ZodObject<{
         defaultMessageText: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         defaultMessageResetTimeoutMs: z.ZodOptional<z.ZodUnknown>;
@@ -32,9 +35,12 @@ export declare const nvrSchema: z.ZodObject<{
     }, z.core.$loose>>;
 }, z.core.$loose>;
 export declare const nvrOutputSchema: {
+    type: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    guid: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     id: z.ZodOptional<z.ZodString>;
     modelKey: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    mac: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     doorbellSettings: z.ZodOptional<z.ZodObject<{
         defaultMessageText: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         defaultMessageResetTimeoutMs: z.ZodOptional<z.ZodUnknown>;
@@ -87,6 +93,7 @@ export declare const ulpUserSchema: z.ZodObject<{
     firstName: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     lastName: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     fullName: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    email: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     status: z.ZodOptional<z.ZodNullable<z.ZodString>>;
 }, z.core.$loose>;
 export declare const ulpUserOutputSchema: {
@@ -95,6 +102,7 @@ export declare const ulpUserOutputSchema: {
     firstName: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     lastName: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     fullName: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    email: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     status: z.ZodOptional<z.ZodNullable<z.ZodString>>;
 };
 export declare const ulpUserListOutputSchema: {
@@ -104,6 +112,7 @@ export declare const ulpUserListOutputSchema: {
         firstName: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         lastName: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         fullName: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        email: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         status: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     }, z.core.$loose>>;
 };

package/dist/schemas/misc.js

@@ -4,9 +4,9 @@ exports.subscriptionOutputSchema = exports.fileListOutputSchema = exports.fileSc
 const zod_1 = require("zod");
 const common_js_1 = require("./common.js");
 /**
- * Schemas below are verified against live UniFi Protect Integration API 7.1.83
- * responses (Melrose NVR Pro console, 2026-06-20) where instances exist, and
- * against the 7.1.83 published docs otherwise (arm profiles, files — no
+ * Schemas below are verified against live UniFi Protect Integration API 7.3.47
+ * responses (Melrose NVR Pro console, 2026-09-14) where instances exist, and
+ * against the 7.3.47 published docs otherwise (arm profiles, files — no
  * instances on the console). The Integration API surface is much thinner than
  * the internal Protect app API — only observed/documented fields are typed;
  * `.passthrough()` still allows anything extra a firmware/hardware mix adds.
@@ -36,6 +36,8 @@ exports.nvrSchema = (0, common_js_1.passthroughObject)({
     id: (0, common_js_1.idField)("NVR ID"),
     modelKey: (0, common_js_1.nullableString)('Always "nvr"'),
     name: (0, common_js_1.nullableString)("NVR name"),
+    ...(0, common_js_1.hardwareModelFields)(),
+    mac: (0, common_js_1.nullableString)("MAC address, added in 7.3.x"),
     doorbellSettings: doorbellSettingsSchema.optional(),
     armMode: armModeSchema.optional(),
 });
@@ -59,6 +61,8 @@ exports.ulpUserSchema = (0, common_js_1.passthroughObject)({
     firstName: (0, common_js_1.nullableString)("First name"),
     lastName: (0, common_js_1.nullableString)("Last name"),
     fullName: (0, common_js_1.nullableString)("Full name"),
+    email: (0, common_js_1.nullableString)("Email address, added in 7.3.x. Empty string for service accounts " +
+        "(verified live 7.3.47)"),
     status: (0, common_js_1.nullableString)("Account status, e.g. ACTIVE"),
 });
 exports.ulpUserOutputSchema = { ...exports.ulpUserSchema.shape };

package/dist/schemas/pos.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Point-of-sale event ingestion, added in UniFi Protect 7.3.x
+ * (POST /v1/pos/cameras/{id}/transactions).
+ *
+ * Shape taken from the 7.3.47 published docs with the response sample expanded
+ * — there is no POS-capable register on the available console, so this is
+ * doc-verified rather than live-verified. `created` stays `unknownField()`
+ * because we have not observed the boolean live; `eventId` publishes the string
+ * hint via `nullableString()`.
+ */
+export declare const posTransactionOutputSchema: {
+    created: import("zod").ZodOptional<import("zod").ZodUnknown>;
+    eventId: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+};

package/dist/schemas/pos.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.posTransactionOutputSchema = void 0;
+const common_js_1 = require("./common.js");
+/**
+ * Point-of-sale event ingestion, added in UniFi Protect 7.3.x
+ * (POST /v1/pos/cameras/{id}/transactions).
+ *
+ * Shape taken from the 7.3.47 published docs with the response sample expanded
+ * — there is no POS-capable register on the available console, so this is
+ * doc-verified rather than live-verified. `created` stays `unknownField()`
+ * because we have not observed the boolean live; `eventId` publishes the string
+ * hint via `nullableString()`.
+ */
+exports.posTransactionOutputSchema = {
+    created: (0, common_js_1.unknownField)("Whether the transaction event was recorded (boolean)"),
+    eventId: (0, common_js_1.nullableString)("ID of the created Protect camera event"),
+};

package/dist/tools/cameras.js

@@ -9,7 +9,7 @@ const cameras_js_1 = require("../schemas/cameras.js");
 function registerCameraTools(server, client, readOnly) {
     // --- Read-only tools (always registered) ---
     server.registerTool("protect_list_cameras", {
-        description: "List all cameras managed by UniFi Protect. Returns array; each camera includes (Integration API 7.1.83-verified fields): id, mac, name, modelKey, state (CONNECTED/DISCONNECTED), activePatrolSlot, hasPackageCamera, hdrType, isMicEnabled, micVolume, videoMode, featureFlags (hasHdr, hasMic, hasSpeaker, hasLedStatus, smartDetectTypes[], smartDetectAudioTypes[], videoModes[], supportFullHdSnapshot), lcdMessage (type, resetAt, text), ledSettings (isEnabled, floodLed, welcomeLed), osdSettings (isNameEnabled, isDateEnabled, isLogoEnabled, isDebugEnabled, overlayLocation), smartDetectSettings (objectTypes[], audioTypes[]). The Integration API does NOT expose recording state, motion timestamps, connection/last-seen, firmware, host, or per-channel stream config.",
+        description: "List all cameras managed by UniFi Protect. Returns array; each camera includes (Integration API 7.3.47-verified fields): id, mac, name, modelKey, state (CONNECTED/DISCONNECTED), type (hardware model name, e.g. UVC G6 Turret), guid (hardware MODEL GUID — every camera of the same model returns the same value, so it is NOT a per-camera identifier; use id), activePatrolSlot, hasPackageCamera, hdrType, isMicEnabled, micVolume, videoMode, featureFlags (hasHdr, hasMic, hasSpeaker, hasLedStatus, smartDetectTypes[], smartDetectAudioTypes[], videoModes[], supportFullHdSnapshot), lcdMessage (type, resetAt, text), ledSettings (isEnabled, floodLed, welcomeLed), osdSettings (isNameEnabled, isDateEnabled, isLogoEnabled, isDebugEnabled, overlayLocation), smartDetectSettings (objectTypes[], audioTypes[]). The Integration API does NOT expose recording state, motion timestamps, connection/last-seen, firmware, host, or per-channel stream config.",
         outputSchema: cameras_js_1.cameraListOutputSchema,
         annotations: safety_js_1.READ_ONLY,
     }, async () => {
@@ -22,7 +22,7 @@ function registerCameraTools(server, client, readOnly) {
         }
     });
     server.registerTool("protect_get_camera", {
-        description: "Get details for a specific camera by ID. The Protect Integration API returns the SAME field set as protect_list_cameras entries (id, mac, name, modelKey, state, activePatrolSlot, hasPackageCamera, hdrType, isMicEnabled, micVolume, videoMode, featureFlags, lcdMessage, ledSettings, osdSettings, smartDetectSettings) — there is no extended/by-id-only payload (confirmed live on 7.1.83). Recording state, motion events, zones, and channel/RTSP config are NOT exposed by this API surface.",
+        description: "Get details for a specific camera by ID. The Protect Integration API returns the SAME field set as protect_list_cameras entries (id, mac, name, modelKey, state, type, guid, activePatrolSlot, hasPackageCamera, hdrType, isMicEnabled, micVolume, videoMode, featureFlags, lcdMessage, ledSettings, osdSettings, smartDetectSettings) — there is no extended/by-id-only payload (confirmed live on 7.3.47). Recording state, motion events, zones, and channel/RTSP config are NOT exposed by this API surface.",
         inputSchema: { id: zod_1.z.string().describe("Camera ID") },
         outputSchema: cameras_js_1.cameraOutputSchema,
         annotations: safety_js_1.READ_ONLY,

package/dist/tools/devices.js

@@ -7,7 +7,10 @@ const responses_js_1 = require("../utils/responses.js");
 const safety_js_1 = require("../utils/safety.js");
 const url_js_1 = require("../utils/url.js");
 const devices_js_1 = require("../schemas/devices.js");
-// Field lists below are from the UniFi Protect Integration API 7.1.83 docs.
+// Field lists below are from the UniFi Protect Integration API 7.3.47 docs.
+// 7.3.x added `type` (hardware model name) and `guid` to every device. NOTE:
+// `guid` identifies the hardware MODEL, not the unit — every camera of the same
+// model returns the same guid (verified live 7.3.47). `id` is the device identity.
 // Chimes are additionally verified against live console responses; the rest
 // have no instances on the available console (top-level fields documented,
 // nested shapes intentionally left opaque in the output schema).
@@ -18,7 +21,7 @@ const DEVICES = [
         plural: "lights",
         label: "Light",
         hint: "Known fields: name (string), isLightForceEnabled (boolean), lightModeSettings (object with mode, enableAt), lightDeviceSettings (object with isIndicatorEnabled, pirDuration, pirSensitivity, ledLevel)",
-        returns: "id, modelKey, name, mac, state, lightModeSettings (mode, enableAt), lightDeviceSettings (isIndicatorEnabled, pirDuration, pirSensitivity, ledLevel), isDark, isLightOn, isLightForceEnabled, lastMotion, isPirMotionDetected, camera (7.1.83 docs)",
+        returns: "id, modelKey, name, mac, state, type, guid, lightModeSettings (mode, enableAt), lightDeviceSettings (isIndicatorEnabled, pirDuration, pirSensitivity, ledLevel), isDark, isLightOn, isLightForceEnabled, lastMotion, isPirMotionDetected, camera (7.3.47 docs)",
     },
     {
         urlPath: "sensors",
@@ -26,7 +29,7 @@ const DEVICES = [
         plural: "sensors",
         label: "Sensor",
         hint: "Known fields: name (string), motionSettings (object), humiditySettings (object), temperatureSettings (object), lightSettings (object), alarmSettings (object), glassBreakSettings (object), leakSettings (object), scheduleMode (\"always\" | \"when_armed\"), armProfileIds (array of up to 32 strings), hasCustomSensitivityWhenArmed (boolean)",
-        returns: "id, modelKey, name, mac, state, mountType, batteryStatus (percentage, isLow), stats (light, humidity, temperature), lightSettings, humiditySettings, temperatureSettings, isOpened, openStatusChangedAt, isMotionDetected, motionDetectedAt, motionSettings, glassBreakSettings, scheduleMode, armProfileIds, hasCustomSensitivityWhenArmed, alarmTriggeredAt, alarmSettings, leakDetectedAt, externalLeakDetectedAt, leakSettings, tamperingDetectedAt, wirelessConnectionState (7.1.83 docs)",
+        returns: "id, modelKey, name, mac, state, type, guid, mountType, featureFlags (temperature, humidity, light, motion, waterLeak, open, tamper, smoke — each {channelCount}), batteryStatus (percentage, isLow), stats (light, humidity, temperature), lightSettings, humiditySettings, temperatureSettings, isOpened, openStatusChangedAt, isMotionDetected, motionDetectedAt, motionSettings, glassBreakSettings, scheduleMode, armProfileIds, hasCustomSensitivityWhenArmed, alarmTriggeredAt, alarmSettings, leakDetectedAt, externalLeakDetectedAt, leakSettings, tamperingDetectedAt, wirelessConnectionState (7.3.47 docs)",
     },
     {
         urlPath: "chimes",
@@ -34,7 +37,7 @@ const DEVICES = [
         plural: "chimes",
         label: "Chime",
         hint: "Known fields: name (string), cameraIds (array of camera IDs linked to the chime), ringSettings (array of objects: cameraId, volume, ringtoneId, repeatTimes)",
-        returns: "id, modelKey, name, mac, state, cameraIds (array of camera IDs), ringSettings (array of objects: cameraId, volume, ringtoneId, repeatTimes) — verified live 7.1.83",
+        returns: "id, modelKey, name, mac, state, type, guid, cameraIds (array of camera IDs), ringSettings (array of objects: cameraId, volume, ringtoneId, repeatTimes) — verified live 7.3.47",
     },
     {
         urlPath: "viewers",
@@ -42,7 +45,7 @@ const DEVICES = [
         plural: "viewers",
         label: "Viewer",
         hint: "Known fields: name (string), liveview (string, liveview ID to display, or null)",
-        returns: "id, modelKey, name, mac, state, liveview, streamLimit (7.1.83 docs)",
+        returns: "id, modelKey, name, mac, state, type, guid, liveview, streamLimit (7.3.47 docs)",
     },
     {
         urlPath: "sirens",
@@ -50,7 +53,7 @@ const DEVICES = [
         plural: "sirens",
         label: "Siren",
         hint: "Known fields: name (string), volume (integer 1-100), ledSettings (object with isEnabled boolean)",
-        returns: "id, modelKey, name, mac, state, volume, ledSettings (isEnabled), sirenStatus (isActive, activatedAt, duration), connectionType, wirelessConnectionState (7.1.83 docs)",
+        returns: "id, modelKey, name, mac, state, type, guid, volume, ledSettings (isEnabled), sirenStatus (isActive, activatedAt, duration), connectionType, wirelessConnectionState (7.3.47 docs)",
     },
     {
         urlPath: "fobs",
@@ -58,7 +61,7 @@ const DEVICES = [
         plural: "fobs",
         label: "Fob",
         hint: "Known fields: name (string)",
-        returns: "id, modelKey, name, mac, state, awayState, buttonLabels, featureFlags (buttons[]), wirelessConnectionState (7.1.83 docs)",
+        returns: "id, modelKey, name, mac, state, type, guid, awayState, buttonLabels, featureFlags (buttons[]), hasKeypad, armControlSettings (enabled, armProfileId, nightProfileId), keypadSettings (beepEnabled, beepVolume, backlightEnabled, backlightBrightness), wirelessConnectionState (7.3.47 docs)",
     },
     {
         urlPath: "relays",
@@ -66,7 +69,7 @@ const DEVICES = [
         plural: "relays",
         label: "Relay",
         hint: "Known fields: name (string), ledSettings (object with isEnabled boolean)",
-        returns: "id, modelKey, name, mac, state, ledSettings (isEnabled), outputs (array), inputs (array), wirelessConnectionState (7.1.83 docs)",
+        returns: "id, modelKey, name, mac, state, type, guid, ledSettings (isEnabled), outputs (array), inputs (array), wirelessConnectionState (7.3.47 docs)",
     },
     {
         urlPath: "speakers",
@@ -74,7 +77,7 @@ const DEVICES = [
         plural: "speakers",
         label: "Speaker",
         hint: "Known fields: name (string), volume (integer 0-100), micVolume (integer 0-100), isMicEnabled (boolean)",
-        returns: "id, modelKey, name, mac, state, volume, micVolume, isMicEnabled, speakerState (status, mode), featureFlags (hasMic) (7.1.83 docs)",
+        returns: "id, modelKey, name, mac, state, type, guid, volume, micVolume, isMicEnabled, speakerState (status, mode), featureFlags (hasMic) (7.3.47 docs)",
     },
     {
         urlPath: "bridges",
@@ -82,7 +85,7 @@ const DEVICES = [
         plural: "bridges",
         label: "Bridge",
         hint: "Known fields: name (string)",
-        returns: "id, modelKey, name, mac, state, platform, clients (array of MACs), maxClients (7.1.83 docs)",
+        returns: "id, modelKey, name, mac, state, type, guid, platform, clients (array of MACs), maxClients (7.3.47 docs)",
     },
     {
         urlPath: "link-stations",
@@ -90,7 +93,7 @@ const DEVICES = [
         plural: "link_stations",
         label: "Link station",
         hint: "Known fields: name (string)",
-        returns: "id, modelKey (\"linkstation\"), name, mac, state, isAlarmHub, ledSettings (isEnabled), lastEvent, alarmHub (object) (7.1.83 docs)",
+        returns: "id, modelKey (\"linkstation\"), name, mac, state, type, guid, isAlarmHub, ledSettings (isEnabled), lastEvent, alarmHub (object), deviceTamperStatus, threadState (network: status, role, networkName, channel, panId, extendedPanId, joinedDeviceCount, errorReason, lastUpdatedAt) (7.3.47 docs)",
     },
     {
         urlPath: "alarm-hubs",
@@ -98,7 +101,7 @@ const DEVICES = [
         plural: "alarm_hubs",
         label: "Alarm hub",
         hint: "Known fields: name (string)",
-        returns: "id, modelKey (\"linkstation\"), name, mac, state, isAlarmHub, ledSettings (isEnabled), lastEvent, alarmHub (object) (7.1.83 docs)",
+        returns: "id, modelKey (\"linkstation\"), name, mac, state, type, guid, isAlarmHub, ledSettings (isEnabled), lastEvent, alarmHub (object), deviceTamperStatus, threadState (network: status, role, networkName, channel, panId, extendedPanId, joinedDeviceCount, errorReason, lastUpdatedAt) (7.3.47 docs)",
     },
 ];
 function registerDeviceCrud(server, client, cfg, readOnly) {

package/dist/tools/index.js

@@ -10,6 +10,7 @@ const files_js_1 = require("./files.js");
 const subscriptions_js_1 = require("./subscriptions.js");
 const arm_profiles_js_1 = require("./arm-profiles.js");
 const users_js_1 = require("./users.js");
+const pos_js_1 = require("./pos.js");
 function registerAllTools(server, client, readOnly) {
     (0, system_js_1.registerSystemTools)(server, client);
     (0, subscriptions_js_1.registerSubscriptionTools)(server, client);
@@ -20,4 +21,5 @@ function registerAllTools(server, client, readOnly) {
     (0, files_js_1.registerFileTools)(server, client, readOnly);
     (0, arm_profiles_js_1.registerArmProfileTools)(server, client, readOnly);
     (0, users_js_1.registerUserTools)(server, client);
+    (0, pos_js_1.registerPosTools)(server, client, readOnly);
 }

package/dist/tools/pos.d.ts

@@ -0,0 +1,10 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { ProtectClient } from "../client.js";
+/**
+ * Point-of-sale event ingestion (added in Protect 7.3.x).
+ *
+ * `lineItems` entries use `.passthrough()` because the 7.3.47 docs render the
+ * item schema collapsed — the request sample shows `{ title, quantity }`, but
+ * an undocumented extra field should reach the API rather than be stripped.
+ */
+export declare function registerPosTools(server: McpServer, client: ProtectClient, readOnly: boolean): void;

package/dist/tools/pos.js

@@ -0,0 +1,101 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerPosTools = registerPosTools;
+const zod_1 = require("zod");
+const responses_js_1 = require("../utils/responses.js");
+const safety_js_1 = require("../utils/safety.js");
+const url_js_1 = require("../utils/url.js");
+const pos_js_1 = require("../schemas/pos.js");
+/**
+ * Point-of-sale event ingestion (added in Protect 7.3.x).
+ *
+ * `lineItems` entries use `.passthrough()` because the 7.3.47 docs render the
+ * item schema collapsed — the request sample shows `{ title, quantity }`, but
+ * an undocumented extra field should reach the API rather than be stripped.
+ */
+function registerPosTools(server, client, readOnly) {
+    if (readOnly)
+        return;
+    const lineItemSchema = zod_1.z
+        .object({
+        title: zod_1.z.string().describe("Line item name"),
+        quantity: zod_1.z.number().min(1).describe("Quantity purchased (>= 1)"),
+    })
+        .passthrough();
+    server.registerTool("protect_ingest_pos_transaction", {
+        description: "Record a point-of-sale transaction as a camera event so the transaction " +
+            "details can be overlaid on recorded footage. Requires write access to the " +
+            "target camera. Footage capture is best-effort: the overlay only appears " +
+            "where the camera was actually recording the transaction window, and a " +
+            "backdated timestamp may fall outside retained footage — a success response " +
+            "confirms the event was recorded, NOT that video exists for that window. " +
+            "A 409 means a transaction with the same externalId is already being " +
+            "processed for this camera; retry shortly. " +
+            "Returns: created (boolean), eventId (string).",
+        inputSchema: {
+            id: zod_1.z.string().describe("Camera ID to attach the transaction event to"),
+            type: zod_1.z.enum(["sale", "refund"]).describe("Transaction type"),
+            externalId: zod_1.z
+                .string()
+                .min(1)
+                .max(255)
+                .describe("Caller-supplied transaction ID, unique per camera. Used for " +
+                "best-effort idempotency within a short window only — the dedupe " +
+                "cache is in-memory and per-process, so a retry after a Protect " +
+                "restart or after the window elapses may create a duplicate event."),
+            amount: zod_1.z.number().min(0).describe("Transaction total amount (>= 0)"),
+            currency: zod_1.z
+                .string()
+                .regex(/^[A-Z]{3}$/)
+                .optional()
+                .describe('Uppercase ISO 4217 currency code, e.g. "USD"'),
+            lineItems: zod_1.z
+                .array(lineItemSchema)
+                .max(200)
+                .optional()
+                .describe("Purchased line items (max 200)"),
+            location: zod_1.z
+                .object({
+                id: zod_1.z.string().optional().describe("Store/location ID"),
+                name: zod_1.z.string().optional().describe("Store/location name"),
+            })
+                .passthrough()
+                .optional()
+                .describe("Point-of-sale location"),
+            paymentTypes: zod_1.z
+                .array(zod_1.z.string().min(1).max(255))
+                .max(20)
+                .optional()
+                .describe("Payment method names (max 20)"),
+            timestamp: zod_1.z
+                .number()
+                .int()
+                .min(1)
+                .optional()
+                .describe("Transaction time in epoch milliseconds. Protect validates this " +
+                "against the NVR clock: it must be within the last 24 hours and no " +
+                "more than 5 minutes ahead of server time. Protect rejects an " +
+                "out-of-range value with a 400 and clamps an in-skew value to now. " +
+                "This tool forwards the value unchanged rather than pre-checking it, " +
+                "because the window is relative to NVR time, not this process clock."),
+            dryRun: zod_1.z
+                .boolean()
+                .optional()
+                .describe("If true, return what would happen without making changes"),
+        },
+        outputSchema: pos_js_1.posTransactionOutputSchema,
+        annotations: safety_js_1.WRITE,
+    }, async ({ id, dryRun, ...transaction }) => {
+        try {
+            const path = (0, url_js_1.safePath) `/pos/cameras/${id}/transactions`;
+            if (dryRun) {
+                return (0, safety_js_1.formatDryRun)("POST", path, transaction);
+            }
+            const data = await client.post(path, transaction);
+            return (0, responses_js_1.formatSuccess)(data);
+        }
+        catch (err) {
+            return (0, responses_js_1.formatError)(err);
+        }
+    });
+}

package/dist/tools/system.js

@@ -19,7 +19,7 @@ function registerSystemTools(server, client) {
         }
     });
     server.registerTool("protect_list_nvrs", {
-        description: "Get the NVR (Network Video Recorder) console info. NOTE: despite the name, the Protect Integration API's /nvrs endpoint returns a SINGLE NVR object, not an array. Returns: id, modelKey, name, doorbellSettings (defaultMessageText, defaultMessageResetTimeoutMs, customMessages[], customImages[]), armMode (status, armedAt, willBeArmedAt, breachDetectedAt, breachEventCount, breachTriggerEventId, breachEventId).",
+        description: "Get the NVR (Network Video Recorder) console info. NOTE: despite the name, the Protect Integration API's /nvrs endpoint returns a SINGLE NVR object, not an array. Returns: id, modelKey, name, type (e.g. UNVR-PRO), guid, mac, doorbellSettings (defaultMessageText, defaultMessageResetTimeoutMs, customMessages[], customImages[]), armMode (status, armedAt, willBeArmedAt, breachDetectedAt, breachEventCount, breachTriggerEventId, breachEventId).",
         outputSchema: misc_js_1.nvrOutputSchema,
         annotations: safety_js_1.READ_ONLY,
     }, async () => {

package/dist/tools/users.js

@@ -8,7 +8,7 @@ const url_js_1 = require("../utils/url.js");
 const misc_js_1 = require("../schemas/misc.js");
 function registerUserTools(server, client) {
     server.registerTool("protect_list_users", {
-        description: "List all Protect users (filtered by the API key's access permissions). Returns array; each user includes (Integration API 7.1.83-verified): id, modelKey, name, firstName, lastName, email, ucoreUserId. The Integration API does NOT expose roles, permissions, login history, groups, or notification settings.",
+        description: "List all Protect users (filtered by the API key's access permissions). Returns array; each user includes (Integration API 7.3.47-verified): id, modelKey, name, firstName, lastName, email, ucoreUserId. The Integration API does NOT expose roles, permissions, login history, groups, or notification settings.",
         outputSchema: misc_js_1.userListOutputSchema,
         annotations: safety_js_1.READ_ONLY,
     }, async () => {
@@ -35,7 +35,7 @@ function registerUserTools(server, client) {
         }
     });
     server.registerTool("protect_list_ulp_users", {
-        description: "List all UniFi Identity (ULP) users. Returns array; each ULP user includes (Integration API 7.1.83-verified): id, modelKey, firstName, lastName, fullName, status (e.g. ACTIVE). Enrolled-credential detail (NFC cards, fingerprints) is NOT exposed by this API surface.",
+        description: "List all UniFi Identity (ULP) users. Returns array; each ULP user includes (Integration API 7.3.47-verified): id, modelKey, firstName, lastName, fullName, email (empty string for service accounts), status (e.g. ACTIVE). Enrolled-credential detail (NFC cards, fingerprints) is NOT exposed by this API surface.",
         outputSchema: misc_js_1.ulpUserListOutputSchema,
         annotations: safety_js_1.READ_ONLY,
     }, async () => {
@@ -48,7 +48,7 @@ function registerUserTools(server, client) {
         }
     });
     server.registerTool("protect_get_ulp_user", {
-        description: "Get details for a specific UniFi Identity (ULP) user by ID. Returns: id, modelKey, firstName, lastName, fullName, status.",
+        description: "Get details for a specific UniFi Identity (ULP) user by ID. Returns: id, modelKey, firstName, lastName, fullName, email, status.",
         inputSchema: { id: zod_1.z.string().describe("ULP user ID") },
         outputSchema: misc_js_1.ulpUserOutputSchema,
         annotations: safety_js_1.READ_ONLY,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@owine/unifi-protect-mcp",
-  "version": "2.12.0",
+  "version": "2.13.0",
   "description": "MCP server for UniFi Protect Integration API",
   "main": "dist/index.js",
   "bin": {