@owine/unifi-protect-mcp 2.6.0 → 2.7.1

package/dist/tools/users.js

@@ -5,9 +5,11 @@ 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 misc_js_1 = require("../schemas/misc.js");
 function registerUserTools(server, client) {
     server.registerTool("protect_list_users", {
-        description: "List all Protect users. Filtered by access permissions.",
+        description: "List all Protect users (filtered by the API key's access permissions). Returns array; each user includes (Integration API 7.1.60-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 () => {
         try {
@@ -19,8 +21,9 @@ function registerUserTools(server, client) {
         }
     });
     server.registerTool("protect_get_user", {
-        description: "Get details for a specific Protect user by ID",
+        description: "Get details for a specific Protect user by ID. Returns the same fields as protect_list_users entries: id, modelKey, name, firstName, lastName, email, ucoreUserId.",
         inputSchema: { id: zod_1.z.string().describe("User ID") },
+        outputSchema: misc_js_1.userOutputSchema,
         annotations: safety_js_1.READ_ONLY,
     }, async ({ id }) => {
         try {
@@ -32,7 +35,8 @@ function registerUserTools(server, client) {
         }
     });
     server.registerTool("protect_list_ulp_users", {
-        description: "List all UniFi Identity (ULP) users with enrolled credentials (NFC cards, fingerprints).",
+        description: "List all UniFi Identity (ULP) users. Returns array; each ULP user includes (Integration API 7.1.60-verified): id, modelKey, firstName, lastName, fullName, 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 () => {
         try {
@@ -44,8 +48,9 @@ function registerUserTools(server, client) {
         }
     });
     server.registerTool("protect_get_ulp_user", {
-        description: "Get details for a specific UniFi Identity (ULP) user by ID",
+        description: "Get details for a specific UniFi Identity (ULP) user by ID. Returns: id, modelKey, firstName, lastName, fullName, status.",
         inputSchema: { id: zod_1.z.string().describe("ULP user ID") },
+        outputSchema: misc_js_1.ulpUserOutputSchema,
         annotations: safety_js_1.READ_ONLY,
     }, async ({ id }) => {
         try {

package/dist/utils/responses.d.ts

@@ -3,6 +3,7 @@ export declare function formatSuccess(data: unknown): {
         type: "text";
         text: string;
     }[];
+    structuredContent: Record<string, unknown>;
 };
 export declare function formatError(err: unknown): {
     content: {

package/dist/utils/responses.js

@@ -3,10 +3,17 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.formatSuccess = formatSuccess;
 exports.formatError = formatError;
 function formatSuccess(data) {
+    // structuredContent must be an object/record per MCP spec. When the response
+    // is a primitive or array, wrap it under `result` so the SDK accepts it and
+    // schemas downstream wrap accordingly.
+    const structured = data !== null && typeof data === "object" && !Array.isArray(data)
+        ? data
+        : { result: data };
     return {
         content: [
             { type: "text", text: JSON.stringify(data, null, 2) },
         ],
+        structuredContent: structured,
     };
 }
 function formatError(err) {

package/dist/utils/safety.d.ts

@@ -20,6 +20,7 @@ export declare function formatDryRun(method: string, path: string, body?: unknow
         type: "text";
         text: string;
     }[];
+    structuredContent: Record<string, unknown>;
 };
 /**
  * Guard for destructive actions that require explicit confirmation.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@owine/unifi-protect-mcp",
-  "version": "2.6.0",
+  "version": "2.7.1",
   "description": "MCP server for UniFi Protect Integration API",
   "main": "dist/index.js",
   "bin": {
@@ -22,7 +22,7 @@
   "engines": {
     "node": "^22.13.0 || ^24.0.0"
   },
-  "packageManager": "pnpm@11.1.1",
+  "packageManager": "pnpm@11.2.2",
   "repository": {
     "type": "git",
     "url": "https://github.com/owine/unifi-protect-mcp.git"
@@ -38,18 +38,18 @@
   "license": "MIT",
   "dependencies": {
     "@modelcontextprotocol/sdk": "1.29.0",
-    "ws": "8.20.1",
+    "ws": "8.21.0",
     "zod": "4.4.3"
   },
   "devDependencies": {
     "@eslint/js": "10.0.1",
     "@types/node": "24.12.4",
     "@types/ws": "8.18.1",
-    "@vitest/coverage-v8": "4.1.6",
-    "eslint": "10.3.0",
-    "lefthook": "2.1.6",
+    "@vitest/coverage-v8": "4.1.7",
+    "eslint": "10.4.0",
+    "lefthook": "2.1.8",
     "typescript": "6.0.3",
-    "typescript-eslint": "8.59.3",
-    "vitest": "4.1.6"
+    "typescript-eslint": "8.59.4",
+    "vitest": "4.1.7"
   }
 }