@cloudinary/environment-config-mcp 0.6.0 → 0.6.2

package/src/mcp-server/tools/streamingProfilesGetStreamingProfiles.ts

@@ -1,5 +1,6 @@
 /*
  * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: c64630f2ba2d
  */
 
 import { streamingProfilesGetStreamingProfiles } from "../../funcs/streamingProfilesGetStreamingProfiles.js";

package/src/mcp-server/tools/streamingProfilesUpdateStreamingProfile.ts

@@ -1,5 +1,6 @@
 /*
  * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 4e34c78fa055
  */
 
 import * as z from "zod";
@@ -8,8 +9,10 @@ import { StreamingProfileUpdate$zodSchema } from "../../models/streamingprofileu
 import { formatResult, ToolDefinition } from "../tools.js";
 
 const args = {
-  name: z.string(),
-  streaming_profile_update: StreamingProfileUpdate$zodSchema,
+  name: z.string().describe("The name of the streaming profile."),
+  streaming_profile_update: StreamingProfileUpdate$zodSchema.describe(
+    `The updated streaming profile configuration.`,
+  ),
 };
 
 export const tool$streamingProfilesUpdateStreamingProfile: ToolDefinition<

package/src/mcp-server/tools/transformationsCreateTransformation.ts

@@ -1,5 +1,6 @@
 /*
  * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 8325647b37f6
  */
 
 import * as z from "zod";
@@ -9,9 +10,11 @@ import { formatResult, ToolDefinition } from "../tools.js";
 
 const args = {
   transformation: z.string().describe(
-    "The valid transformation name to create.\n",
+    "The valid transformation name to create.",
+  ),
+  create_request: CreateRequest$zodSchema.describe(
+    `The named transformation definition.`,
   ),
-  create_request: CreateRequest$zodSchema,
 };
 
 export const tool$transformationsCreateTransformation: ToolDefinition<
