portkey-admin-mcp 0.8.0 → 0.9.0

package/build/index.js

@@ -2684,6 +2684,14 @@ function buildConfigPayload(params) {
 function hasConfigSettings(config) {
   return config.cache !== void 0 || config.retry !== void 0 || config.strategy !== void 0 || config.targets !== void 0;
 }
+var createConfigSchema = z5.object(CONFIGS_TOOL_SCHEMAS.createConfig).superRefine((value, ctx) => {
+  if (!hasConfigSettings(buildConfigPayload(value))) {
+    ctx.addIssue({
+      code: z5.ZodIssueCode.custom,
+      message: "At least one config setting (cache_mode, retry_attempts, strategy_mode, or targets) must be provided"
+    });
+  }
+});
 function registerConfigsTools(server, service) {
   server.tool(
     "list_configs",
@@ -2749,25 +2757,15 @@ function registerConfigsTools(server, service) {
     "Create a config that defines routing, cache, retry, and targets for requests; use update_config to modify an existing one and list_config_versions for history. At least one setting is required, new configs become active immediately once referenced by a key or prompt, and the call returns the new id and version_id.",
     CONFIGS_TOOL_SCHEMAS.createConfig,
     async (params) => {
-      const config = buildConfigPayload(params);
-      if (!hasConfigSettings(config)) {
-        return {
-          content: [
-            {
-              type: "text",
-              text: "Error creating configuration: At least one config setting (cache_mode, retry_attempts, strategy_mode, or targets) must be provided"
-            }
-          ],
-          isError: true
-        };
-      }
+      const validated = createConfigSchema.parse(params);
+      const config = buildConfigPayload(validated);
       const result = await service.configs.createConfig({
-        name: params.name,
+        name: validated.name,
         config,
-        workspace_id: params.workspace_id
+        workspace_id: validated.workspace_id
       });
       return jsonResult({
-        message: `Successfully created configuration "${params.name}"`,
+        message: `Successfully created configuration "${validated.name}"`,
         id: result.id,
         version_id: result.version_id
       });
@@ -3396,6 +3394,16 @@ var INTEGRATIONS_TOOL_SCHEMAS = {
     default_provider_slug: z8.string().optional().describe("Default slug for providers auto-created in workspaces")
   }
 };
+var updateIntegrationWorkspacesSchema = z8.object(INTEGRATIONS_TOOL_SCHEMAS.updateIntegrationWorkspaces).superRefine((value, ctx) => {
+  const hasGlobalLimits = value.global_credit_limit !== void 0 || value.global_alert_threshold !== void 0 || value.global_rate_limit_rpm !== void 0;
+  if (hasGlobalLimits && value.global_workspace_access_enabled === void 0) {
+    ctx.addIssue({
+      code: z8.ZodIssueCode.custom,
+      path: ["global_workspace_access_enabled"],
+      message: "global_workspace_access_enabled is required when setting global limits."
+    });
+  }
+});
 function buildIntegrationConfigurations(params) {
   const configurations = {};
   if (params.api_version !== void 0)
@@ -3673,19 +3681,8 @@ function registerIntegrationsTools(server, service) {
       idempotentHint: true,
       openWorldHint: true
     },
-    async (params) => {
-      const hasGlobalLimits = params.global_credit_limit !== void 0 || params.global_alert_threshold !== void 0 || params.global_rate_limit_rpm !== void 0;
-      if (hasGlobalLimits && params.global_workspace_access_enabled === void 0) {
-        return {
-          content: [
-            {
-              type: "text",
-              text: "global_workspace_access_enabled is required when setting global limits."
-            }
-          ],
-          isError: true
-        };
-      }
+    async (rawParams) => {
+      const params = updateIntegrationWorkspacesSchema.parse(rawParams);
       const globalUsageLimits = params.global_credit_limit !== void 0 || params.global_alert_threshold !== void 0 ? [
         {
           type: "cost",
@@ -4163,23 +4160,21 @@ var LABELS_TOOL_SCHEMAS = {
     label_id: z10.string().describe("Label ID to delete")
   }
 };
+var createPromptLabelSchema = z10.object(LABELS_TOOL_SCHEMAS.createPromptLabel).superRefine((value, ctx) => {
+  if (!value.organisation_id && !value.workspace_id) {
+    ctx.addIssue({
+      code: z10.ZodIssueCode.custom,
+      message: "Either organisation_id or workspace_id is required"
+    });
+  }
+});
 function registerLabelsTools(server, service) {
   server.tool(
     "create_prompt_label",
     "Create a prompt label for tagging prompt versions such as production, staging, or experiment. Requires either organisation_id or workspace_id to set scope, returns the new label id, and does not assign it to any versions yet.",
     LABELS_TOOL_SCHEMAS.createPromptLabel,
-    async (params) => {
-      if (!params.organisation_id && !params.workspace_id) {
-        return {
-          content: [
-            {
-              type: "text",
-              text: "Error: Either organisation_id or workspace_id is required"
-            }
-          ],
-          isError: true
-        };
-      }
+    async (rawParams) => {
+      const params = createPromptLabelSchema.parse(rawParams);
       const result = await service.labels.createLabel({
         name: params.name,
         organisation_id: params.organisation_id,
@@ -4589,12 +4584,13 @@ var logExportFieldSchema = z12.enum([
   "prompt_slug",
   "metadata"
 ]);
-var getLogInputSchema = z12.object({
+var getLogShape = {
   log_id: z12.string().describe("Gateway log ID to retrieve"),
   path_format: z12.enum(["v1", "v2"]).optional().describe("Log storage path format; defaults to v1"),
   created_at: z12.iso.datetime({ offset: true }).optional().describe("Log creation timestamp in ISO 8601 format; required for v2"),
   type: z12.enum(["hooks"]).optional().describe("Set to hooks when retrieving a hook execution log")
-}).superRefine((input, context) => {
+};
+var getLogSchema = z12.object(getLogShape).superRefine((input, context) => {
   if (input.path_format === "v2" && input.created_at === void 0) {
     context.addIssue({
       code: "custom",
@@ -4675,7 +4671,7 @@ function registerLoggingTools(server, service) {
     "get_log",
     {
       description: "Get one gateway request log by ID, including its request, response, usage, cost, and metadata payload when available. For path_format v2, also provide the log's created_at timestamp.",
-      inputSchema: getLogInputSchema,
+      inputSchema: getLogShape,
       annotations: {
         title: "Get Gateway Log",
         readOnlyHint: true,
@@ -4684,7 +4680,8 @@ function registerLoggingTools(server, service) {
         openWorldHint: true
       }
     },
-    async (params) => {
+    async (rawParams) => {
+      const params = getLogSchema.parse(rawParams);
       const result = await service.logging.getLog(params.log_id, {
         path_format: params.path_format,
         created_at: params.created_at,
@@ -4976,6 +4973,17 @@ var MCP_INTEGRATIONS_TOOL_SCHEMAS = {
     ).min(1).describe("Array of workspace access updates")
   }
 };
+var createMcpIntegrationSchema = z13.object(MCP_INTEGRATIONS_TOOL_SCHEMAS.createMcpIntegration).superRefine((value, ctx) => {
+  if (value.auth_type === "headers" && (!value.custom_headers || Object.keys(value.custom_headers).length === 0) && !value.secret_mappings?.some(
+    (mapping) => mapping.target_field === "configurations.custom_headers"
+  )) {
+    ctx.addIssue({
+      code: z13.ZodIssueCode.custom,
+      path: ["custom_headers"],
+      message: "custom_headers must be provided when auth_type is 'headers'"
+    });
+  }
+});
 function isRecord2(value) {
   return typeof value === "object" && value !== null;
 }
@@ -5054,20 +5062,8 @@ function registerMcpIntegrationsTools(server, service) {
       idempotentHint: false,
       openWorldHint: true
     },
-    async (params) => {
-      if (params.auth_type === "headers" && (!params.custom_headers || Object.keys(params.custom_headers).length === 0) && !params.secret_mappings?.some(
-        (mapping) => mapping.target_field === "configurations.custom_headers"
-      )) {
-        return {
-          content: [
-            {
-              type: "text",
-              text: "Error: custom_headers must be provided when auth_type is 'headers'"
-            }
-          ],
-          isError: true
-        };
-      }
+    async (rawParams) => {
+      const params = createMcpIntegrationSchema.parse(rawParams);
       const { custom_headers, ...rest } = params;
       const result = await service.mcpIntegrations.createMcpIntegration({
         ...rest,
@@ -5904,6 +5900,28 @@ var PROMPTS_TOOL_SCHEMAS = {
     )
   }
 };
+var createPromptSchema = z17.object(PROMPTS_TOOL_SCHEMAS.createPrompt).superRefine((value, ctx) => {
+  if (!value.model && !value.ai_model_id && !value.finetune_id) {
+    ctx.addIssue({
+      code: z17.ZodIssueCode.custom,
+      message: "At least one of model, ai_model_id, or finetune_id must be provided"
+    });
+  }
+  if (value.string === void 0 && value.messages === void 0) {
+    ctx.addIssue({
+      code: z17.ZodIssueCode.custom,
+      message: "Provide either string or messages"
+    });
+  }
+});
+var migratePromptSchema = z17.object(PROMPTS_TOOL_SCHEMAS.migratePrompt).superRefine((value, ctx) => {
+  if (value.string === void 0 && value.messages === void 0) {
+    ctx.addIssue({
+      code: z17.ZodIssueCode.custom,
+      message: "Provide either string or messages"
+    });
+  }
+});
 function normalizePromptTemplateString(params) {
   if (params.string !== void 0) {
     return params.string;
@@ -5978,30 +5996,9 @@ function registerPromptsTools(server, service) {
     "create_prompt",
     "Create a new prompt template and initial version. Use this for first-time setup; use migrate_prompt for idempotent CI/CD flows. Accepts plain text or structured chat messages, creates a new version immediately, and returns the prompt id, slug, and version id. For multi-message chat prompts pass messages (preferred) or a JSON-encoded array as string.",
     PROMPTS_TOOL_SCHEMAS.createPrompt,
-    async (params) => {
-      if (!params.model && !params.ai_model_id && !params.finetune_id) {
-        return {
-          content: [
-            {
-              type: "text",
-              text: "Error creating prompt: At least one of model, ai_model_id, or finetune_id must be provided"
-            }
-          ],
-          isError: true
-        };
-      }
+    async (rawParams) => {
+      const params = createPromptSchema.parse(rawParams);
       const templateString = normalizePromptTemplateString(params);
-      if (templateString === void 0) {
-        return {
-          content: [
-            {
-              type: "text",
-              text: "Error creating prompt: Provide either string or messages"
-            }
-          ],
-          isError: true
-        };
-      }
       if (params.dry_run) {
         return jsonResult({
           dry_run: true,
@@ -6256,19 +6253,9 @@ function registerPromptsTools(server, service) {
       idempotentHint: true,
       openWorldHint: false
     },
-    async (params) => {
+    async (rawParams) => {
+      const params = migratePromptSchema.parse(rawParams);
       const templateString = normalizePromptTemplateString(params);
-      if (templateString === void 0) {
-        return {
-          content: [
-            {
-              type: "text",
-              text: "Error migrating prompt: Provide either string or messages"
-            }
-          ],
-          isError: true
-        };
-      }
       const result = await service.prompts.migratePrompt({
         name: params.name,
         app: params.app,
@@ -7234,7 +7221,7 @@ var scimWorkspaceMappingBaseShape = {
   workspace_id: z22.string().describe("Portkey workspace ID that the SCIM group should access"),
   role: z22.enum(["admin", "member", "manager"]).describe("Workspace role automatically granted to group members")
 };
-var createScimWorkspaceMappingInputSchema = z22.object({
+var createScimWorkspaceMappingShape = {
   ...scimWorkspaceMappingBaseShape,
   scim_group_id: z22.string().min(1).optional().describe(
     "Existing identity-provider SCIM group ID; provide this or scim_group_name, but not both"
@@ -7242,7 +7229,8 @@ var createScimWorkspaceMappingInputSchema = z22.object({
   scim_group_name: z22.string().min(1).optional().describe(
     "Existing SCIM group display name; provide this or scim_group_id, but not both"
   )
-}).superRefine((input, context) => {
+};
+var createScimWorkspaceMappingSchema = z22.object(createScimWorkspaceMappingShape).superRefine((input, context) => {
   if (Boolean(input.scim_group_id) === Boolean(input.scim_group_name)) {
     context.addIssue({
       code: "custom",
@@ -7397,7 +7385,7 @@ function registerWorkspacesTools(server, service) {
     "create_scim_workspace_mapping",
     {
       description: "Map one identity-provider SCIM group to a Portkey workspace role so current and future group members receive access automatically. Provide exactly one of scim_group_id or scim_group_name; a name can pre-create the Portkey SCIM group before the IdP provisions it. Use list_scim_groups to discover existing groups and list_workspaces for the workspace ID. This changes access provisioning and is distinct from add_workspace_member, which grants one user directly.",
-      inputSchema: createScimWorkspaceMappingInputSchema,
+      inputSchema: createScimWorkspaceMappingShape,
       annotations: {
         title: "Create SCIM Workspace Mapping",
         readOnlyHint: false,
@@ -7406,7 +7394,8 @@ function registerWorkspacesTools(server, service) {
         openWorldHint: true
       }
     },
-    async (params) => {
+    async (rawParams) => {
+      const params = createScimWorkspaceMappingSchema.parse(rawParams);
       let request;
       if (params.scim_group_id !== void 0) {
         request = {
@@ -7767,7 +7756,25 @@ function augmentToolDescription(toolName, description) {
   }
   return `${description} ${ENTERPRISE_GATED_DESCRIPTION_NOTE}`;
 }
+function formatZodIssues(error) {
+  return error.issues.map((issue) => {
+    const path = issue.path.join(".");
+    if (!path) {
+      return issue.message;
+    }
+    const namesPath = new RegExp(`\\b${escapeRegExp(path)}\\b`).test(
+      issue.message
+    );
+    return namesPath ? issue.message : `${path}: ${issue.message}`;
+  }).join("; ");
+}
+function escapeRegExp(value) {
+  return value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
 function getToolErrorMessage(error) {
+  if (error instanceof z23.ZodError) {
+    return formatZodIssues(error);
+  }
   if (error instanceof Error && error.message) {
     return error.message;
   }
@@ -7914,14 +7921,14 @@ function wrapToolCallback(toolName, callback) {
       return normalizeToolResult(await callback(...args));
     } catch (error) {
       const message = getToolErrorMessage(error);
+      const isValidationError = error instanceof z23.ZodError;
+      const text = isValidationError ? `Invalid arguments for "${toolName}": ${message}` : `Tool "${toolName}" failed: ${message}`;
       Logger.error("Tool callback failed", {
         error: message,
         metadata: { toolName }
       });
       return normalizeToolResult({
-        content: [
-          { type: "text", text: `Tool "${toolName}" failed: ${message}` }
-        ],
+        content: [{ type: "text", text }],
         isError: true
       });
     }

package/build/server.js

@@ -2701,6 +2701,14 @@ function buildConfigPayload(params) {
 function hasConfigSettings(config) {
   return config.cache !== void 0 || config.retry !== void 0 || config.strategy !== void 0 || config.targets !== void 0;
 }
+var createConfigSchema = z5.object(CONFIGS_TOOL_SCHEMAS.createConfig).superRefine((value, ctx) => {
+  if (!hasConfigSettings(buildConfigPayload(value))) {
+    ctx.addIssue({
+      code: z5.ZodIssueCode.custom,
+      message: "At least one config setting (cache_mode, retry_attempts, strategy_mode, or targets) must be provided"
+    });
+  }
+});
 function registerConfigsTools(server, service) {
   server.tool(
     "list_configs",
@@ -2766,25 +2774,15 @@ function registerConfigsTools(server, service) {
     "Create a config that defines routing, cache, retry, and targets for requests; use update_config to modify an existing one and list_config_versions for history. At least one setting is required, new configs become active immediately once referenced by a key or prompt, and the call returns the new id and version_id.",
     CONFIGS_TOOL_SCHEMAS.createConfig,
     async (params) => {
-      const config = buildConfigPayload(params);
-      if (!hasConfigSettings(config)) {
-        return {
-          content: [
-            {
-              type: "text",
-              text: "Error creating configuration: At least one config setting (cache_mode, retry_attempts, strategy_mode, or targets) must be provided"
-            }
-          ],
-          isError: true
-        };
-      }
+      const validated = createConfigSchema.parse(params);
+      const config = buildConfigPayload(validated);
       const result = await service.configs.createConfig({
-        name: params.name,
+        name: validated.name,
         config,
-        workspace_id: params.workspace_id
+        workspace_id: validated.workspace_id
       });
       return jsonResult({
-        message: `Successfully created configuration "${params.name}"`,
+        message: `Successfully created configuration "${validated.name}"`,
         id: result.id,
         version_id: result.version_id
       });
@@ -3413,6 +3411,16 @@ var INTEGRATIONS_TOOL_SCHEMAS = {
     default_provider_slug: z8.string().optional().describe("Default slug for providers auto-created in workspaces")
   }
 };
+var updateIntegrationWorkspacesSchema = z8.object(INTEGRATIONS_TOOL_SCHEMAS.updateIntegrationWorkspaces).superRefine((value, ctx) => {
+  const hasGlobalLimits = value.global_credit_limit !== void 0 || value.global_alert_threshold !== void 0 || value.global_rate_limit_rpm !== void 0;
+  if (hasGlobalLimits && value.global_workspace_access_enabled === void 0) {
+    ctx.addIssue({
+      code: z8.ZodIssueCode.custom,
+      path: ["global_workspace_access_enabled"],
+      message: "global_workspace_access_enabled is required when setting global limits."
+    });
+  }
+});
 function buildIntegrationConfigurations(params) {
   const configurations = {};
   if (params.api_version !== void 0)
@@ -3690,19 +3698,8 @@ function registerIntegrationsTools(server, service) {
       idempotentHint: true,
       openWorldHint: true
     },
-    async (params) => {
-      const hasGlobalLimits = params.global_credit_limit !== void 0 || params.global_alert_threshold !== void 0 || params.global_rate_limit_rpm !== void 0;
-      if (hasGlobalLimits && params.global_workspace_access_enabled === void 0) {
-        return {
-          content: [
-            {
-              type: "text",
-              text: "global_workspace_access_enabled is required when setting global limits."
-            }
-          ],
-          isError: true
-        };
-      }
+    async (rawParams) => {
+      const params = updateIntegrationWorkspacesSchema.parse(rawParams);
       const globalUsageLimits = params.global_credit_limit !== void 0 || params.global_alert_threshold !== void 0 ? [
         {
           type: "cost",
@@ -4180,23 +4177,21 @@ var LABELS_TOOL_SCHEMAS = {
     label_id: z10.string().describe("Label ID to delete")
   }
 };
+var createPromptLabelSchema = z10.object(LABELS_TOOL_SCHEMAS.createPromptLabel).superRefine((value, ctx) => {
+  if (!value.organisation_id && !value.workspace_id) {
+    ctx.addIssue({
+      code: z10.ZodIssueCode.custom,
+      message: "Either organisation_id or workspace_id is required"
+    });
+  }
+});
 function registerLabelsTools(server, service) {
   server.tool(
     "create_prompt_label",
     "Create a prompt label for tagging prompt versions such as production, staging, or experiment. Requires either organisation_id or workspace_id to set scope, returns the new label id, and does not assign it to any versions yet.",
     LABELS_TOOL_SCHEMAS.createPromptLabel,
-    async (params) => {
-      if (!params.organisation_id && !params.workspace_id) {
-        return {
-          content: [
-            {
-              type: "text",
-              text: "Error: Either organisation_id or workspace_id is required"
-            }
-          ],
-          isError: true
-        };
-      }
+    async (rawParams) => {
+      const params = createPromptLabelSchema.parse(rawParams);
       const result = await service.labels.createLabel({
         name: params.name,
         organisation_id: params.organisation_id,
@@ -4606,12 +4601,13 @@ var logExportFieldSchema = z12.enum([
   "prompt_slug",
   "metadata"
 ]);
-var getLogInputSchema = z12.object({
+var getLogShape = {
   log_id: z12.string().describe("Gateway log ID to retrieve"),
   path_format: z12.enum(["v1", "v2"]).optional().describe("Log storage path format; defaults to v1"),
   created_at: z12.iso.datetime({ offset: true }).optional().describe("Log creation timestamp in ISO 8601 format; required for v2"),
   type: z12.enum(["hooks"]).optional().describe("Set to hooks when retrieving a hook execution log")
-}).superRefine((input, context) => {
+};
+var getLogSchema = z12.object(getLogShape).superRefine((input, context) => {
   if (input.path_format === "v2" && input.created_at === void 0) {
     context.addIssue({
       code: "custom",
@@ -4692,7 +4688,7 @@ function registerLoggingTools(server, service) {
     "get_log",
     {
       description: "Get one gateway request log by ID, including its request, response, usage, cost, and metadata payload when available. For path_format v2, also provide the log's created_at timestamp.",
-      inputSchema: getLogInputSchema,
+      inputSchema: getLogShape,
       annotations: {
         title: "Get Gateway Log",
         readOnlyHint: true,
@@ -4701,7 +4697,8 @@ function registerLoggingTools(server, service) {
         openWorldHint: true
       }
     },
-    async (params) => {
+    async (rawParams) => {
+      const params = getLogSchema.parse(rawParams);
       const result = await service.logging.getLog(params.log_id, {
         path_format: params.path_format,
         created_at: params.created_at,
@@ -4993,6 +4990,17 @@ var MCP_INTEGRATIONS_TOOL_SCHEMAS = {
     ).min(1).describe("Array of workspace access updates")
   }
 };
+var createMcpIntegrationSchema = z13.object(MCP_INTEGRATIONS_TOOL_SCHEMAS.createMcpIntegration).superRefine((value, ctx) => {
+  if (value.auth_type === "headers" && (!value.custom_headers || Object.keys(value.custom_headers).length === 0) && !value.secret_mappings?.some(
+    (mapping) => mapping.target_field === "configurations.custom_headers"
+  )) {
+    ctx.addIssue({
+      code: z13.ZodIssueCode.custom,
+      path: ["custom_headers"],
+      message: "custom_headers must be provided when auth_type is 'headers'"
+    });
+  }
+});
 function isRecord2(value) {
   return typeof value === "object" && value !== null;
 }
@@ -5071,20 +5079,8 @@ function registerMcpIntegrationsTools(server, service) {
       idempotentHint: false,
       openWorldHint: true
     },
-    async (params) => {
-      if (params.auth_type === "headers" && (!params.custom_headers || Object.keys(params.custom_headers).length === 0) && !params.secret_mappings?.some(
-        (mapping) => mapping.target_field === "configurations.custom_headers"
-      )) {
-        return {
-          content: [
-            {
-              type: "text",
-              text: "Error: custom_headers must be provided when auth_type is 'headers'"
-            }
-          ],
-          isError: true
-        };
-      }
+    async (rawParams) => {
+      const params = createMcpIntegrationSchema.parse(rawParams);
       const { custom_headers, ...rest } = params;
       const result = await service.mcpIntegrations.createMcpIntegration({
         ...rest,
@@ -5921,6 +5917,28 @@ var PROMPTS_TOOL_SCHEMAS = {
     )
   }
 };
+var createPromptSchema = z17.object(PROMPTS_TOOL_SCHEMAS.createPrompt).superRefine((value, ctx) => {
+  if (!value.model && !value.ai_model_id && !value.finetune_id) {
+    ctx.addIssue({
+      code: z17.ZodIssueCode.custom,
+      message: "At least one of model, ai_model_id, or finetune_id must be provided"
+    });
+  }
+  if (value.string === void 0 && value.messages === void 0) {
+    ctx.addIssue({
+      code: z17.ZodIssueCode.custom,
+      message: "Provide either string or messages"
+    });
+  }
+});
+var migratePromptSchema = z17.object(PROMPTS_TOOL_SCHEMAS.migratePrompt).superRefine((value, ctx) => {
+  if (value.string === void 0 && value.messages === void 0) {
+    ctx.addIssue({
+      code: z17.ZodIssueCode.custom,
+      message: "Provide either string or messages"
+    });
+  }
+});
 function normalizePromptTemplateString(params) {
   if (params.string !== void 0) {
     return params.string;
@@ -5995,30 +6013,9 @@ function registerPromptsTools(server, service) {
     "create_prompt",
     "Create a new prompt template and initial version. Use this for first-time setup; use migrate_prompt for idempotent CI/CD flows. Accepts plain text or structured chat messages, creates a new version immediately, and returns the prompt id, slug, and version id. For multi-message chat prompts pass messages (preferred) or a JSON-encoded array as string.",
     PROMPTS_TOOL_SCHEMAS.createPrompt,
-    async (params) => {
-      if (!params.model && !params.ai_model_id && !params.finetune_id) {
-        return {
-          content: [
-            {
-              type: "text",
-              text: "Error creating prompt: At least one of model, ai_model_id, or finetune_id must be provided"
-            }
-          ],
-          isError: true
-        };
-      }
+    async (rawParams) => {
+      const params = createPromptSchema.parse(rawParams);
       const templateString = normalizePromptTemplateString(params);
-      if (templateString === void 0) {
-        return {
-          content: [
-            {
-              type: "text",
-              text: "Error creating prompt: Provide either string or messages"
-            }
-          ],
-          isError: true
-        };
-      }
       if (params.dry_run) {
         return jsonResult({
           dry_run: true,
@@ -6273,19 +6270,9 @@ function registerPromptsTools(server, service) {
       idempotentHint: true,
       openWorldHint: false
     },
-    async (params) => {
+    async (rawParams) => {
+      const params = migratePromptSchema.parse(rawParams);
       const templateString = normalizePromptTemplateString(params);
-      if (templateString === void 0) {
-        return {
-          content: [
-            {
-              type: "text",
-              text: "Error migrating prompt: Provide either string or messages"
-            }
-          ],
-          isError: true
-        };
-      }
       const result = await service.prompts.migratePrompt({
         name: params.name,
         app: params.app,
@@ -7251,7 +7238,7 @@ var scimWorkspaceMappingBaseShape = {
   workspace_id: z22.string().describe("Portkey workspace ID that the SCIM group should access"),
   role: z22.enum(["admin", "member", "manager"]).describe("Workspace role automatically granted to group members")
 };
-var createScimWorkspaceMappingInputSchema = z22.object({
+var createScimWorkspaceMappingShape = {
   ...scimWorkspaceMappingBaseShape,
   scim_group_id: z22.string().min(1).optional().describe(
     "Existing identity-provider SCIM group ID; provide this or scim_group_name, but not both"
@@ -7259,7 +7246,8 @@ var createScimWorkspaceMappingInputSchema = z22.object({
   scim_group_name: z22.string().min(1).optional().describe(
     "Existing SCIM group display name; provide this or scim_group_id, but not both"
   )
-}).superRefine((input, context) => {
+};
+var createScimWorkspaceMappingSchema = z22.object(createScimWorkspaceMappingShape).superRefine((input, context) => {
   if (Boolean(input.scim_group_id) === Boolean(input.scim_group_name)) {
     context.addIssue({
       code: "custom",
@@ -7414,7 +7402,7 @@ function registerWorkspacesTools(server, service) {
     "create_scim_workspace_mapping",
     {
       description: "Map one identity-provider SCIM group to a Portkey workspace role so current and future group members receive access automatically. Provide exactly one of scim_group_id or scim_group_name; a name can pre-create the Portkey SCIM group before the IdP provisions it. Use list_scim_groups to discover existing groups and list_workspaces for the workspace ID. This changes access provisioning and is distinct from add_workspace_member, which grants one user directly.",
-      inputSchema: createScimWorkspaceMappingInputSchema,
+      inputSchema: createScimWorkspaceMappingShape,
       annotations: {
         title: "Create SCIM Workspace Mapping",
         readOnlyHint: false,
@@ -7423,7 +7411,8 @@ function registerWorkspacesTools(server, service) {
         openWorldHint: true
       }
     },
-    async (params) => {
+    async (rawParams) => {
+      const params = createScimWorkspaceMappingSchema.parse(rawParams);
       let request;
       if (params.scim_group_id !== void 0) {
         request = {
@@ -7784,7 +7773,25 @@ function augmentToolDescription(toolName, description) {
   }
   return `${description} ${ENTERPRISE_GATED_DESCRIPTION_NOTE}`;
 }
+function formatZodIssues(error) {
+  return error.issues.map((issue) => {
+    const path = issue.path.join(".");
+    if (!path) {
+      return issue.message;
+    }
+    const namesPath = new RegExp(`\\b${escapeRegExp(path)}\\b`).test(
+      issue.message
+    );
+    return namesPath ? issue.message : `${path}: ${issue.message}`;
+  }).join("; ");
+}
+function escapeRegExp(value) {
+  return value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
 function getToolErrorMessage(error) {
+  if (error instanceof z23.ZodError) {
+    return formatZodIssues(error);
+  }
   if (error instanceof Error && error.message) {
     return error.message;
   }
@@ -7931,14 +7938,14 @@ function wrapToolCallback(toolName, callback) {
       return normalizeToolResult(await callback(...args));
     } catch (error) {
       const message = getToolErrorMessage(error);
+      const isValidationError = error instanceof z23.ZodError;
+      const text = isValidationError ? `Invalid arguments for "${toolName}": ${message}` : `Tool "${toolName}" failed: ${message}`;
       Logger.error("Tool callback failed", {
         error: message,
         metadata: { toolName }
       });
       return normalizeToolResult({
-        content: [
-          { type: "text", text: `Tool "${toolName}" failed: ${message}` }
-        ],
+        content: [{ type: "text", text }],
         isError: true
       });
     }

package/package.json

@@ -53,7 +53,7 @@
 	},
 	"name": "portkey-admin-mcp",
 	"mcpName": "io.github.CodesWhat/portkey-admin-mcp",
-	"version": "0.8.0",
+	"version": "0.9.0",
 	"main": "build/index.js",
 	"keywords": [
 		"mcp",