@zudello/modelcontextprotocol 1.1.0 → 1.1.1

package/dist/tools/users/get-user-groups.js

@@ -2,10 +2,35 @@ import { logger } from "../../utils/logger.js";
 import { getZudelloUserGroups } from "../../services/zudello/users.js";
 export const zudelloGetUserGroups = {
     name: "zudelloGetUserGroups",
-    description: `Get user groups for the team.
+    description: `Retrieve user groups for the current team with smart filtering capabilities.
 
-Returns user group information including names and descriptions.
-Use when user asks about team groups or group membership.`,
+User groups are used for access control, approval workflows, and task assignment in Zudello.
+Each group has a name, description, type, and optionally a list of member user IDs.
+
+KEY FEATURES:
+- Smart filtering: Filter by status, type, name patterns, or general search
+- Performance optimized: Member ID lists excluded by default (use includeMemberIds: true when needed)
+- Pagination support: Handle large datasets with limit/offset parameters
+
+FILTERING OPTIONS:
+- status: Filter by ACTIVE/INACTIVE groups
+- userGroupType: Filter by type like 'LEGACY', 'ACCESS', 'APPROVAL'
+- search: Search across group names and descriptions
+- namePattern: Target specific name patterns (e.g., "Admin", "Project")
+- includeMemberIds: Include user ID arrays (default: false for performance)
+
+COMMON USE CASES:
+- List all active groups: {status: "ACTIVE"}
+- Find admin groups: {namePattern: "admin"}
+- Search for project groups: {search: "project"}
+- Get finance groups with members: {namePattern: "finance", includeMemberIds: true}
+- Find approval groups: {userGroupType: "APPROVAL"}
+
+RESPONSE INCLUDES:
+- Group details: UUID, name, description, status, type
+- Member count: Number of users in each group
+- Member IDs: Only when includeMemberIds is true
+- Pagination metadata: Total count, returned count, offset, limit`,
     inputSchema: {
         type: "object",
         properties: {

package/dist/tools/users/get-user-groups.js.map

@@ -1 +1 @@
-{"version":3,"file":"get-user-groups.js","sourceRoot":"","sources":["../../../src/tools/users/get-user-groups.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAC/C,OAAO,EAAE,oBAAoB,EAAE,MAAM,iCAAiC,CAAC;AAGvE,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,IAAI,EAAE,sBAAsB;IAC5B,WAAW,EAAE;;;0DAG2C;IACxD,WAAW,EAAE;QACX,IAAI,EAAE,QAAiB;QACvB,UAAU,EAAE;YACV,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,sCAAsC,EAAE;YAC9E,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,6BAA6B,EAAE;SACvE;KACF;IACD,OAAO,EAAE,KAAK,EAAE,KAA0C,EAAE,WAAwB,EAAE,EAAE;QACtF,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,oBAAoB,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC;YAChE,IAAI,CAAC,QAAQ,CAAC,OAAO;gBAAE,MAAM,IAAI,KAAK,CAAC,QAAQ,CAAC,KAAK,IAAI,2BAA2B,CAAC,CAAC;YACtF,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,UAAU,EAAE,QAAQ,CAAC,IAAI,EAAE,UAAU,IAAI,EAAE;gBAC3C,QAAQ,EAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ;aAClC,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,KAAK,CAAC,4BAA4B,EAAE,KAAK,EAAE,KAAc,CAAC,CAAC;YAClE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAG,KAAe,CAAC,OAAO,EAAE,UAAU,EAAE,EAAE,EAAE,CAAC;QAC7E,CAAC;IACH,CAAC;CACF,CAAC"}
+{"version":3,"file":"get-user-groups.js","sourceRoot":"","sources":["../../../src/tools/users/get-user-groups.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAC/C,OAAO,EAAE,oBAAoB,EAAE,MAAM,iCAAiC,CAAC;AAGvE,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,IAAI,EAAE,sBAAsB;IAC5B,WAAW,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;kEA4BmD;IAChE,WAAW,EAAE;QACX,IAAI,EAAE,QAAiB;QACvB,UAAU,EAAE;YACV,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,sCAAsC,EAAE;YAC9E,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,6BAA6B,EAAE;SACvE;KACF;IACD,OAAO,EAAE,KAAK,EAAE,KAA0C,EAAE,WAAwB,EAAE,EAAE;QACtF,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,oBAAoB,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC;YAChE,IAAI,CAAC,QAAQ,CAAC,OAAO;gBAAE,MAAM,IAAI,KAAK,CAAC,QAAQ,CAAC,KAAK,IAAI,2BAA2B,CAAC,CAAC;YACtF,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,UAAU,EAAE,QAAQ,CAAC,IAAI,EAAE,UAAU,IAAI,EAAE;gBAC3C,QAAQ,EAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ;aAClC,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,KAAK,CAAC,4BAA4B,EAAE,KAAK,EAAE,KAAc,CAAC,CAAC;YAClE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAG,KAAe,CAAC,OAAO,EAAE,UAAU,EAAE,EAAE,EAAE,CAAC;QAC7E,CAAC;IACH,CAAC;CACF,CAAC"}

package/dist/tools/users/get-users.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"get-users.d.ts","sourceRoot":"","sources":["../../../src/tools/users/get-users.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAEzD,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;qBAkBjB;QACL,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,eACY,WAAW;;;;;;;;;;;;;;;;;;;;;;;;CAwB3B,CAAC"}
+{"version":3,"file":"get-users.d.ts","sourceRoot":"","sources":["../../../src/tools/users/get-users.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAEzD,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;qBAiDjB;QACL,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,eACY,WAAW;;;;;;;;;;;;;;;;;;;;;;;;CAwB3B,CAAC"}

package/dist/tools/users/get-users.js

@@ -2,10 +2,41 @@ import { logger } from "../../utils/logger.js";
 import { getZudelloUsers } from "../../services/zudello/users.js";
 export const zudelloGetUsers = {
     name: "zudelloGetUsers",
-    description: `Get team users with filtering and pagination.
+    description: `Retrieve team users with smart filtering capabilities.
 
-Returns user information including names, emails, status, and avatars.
-Supports filtering by status, name patterns, email domains, and general search.`,
+Team users represent people who have access to the Zudello system for this team.
+Each user has personal information, email, avatar, and status.
+
+KEY FEATURES:
+- Smart filtering: Filter by status, names, email patterns, or general search
+- Flexible search: Search across names and emails simultaneously
+- Domain filtering: Find users by email domain (e.g., employees vs contractors)
+- Pagination support: Handle large user lists efficiently
+
+FILTERING OPTIONS:
+- status: Filter by ACTIVE/INACTIVE users
+- search: Search across first name, last name, and email
+- namePattern: Target specific name patterns (e.g., "John", "Smith")
+- emailDomain: Filter by email domain (e.g., "@company.com", "@contractor.com")
+
+COMMON USE CASES:
+- List all active users: {status: "ACTIVE"}
+- Find users named John: {namePattern: "john"}
+- Search for finance team: {search: "finance"}
+- Get all contractors: {emailDomain: "@contractor.com"}
+- Find specific user: {search: "john.smith@company.com"}
+- List employees only: {emailDomain: "@company.com"}
+
+RESPONSE INCLUDES:
+- User details: UUID, first name, last name, email
+- Status: ACTIVE or INACTIVE
+- Avatar: Profile picture URL (if available)
+- Pagination metadata: Total count, returned count, offset, limit
+
+TYPICAL WORKFLOW:
+1. Search broadly first: {search: "john"}
+2. Narrow down with specific filters: {namePattern: "john", emailDomain: "@company.com"}
+3. Use pagination for large result sets: {limit: 50, offset: 0}`,
     inputSchema: {
         type: "object",
         properties: {

package/dist/tools/users/get-users.js.map

@@ -1 +1 @@
-{"version":3,"file":"get-users.js","sourceRoot":"","sources":["../../../src/tools/users/get-users.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAC/C,OAAO,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAGlE,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,IAAI,EAAE,iBAAiB;IACvB,WAAW,EAAE;;;gFAGiE;IAC9E,WAAW,EAAE;QACX,IAAI,EAAE,QAAiB;QACvB,UAAU,EAAE;YACV,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,oCAAoC,EAAE;YAC7E,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,gCAAgC,EAAE;YACzE,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,wBAAwB,EAAE;YACtE,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,wBAAwB,EAAE;YACtE,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,4BAA4B,EAAE;YACpE,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,mBAAmB,EAAE;SAC7D;KACF;IACD,OAAO,EAAE,KAAK,EACZ,KAOC,EACD,WAAwB,EACxB,EAAE;QACF,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,eAAe,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC;YAC3D,IAAI,CAAC,QAAQ,CAAC,OAAO;gBAAE,MAAM,IAAI,KAAK,CAAC,QAAQ,CAAC,KAAK,IAAI,qBAAqB,CAAC,CAAC;YAChF,MAAM,KAAK,GAAG,QAAQ,CAAC,IAAI,EAAE,KAAK,IAAI,EAAE,CAAC;YACzC,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;oBACvB,IAAI,EAAE,CAAC,CAAC,IAAI;oBACZ,SAAS,EAAE,CAAC,CAAC,UAAU;oBACvB,QAAQ,EAAE,CAAC,CAAC,SAAS;oBACrB,QAAQ,EAAE,GAAG,CAAC,CAAC,UAAU,IAAI,CAAC,CAAC,SAAS,EAAE,CAAC,IAAI,EAAE;oBACjD,KAAK,EAAE,CAAC,CAAC,KAAK;oBACd,MAAM,EAAE,CAAC,CAAC,MAAM;oBAChB,MAAM,EAAE,CAAC,CAAC,MAAM;iBACjB,CAAC,CAAC;gBACH,QAAQ,EAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ;aAClC,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,KAAK,CAAC,uBAAuB,EAAE,KAAK,EAAE,KAAc,CAAC,CAAC;YAC7D,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAG,KAAe,CAAC,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC;QACxE,CAAC;IACH,CAAC;CACF,CAAC"}
+{"version":3,"file":"get-users.js","sourceRoot":"","sources":["../../../src/tools/users/get-users.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAC/C,OAAO,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAGlE,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,IAAI,EAAE,iBAAiB;IACvB,WAAW,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;gEAkCiD;IAC9D,WAAW,EAAE;QACX,IAAI,EAAE,QAAiB;QACvB,UAAU,EAAE;YACV,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,oCAAoC,EAAE;YAC7E,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,gCAAgC,EAAE;YACzE,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,wBAAwB,EAAE;YACtE,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,wBAAwB,EAAE;YACtE,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,4BAA4B,EAAE;YACpE,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,mBAAmB,EAAE;SAC7D;KACF;IACD,OAAO,EAAE,KAAK,EACZ,KAOC,EACD,WAAwB,EACxB,EAAE;QACF,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,eAAe,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC;YAC3D,IAAI,CAAC,QAAQ,CAAC,OAAO;gBAAE,MAAM,IAAI,KAAK,CAAC,QAAQ,CAAC,KAAK,IAAI,qBAAqB,CAAC,CAAC;YAChF,MAAM,KAAK,GAAG,QAAQ,CAAC,IAAI,EAAE,KAAK,IAAI,EAAE,CAAC;YACzC,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;oBACvB,IAAI,EAAE,CAAC,CAAC,IAAI;oBACZ,SAAS,EAAE,CAAC,CAAC,UAAU;oBACvB,QAAQ,EAAE,CAAC,CAAC,SAAS;oBACrB,QAAQ,EAAE,GAAG,CAAC,CAAC,UAAU,IAAI,CAAC,CAAC,SAAS,EAAE,CAAC,IAAI,EAAE;oBACjD,KAAK,EAAE,CAAC,CAAC,KAAK;oBACd,MAAM,EAAE,CAAC,CAAC,MAAM;oBAChB,MAAM,EAAE,CAAC,CAAC,MAAM;iBACjB,CAAC,CAAC;gBACH,QAAQ,EAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ;aAClC,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,KAAK,CAAC,uBAAuB,EAAE,KAAK,EAAE,KAAc,CAAC,CAAC;YAC7D,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAG,KAAe,CAAC,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC;QACxE,CAAC;IACH,CAAC;CACF,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zudello/modelcontextprotocol",
-  "version": "1.1.0",
+  "version": "1.1.1",
   "description": "MCP server exposing 106 Zudello ERP automation tools for Claude Desktop and other MCP-compatible clients",
   "type": "module",
   "main": "dist/index.js",