@@ -19,7 +22,7 @@ export const tool$transformationsCreateTransformation: ToolDefinition<
 > = {
   name: "create-transformation",
   description:
-    `Creates a new named transformation (assigning a custom name to a set of transformation
+    `Creates a new named transformation by assigning a custom name to a set of transformation parameters
 
 Creates a new named transformation with the given name and transformation string.
 `,

package/src/mcp-server/tools/transformationsDeleteTransformation.ts

@@ -1,5 +1,6 @@
 /*
  * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 3c089fceea5e
  */
 
 import * as z from "zod";

package/src/mcp-server/tools/transformationsGetTransformation.ts

@@ -1,5 +1,6 @@
 /*
  * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 32b56e97ded2
  */
 
 import * as z from "zod";

package/src/mcp-server/tools/transformationsListTransformations.ts

@@ -1,5 +1,6 @@
 /*
  * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 86830305f9cf
  */
 
 import * as z from "zod";
@@ -23,7 +24,7 @@ export const tool$transformationsListTransformations: ToolDefinition<
 > = {
   name: "list-transformations",
   description:
-    `Lists all transformation definitions in your account (including named transformations
+    `Lists all transformation definitions in your account, including named transformations
 
 Retrieves a list of all transformations, which can be filtered to show either only named or unnamed transformations.
 `,

package/src/mcp-server/tools/transformationsUpdateTransformation.ts

@@ -1,5 +1,6 @@
 /*
  * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 8051ff62d868
  */
 
 import * as z from "zod";
@@ -11,16 +12,18 @@ const args = {
   transformation: z.string().describe(
     "The transformation identifier. Can be either a named transformation (e.g., 'small_profile_thumbnail') or a transformation string (e.g., 'w_100,h_150,c_fill,g_auto').\n",
   ),
-  update_request: UpdateRequest$zodSchema,
+  update_request: UpdateRequest$zodSchema.describe(
+    `The updated transformation definition.`,
+  ),
 };
 
 export const tool$transformationsUpdateTransformation: ToolDefinition<
   typeof args
 > = {
   name: "update-transformation",
-  description: `Updates the definition of an existing named transformation
+  description: `Updates the definition of an existing transformation
 
-Update an existing named or unnamed transformation.
+Updates a named or unnamed transformation.
 `,
   scopes: ["admin"],
   annotations: {

package/src/mcp-server/tools/triggersCreateTrigger.ts

@@ -1,13 +1,16 @@
 /*
  * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 841868a185b7
  */
 
 import { triggersCreateTrigger } from "../../funcs/triggersCreateTrigger.js";
-import { CreateTriggerRequest$zodSchema } from "../../models/createtriggerop.js";
+import { CreateTriggerRequest$zodSchema } from "../../models/createtriggerrequest.js";
 import { formatResult, ToolDefinition } from "../tools.js";
 
 const args = {
-  request: CreateTriggerRequest$zodSchema,
+  request: CreateTriggerRequest$zodSchema.describe(
+    `The webhook notification trigger to create.`,
+  ),
 };
 
 export const tool$triggersCreateTrigger: ToolDefinition<typeof args> = {

package/src/mcp-server/tools/triggersDeleteTrigger.ts

@@ -1,5 +1,6 @@
 /*
  * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 36d23c68493b
  */
 
 import * as z from "zod";
@@ -7,7 +8,7 @@ import { triggersDeleteTrigger } from "../../funcs/triggersDeleteTrigger.js";
 import { formatResult, ToolDefinition } from "../tools.js";
 
 const args = {
-  id: z.string(),
+  id: z.string().describe("The ID of the trigger."),
 };
 
 export const tool$triggersDeleteTrigger: ToolDefinition<typeof args> = {

package/src/mcp-server/tools/triggersListTrigger.ts

@@ -1,21 +1,22 @@
 /*
  * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 5b10585d5fca
  */
 
-import * as z from "zod";
 import { triggersListTrigger } from "../../funcs/triggersListTrigger.js";
+import { EventType$zodSchema } from "../../models/eventtype.js";
 import { formatResult, ToolDefinition } from "../tools.js";
 
 const args = {
-  event_type: z.string().describe(
-    "The type of event that will trigger the notification response.",
-  ).optional(),
+  event_type: EventType$zodSchema.optional().describe(
+    `The type of event that will trigger the notification response.`,
+  ),
 };
 
 export const tool$triggersListTrigger: ToolDefinition<typeof args> = {
   name: "list-triggers",
   description:
-    `Lists all webhook notification triggers configured for your product environmentcloudinary
+    `Lists all webhook notification triggers configured for your product environment
 
 Retrieves a list of all event triggers and notifications within your product environment.
 `,

package/src/mcp-server/tools/triggersTestTrigger.ts

@@ -1,15 +1,18 @@
 /*
  * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: b6710d7af609
  */
 
 import * as z from "zod";
 import { triggersTestTrigger } from "../../funcs/triggersTestTrigger.js";
-import { TestTriggerRequestBody$zodSchema } from "../../models/testtriggerop.js";
+import { TestTriggerRequest$zodSchema } from "../../models/testtriggerrequest.js";
 import { formatResult, ToolDefinition } from "../tools.js";
 
 const args = {
-  id: z.string(),
-  RequestBody: TestTriggerRequestBody$zodSchema.optional(),
+  id: z.string().describe("The ID of the trigger to test."),
+  test_trigger_request: TestTriggerRequest$zodSchema.optional().describe(
+    `The test data for the trigger.`,
+  ),
 };
 
 export const tool$triggersTestTrigger: ToolDefinition<typeof args> = {
@@ -23,7 +26,7 @@ Use this endpoint to verify that a trigger's filter will match expected events.
   annotations: {
     "title": "Test Trigger Filter",
     "destructiveHint": false,
-    "idempotentHint": false,
+    "idempotentHint": true,
     "openWorldHint": false,
     "readOnlyHint": true,
   },
@@ -32,7 +35,7 @@ Use this endpoint to verify that a trigger's filter will match expected events.
     const [result] = await triggersTestTrigger(
       client,
       args.id,
-      args.RequestBody,
+      args.test_trigger_request,
       { fetchOptions: { signal: ctx.signal } },
     ).$inspect();
 

package/src/mcp-server/tools/triggersUpdateTrigger.ts

@@ -1,15 +1,18 @@
 /*
  * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 0bedcb0b91e0
  */
 
 import * as z from "zod";
 import { triggersUpdateTrigger } from "../../funcs/triggersUpdateTrigger.js";
-import { UpdateTriggerRequestBody$zodSchema } from "../../models/updatetriggerop.js";
+import { UpdateTriggerRequest$zodSchema } from "../../models/updatetriggerrequest.js";
 import { formatResult, ToolDefinition } from "../tools.js";
 
 const args = {
-  id: z.string(),
-  RequestBody: UpdateTriggerRequestBody$zodSchema,
+  id: z.string().describe("The ID of the trigger."),
+  update_trigger_request: UpdateTriggerRequest$zodSchema.describe(
+    `The updated trigger configuration.`,
+  ),
 };
 
 export const tool$triggersUpdateTrigger: ToolDefinition<typeof args> = {
@@ -31,7 +34,7 @@ Updates a notification URL for a trigger.`,
     const [result] = await triggersUpdateTrigger(
       client,
       args.id,
-      args.RequestBody,
+      args.update_trigger_request,
       { fetchOptions: { signal: ctx.signal } },
     ).$inspect();
 

package/src/mcp-server/tools/uploadMappingsCreateUploadMapping.ts

@@ -1,13 +1,16 @@
 /*
  * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 91d3a6b88c2e
  */
 
 import { uploadMappingsCreateUploadMapping } from "../../funcs/uploadMappingsCreateUploadMapping.js";
-import { CreateUploadMappingRequest$zodSchema } from "../../models/createuploadmappingop.js";
+import { UploadMappingInput$zodSchema } from "../../models/uploadmappinginput.js";
 import { formatResult, ToolDefinition } from "../tools.js";
 
 const args = {
-  request: CreateUploadMappingRequest$zodSchema,
+  request: UploadMappingInput$zodSchema.describe(
+    `The upload mapping folder and URL template.`,
+  ),
 };
 
 export const tool$uploadMappingsCreateUploadMapping: ToolDefinition<

package/src/mcp-server/tools/uploadMappingsDeleteUploadMapping.ts

@@ -1,5 +1,6 @@
 /*
  * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: e0910cc98ac5
  */
 
 import * as z from "zod";

package/src/mcp-server/tools/uploadMappingsListUploadMappings.ts

@@ -1,5 +1,6 @@
 /*
  * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 11db1edd5083
  */
 
 import * as z from "zod";

package/src/mcp-server/tools/uploadMappingsUpdateUploadMapping.ts

@@ -1,13 +1,16 @@
 /*
  * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 93f301e2ef80
  */
 
 import { uploadMappingsUpdateUploadMapping } from "../../funcs/uploadMappingsUpdateUploadMapping.js";
-import { UpdateUploadMappingRequest$zodSchema } from "../../models/updateuploadmappingop.js";
+import { UploadMappingInput$zodSchema } from "../../models/uploadmappinginput.js";
 import { formatResult, ToolDefinition } from "../tools.js";
 
 const args = {
-  request: UpdateUploadMappingRequest$zodSchema,
+  request: UploadMappingInput$zodSchema.describe(
+    `The updated upload mapping folder and URL template.`,
+  ),
 };
 
 export const tool$uploadMappingsUpdateUploadMapping: ToolDefinition<
@@ -15,7 +18,7 @@ export const tool$uploadMappingsUpdateUploadMapping: ToolDefinition<
 > = {
   name: "update-upload-mapping",
   description:
-    `Updates an existing upload mapping by changing its remote URL template for a given
+    `Updates an existing upload mapping by changing its remote URL template for a given folder
 
 Updates the URL template for an existing folder mapping`,
   scopes: ["builder"],

package/src/mcp-server/tools/uploadPresetsCreateUploadPreset.ts

@@ -1,13 +1,16 @@
 /*
  * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: cbfced083eca
  */
 
 import { uploadPresetsCreateUploadPreset } from "../../funcs/uploadPresetsCreateUploadPreset.js";
-import { UploadPreset$zodSchema } from "../../models/uploadpreset.js";
+import { UploadPresetInput$zodSchema } from "../../models/uploadpresetinput.js";
 import { formatResult, ToolDefinition } from "../tools.js";
 
 const args = {
-  request: UploadPreset$zodSchema,
+  request: UploadPresetInput$zodSchema.describe(
+    `The upload preset configuration.`,
+  ),
 };
 
 export const tool$uploadPresetsCreateUploadPreset: ToolDefinition<typeof args> =

package/src/mcp-server/tools/uploadPresetsDeleteUploadPreset.ts

@@ -1,5 +1,6 @@
 /*
  * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 1c8ec47f5378
  */
 
 import * as z from "zod";
@@ -7,7 +8,7 @@ import { uploadPresetsDeleteUploadPreset } from "../../funcs/uploadPresetsDelete
 import { formatResult, ToolDefinition } from "../tools.js";
 
 const args = {
-  name: z.string(),
+  name: z.string().describe("The name of the upload preset."),
 };
 
 export const tool$uploadPresetsDeleteUploadPreset: ToolDefinition<typeof args> =

package/src/mcp-server/tools/uploadPresetsGetUploadPreset.ts

@@ -1,5 +1,6 @@
 /*
  * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: f2f3e3d10f66
  */
 
 import * as z from "zod";
@@ -7,7 +8,7 @@ import { uploadPresetsGetUploadPreset } from "../../funcs/uploadPresetsGetUpload
 import { formatResult, ToolDefinition } from "../tools.js";
 
 const args = {
-  name: z.string(),
+  name: z.string().describe("The name of the upload preset."),
 };
 
 export const tool$uploadPresetsGetUploadPreset: ToolDefinition<typeof args> = {

package/src/mcp-server/tools/uploadPresetsListUploadPresets.ts

@@ -1,18 +1,24 @@
 /*
  * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 798d000ef5fd
  */
 
 import * as z from "zod";
 import { uploadPresetsListUploadPresets } from "../../funcs/uploadPresetsListUploadPresets.js";
-import {
-  Direction$zodSchema,
-  OrderBy$zodSchema,
-} from "../../models/listuploadpresetsop.js";
+import { DirectionEnum$zodSchema } from "../../models/directionenum.js";
+import { OrderBy$zodSchema } from "../../models/listuploadpresetsop.js";
 import { formatResult, ToolDefinition } from "../tools.js";
 
 const args = {
-  order_by: OrderBy$zodSchema.optional(),
-  direction: Direction$zodSchema.optional(),
+  order_by: OrderBy$zodSchema.optional().describe(
+    `The field to sort presets by.`,
+  ),
+  direction: DirectionEnum$zodSchema.optional().describe(
+    `The sort direction for the results. Default is "desc".`,
+  ),
+  max_results: z.int().default(10).describe(
+    "The maximum number of results to return. Default is 10.",
+  ),
   next_cursor: z.string().describe(
     "The cursor for pagination. Use the next_cursor value from a previous response to get the next page of results.",
   ).optional(),
@@ -36,6 +42,7 @@ export const tool$uploadPresetsListUploadPresets: ToolDefinition<typeof args> =
         client,
         args.order_by,
         args.direction,
+        args.max_results,
         args.next_cursor,
         { fetchOptions: { signal: ctx.signal } },
       ).$inspect();

package/src/mcp-server/tools/uploadPresetsUpdateUploadPreset.ts

@@ -1,15 +1,18 @@
 /*
  * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 400f04c7187f
  */
 
 import * as z from "zod";
 import { uploadPresetsUpdateUploadPreset } from "../../funcs/uploadPresetsUpdateUploadPreset.js";
-import { UploadPreset$zodSchema } from "../../models/uploadpreset.js";
+import { UploadPresetInput$zodSchema } from "../../models/uploadpresetinput.js";
 import { formatResult, ToolDefinition } from "../tools.js";
 
 const args = {
-  name: z.string(),
-  upload_preset: UploadPreset$zodSchema,
+  name: z.string().describe("The name of the upload preset."),
+  upload_preset_input: UploadPresetInput$zodSchema.describe(
+    `The updated upload preset configuration.`,
+  ),
 };
 
 export const tool$uploadPresetsUpdateUploadPreset: ToolDefinition<typeof args> =
@@ -29,7 +32,7 @@ export const tool$uploadPresetsUpdateUploadPreset: ToolDefinition<typeof args> =
       const [result] = await uploadPresetsUpdateUploadPreset(
         client,
         args.name,
-        args.upload_preset,
+        args.upload_preset_input,
         { fetchOptions: { signal: ctx.signal } },
       ).$inspect();
 

package/src/mcp-server/tools.ts

@@ -1,5 +1,6 @@
 /*
  * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 654d5d1f2062
  */
 
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
@@ -21,6 +22,50 @@ import { MCPServerFlags } from "./flags.js";
 import { MCPScope, mcpScopes } from "./scopes.js";
 import { valueToBase64 } from "./shared.js";
 
+export type MCPToolAnnotationFilter = {
+  readOnlyHint?: boolean;
+  destructiveHint?: boolean;
+  idempotentHint?: boolean;
+  openWorldHint?: boolean;
+};
+
+const VALID_ANNOTATIONS = [
+  "readOnly",
+  "destructive",
+  "idempotent",
+  "openWorld",
+] as const;
+type AnnotationName = typeof VALID_ANNOTATIONS[number];
+
+const annotationToKey: Record<AnnotationName, keyof MCPToolAnnotationFilter> = {
+  readOnly: "readOnlyHint",
+  destructive: "destructiveHint",
+  idempotent: "idempotentHint",
+  openWorld: "openWorldHint",
+};
+
+export function buildAnnotationFilter(
+  annotations: string[] | undefined,
+): MCPToolAnnotationFilter {
+  const filter: MCPToolAnnotationFilter = {};
+  if (!annotations || annotations.length === 0) {
+    return filter;
+  }
+  for (const a of annotations) {
+    if (!VALID_ANNOTATIONS.includes(a as AnnotationName)) {
+      throw new Error(
+        `Invalid annotation filter: "${a}". Valid values are: ${
+          VALID_ANNOTATIONS.join(", ")
+        }`,
+      );
+    }
+  }
+  for (const name of VALID_ANNOTATIONS) {
+    filter[annotationToKey[name]] = annotations.includes(name);
+  }
+  return filter;
+}
+
 export type ToolDefinition<
   Args extends undefined | ZodRawShapeCompat = undefined,
 > = Args extends ZodRawShapeCompat ? {
@@ -91,6 +136,7 @@ export function createRegisterTool(
   allowedScopes: Set<MCPScope>,
   allowedTools?: Set<string>,
   dynamic?: boolean,
+  annotationFilter?: MCPToolAnnotationFilter,
 ): [
   <A extends ZodRawShapeCompat | undefined>(tool: ToolDefinition<A>) => void,
   Array<{ name: string; description: string }>,
@@ -120,6 +166,34 @@ export function createRegisterTool(
       return;
     }
 
+    if (annotationFilter) {
+      const a = tool.annotations;
+      if (
+        annotationFilter.readOnlyHint !== undefined
+        && a.readOnlyHint !== annotationFilter.readOnlyHint
+      ) {
+        return;
+      }
+      if (
+        annotationFilter.destructiveHint !== undefined
+        && a.destructiveHint !== annotationFilter.destructiveHint
+      ) {
+        return;
+      }
+      if (
+        annotationFilter.idempotentHint !== undefined
+        && a.idempotentHint !== annotationFilter.idempotentHint
+      ) {
+        return;
+      }
+      if (
+        annotationFilter.openWorldHint !== undefined
+        && a.openWorldHint !== annotationFilter.openWorldHint
+      ) {
+        return;
+      }
+    }
+
     toolMap.set(
       tool.name,
       tool as ToolDefinition<ZodRawShapeCompat | undefined>,
@@ -271,6 +345,8 @@ export function registerDynamicTools(
       if (def.args) {
         const jsonSchema = z.toJSONSchema(z.object(def.args), {
           target: "draft-2020-12",
+          io: "input",
+          unrepresentable: "any",
         });
         schemaText += JSON.stringify(jsonSchema, null, 2);
       } else {
@@ -286,16 +362,16 @@ export function registerDynamicTools(
 
     return { content: [{ type: "text", text: parts.join("\n\n") }] };
   });
-  logger.debug("Registered dynamic meta-tool", { name: "describe_tool" });
+  logger.debug("Registered dynamic meta-tool", { name: "describe_tool_input" });
 
   // 3. execute_tool
   server.registerTool("execute_tool", {
     description:
-      "Execute a tool by name with the provided input parameters. If executing a given tool for the first time, it is recommended to call describe_tool_input first to understand the expected input schema.",
+      "Execute a tool by name with its arguments. If executing a given tool for the first time, it is recommended to call describe_tool_input first to understand the expected `arguments` shape.",
     inputSchema: {
-      tool_name: z.string().describe("The name of the tool to execute"),
-      input: z.record(z.string(), z.unknown()).optional().describe(
-        "Input parameters for the tool as a JSON object",
+      name: z.string().describe("The name of the tool to execute"),
+      arguments: z.looseObject({}).optional().describe(
+        "Arguments for the target tool as a JSON object, matching the schema returned by describe_tool_input.",
       ),
     },
     annotations: {
@@ -306,17 +382,17 @@ export function registerDynamicTools(
       openWorldHint: true,
     },
   }, async (args, ctx) => {
-    const def = toolMap.get(args.tool_name);
+    const def = toolMap.get(args.name);
     if (!def) {
       return {
-        content: [{ type: "text", text: `Unknown tool: ${args.tool_name}` }],
+        content: [{ type: "text", text: `Unknown tool: ${args.name}` }],
         isError: true,
       };
     }
 
     let validatedInput: Record<string, unknown> = {};
     if (def.args) {
-      const vres = z.object(def.args).safeParse(args.input ?? {});
+      const vres = z.object(def.args).safeParse(args.arguments ?? {});
       if (vres.success) {
         validatedInput = vres.data;
       } else {
@@ -326,7 +402,7 @@ export function registerDynamicTools(
           content: [{
             type: "text",
             text:
-              `Invalid input for tool ${args.tool_name}:\n<issues>\n${issues}\n</issues>`,
+              `Invalid input for tool ${args.name}:\n<issues>\n${issues}\n</issues>`,
           }],
           isError: true,
         };
@@ -344,7 +420,7 @@ export function registerDynamicTools(
       return {
         content: [{
           type: "text",
-          text: `Error executing tool ${args.tool_name}: ${message}`,
+          text: `Error executing tool ${args.name}: ${message}`,
         }],
         isError: true,
       };