@cloudinary/environment-config-mcp 0.5.0 → 0.6.1

package/src/mcp-server/server.ts

@@ -1,5 +1,6 @@
 /*
  * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 2784dd48e82a
  */
 
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
@@ -12,7 +13,11 @@ import {
   createRegisterResourceTemplate,
 } from "./resources.js";
 import { MCPScope } from "./scopes.js";
-import { createRegisterTool } from "./tools.js";
+import {
+  createRegisterTool,
+  MCPToolAnnotationFilter,
+  registerDynamicTools,
+} from "./tools.js";
 import { tool$streamingProfilesCreateStreamingProfile } from "./tools/streamingProfilesCreateStreamingProfile.js";
 import { tool$streamingProfilesDeleteStreamingProfile } from "./tools/streamingProfilesDeleteStreamingProfile.js";
 import { tool$streamingProfilesGetStreamingProfile } from "./tools/streamingProfilesGetStreamingProfile.js";
@@ -26,6 +31,7 @@ import { tool$transformationsUpdateTransformation } from "./tools/transformation
 import { tool$triggersCreateTrigger } from "./tools/triggersCreateTrigger.js";
 import { tool$triggersDeleteTrigger } from "./tools/triggersDeleteTrigger.js";
 import { tool$triggersListTrigger } from "./tools/triggersListTrigger.js";
+import { tool$triggersTestTrigger } from "./tools/triggersTestTrigger.js";
 import { tool$triggersUpdateTrigger } from "./tools/triggersUpdateTrigger.js";
 import { tool$uploadMappingsCreateUploadMapping } from "./tools/uploadMappingsCreateUploadMapping.js";
 import { tool$uploadMappingsDeleteUploadMapping } from "./tools/uploadMappingsDeleteUploadMapping.js";
@@ -40,7 +46,9 @@ import { tool$uploadPresetsUpdateUploadPreset } from "./tools/uploadPresetsUpdat
 export function createMCPServer(deps: {
   logger: ConsoleLogger;
   allowedTools?: string[] | undefined;
+  dynamic?: boolean | undefined;
   scopes?: MCPScope[] | undefined;
+  annotationFilter?: MCPToolAnnotationFilter | undefined;
   getSDK?: () => CloudinaryEnvConfigCore;
   serverURL?: string | undefined;
   security?: SDKOptions["security"] | undefined;
@@ -51,7 +59,7 @@ export function createMCPServer(deps: {
 }) {
   const server = new McpServer({
     name: "CloudinaryEnvConfig",
-    version: "0.5.0",
+    version: "0.6.1",
   });
 
   const getClient = deps.getSDK || (() =>
@@ -74,12 +82,14 @@ export function createMCPServer(deps: {
   const scopes = new Set(deps.scopes);
 
   const allowedTools = deps.allowedTools && new Set(deps.allowedTools);
-  const tool = createRegisterTool(
+  const [tool, tools, toolMap] = createRegisterTool(
     deps.logger,
     server,
     getClient,
     scopes,
     allowedTools,
+    deps.dynamic,
+    deps.annotationFilter,
   );
   const resource = createRegisterResource(
     deps.logger,
@@ -115,11 +125,16 @@ export function createMCPServer(deps: {
   tool(tool$triggersCreateTrigger);
   tool(tool$triggersUpdateTrigger);
   tool(tool$triggersDeleteTrigger);
+  tool(tool$triggersTestTrigger);
   tool(tool$streamingProfilesCreateStreamingProfile);
   tool(tool$streamingProfilesGetStreamingProfiles);
   tool(tool$streamingProfilesGetStreamingProfile);
   tool(tool$streamingProfilesUpdateStreamingProfile);
   tool(tool$streamingProfilesDeleteStreamingProfile);
 
-  return server;
+  if (deps.dynamic) {
+    registerDynamicTools(deps.logger, server, getClient, toolMap, scopes);
+  }
+
+  return { server, tools };
 }

package/src/mcp-server/shared.ts

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

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

@@ -1,5 +1,6 @@
 /*
  * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: bdb92e282dcf
  */
 
 import { streamingProfilesCreateStreamingProfile } from "../../funcs/streamingProfilesCreateStreamingProfile.js";
@@ -7,7 +8,9 @@ import { StreamingProfileCreate$zodSchema } from "../../models/streamingprofilec
 import { formatResult, ToolDefinition } from "../tools.js";
 
 const args = {
-  request: StreamingProfileCreate$zodSchema,
+  request: StreamingProfileCreate$zodSchema.describe(
+    `The streaming profile configuration.`,
+  ),
 };
 
 export const tool$streamingProfilesCreateStreamingProfile: ToolDefinition<
@@ -26,7 +29,7 @@ export const tool$streamingProfilesCreateStreamingProfile: ToolDefinition<
   },
   args,
   tool: async (client, args, ctx) => {
-    const [result, apiCall] = await streamingProfilesCreateStreamingProfile(
+    const [result] = await streamingProfilesCreateStreamingProfile(
       client,
       args.request,
       { fetchOptions: { signal: ctx.signal } },
@@ -39,8 +42,6 @@ export const tool$streamingProfilesCreateStreamingProfile: ToolDefinition<
       };
     }
 
-    const value = result.value;
-
-    return formatResult(value, apiCall);
+    return formatResult(result.value);
   },
 };

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

@@ -1,5 +1,6 @@
 /*
  * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: b4e9f3eb3ca7
  */
 
 import * as z from "zod";
@@ -7,7 +8,7 @@ import { streamingProfilesDeleteStreamingProfile } from "../../funcs/streamingPr
 import { formatResult, ToolDefinition } from "../tools.js";
 
 const args = {
-  name: z.string(),
+  name: z.string().describe("The name of the streaming profile."),
 };
 
 export const tool$streamingProfilesDeleteStreamingProfile: ToolDefinition<
@@ -26,7 +27,7 @@ export const tool$streamingProfilesDeleteStreamingProfile: ToolDefinition<
   },
   args,
   tool: async (client, args, ctx) => {
-    const [result, apiCall] = await streamingProfilesDeleteStreamingProfile(
+    const [result] = await streamingProfilesDeleteStreamingProfile(
       client,
       args.name,
       { fetchOptions: { signal: ctx.signal } },
@@ -39,8 +40,6 @@ export const tool$streamingProfilesDeleteStreamingProfile: ToolDefinition<
       };
     }
 
-    const value = result.value;
-
-    return formatResult(value, apiCall);
+    return formatResult(result.value);
   },
 };

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

@@ -1,5 +1,6 @@
 /*
  * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 418409851acf
  */
 
 import * as z from "zod";
@@ -7,7 +8,7 @@ import { streamingProfilesGetStreamingProfile } from "../../funcs/streamingProfi
 import { formatResult, ToolDefinition } from "../tools.js";
 
 const args = {
-  name: z.string(),
+  name: z.string().describe("The name of the streaming profile."),
 };
 
 export const tool$streamingProfilesGetStreamingProfile: ToolDefinition<
@@ -26,7 +27,7 @@ export const tool$streamingProfilesGetStreamingProfile: ToolDefinition<
   },
   args,
   tool: async (client, args, ctx) => {
-    const [result, apiCall] = await streamingProfilesGetStreamingProfile(
+    const [result] = await streamingProfilesGetStreamingProfile(
       client,
       args.name,
       { fetchOptions: { signal: ctx.signal } },
@@ -39,8 +40,6 @@ export const tool$streamingProfilesGetStreamingProfile: ToolDefinition<
       };
     }
 
-    const value = result.value;
-
-    return formatResult(value, apiCall);
+    return formatResult(result.value);
   },
 };

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";
@@ -26,7 +27,7 @@ export const tool$streamingProfilesGetStreamingProfiles: ToolDefinition<
   },
   args,
   tool: async (client, args, ctx) => {
-    const [result, apiCall] = await streamingProfilesGetStreamingProfiles(
+    const [result] = await streamingProfilesGetStreamingProfiles(
       client,
       args.request,
       { fetchOptions: { signal: ctx.signal } },
@@ -39,8 +40,6 @@ export const tool$streamingProfilesGetStreamingProfiles: ToolDefinition<
       };
     }
 
-    const value = result.value;
-
-    return formatResult(value, apiCall);
+    return formatResult(result.value);
   },
 };

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<
@@ -28,7 +31,7 @@ export const tool$streamingProfilesUpdateStreamingProfile: ToolDefinition<
   },
   args,
   tool: async (client, args, ctx) => {
-    const [result, apiCall] = await streamingProfilesUpdateStreamingProfile(
+    const [result] = await streamingProfilesUpdateStreamingProfile(
       client,
       args.name,
       args.streaming_profile_update,
@@ -42,8 +45,6 @@ export const tool$streamingProfilesUpdateStreamingProfile: ToolDefinition<
       };
     }
 
-    const value = result.value;
-
-    return formatResult(value, apiCall);
+    return formatResult(result.value);
   },
 };

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,10 +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<
@@ -20,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.
 `,
@@ -34,7 +36,7 @@ Creates a new named transformation with the given name and transformation string
   },
   args,
   tool: async (client, args, ctx) => {
-    const [result, apiCall] = await transformationsCreateTransformation(
+    const [result] = await transformationsCreateTransformation(
       client,
       args.transformation,
       args.create_request,
@@ -48,8 +50,6 @@ Creates a new named transformation with the given name and transformation string
       };
     }
 
-    const value = result.value;
-
-    return formatResult(value, apiCall);
+    return formatResult(result.value);
   },
 };

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";
@@ -8,8 +9,7 @@ import { formatResult, ToolDefinition } from "../tools.js";
 
 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"
-      + "",
+    "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",
   ),
   invalidate: z.boolean().describe(
     "Invalidate derived resources generated using the deleted transformation from CDN.",
@@ -34,7 +34,7 @@ Delete a named or unnamed transformation. Optionally invalidate derived resource
   },
   args,
   tool: async (client, args, ctx) => {
-    const [result, apiCall] = await transformationsDeleteTransformation(
+    const [result] = await transformationsDeleteTransformation(
       client,
       args.transformation,
       args.invalidate,
@@ -48,8 +48,6 @@ Delete a named or unnamed transformation. Optionally invalidate derived resource
       };
     }
 
-    const value = result.value;
-
-    return formatResult(value, apiCall);
+    return formatResult(result.value);
   },
 };

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";
@@ -8,8 +9,7 @@ import { formatResult, ToolDefinition } from "../tools.js";
 
 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"
-      + "",
+    "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",
   ),
 };
 
@@ -31,7 +31,7 @@ Retrieves details for a named or unnamed transformation.
   },
   args,
   tool: async (client, args, ctx) => {
-    const [result, apiCall] = await transformationsGetTransformation(
+    const [result] = await transformationsGetTransformation(
       client,
       args.transformation,
       { fetchOptions: { signal: ctx.signal } },
@@ -44,8 +44,6 @@ Retrieves details for a named or unnamed transformation.
       };
     }
 
-    const value = result.value;
-
-    return formatResult(value, apiCall);
+    return formatResult(result.value);
   },
 };

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";
@@ -10,7 +11,7 @@ const args = {
   named: z.boolean().describe(
     "Whether to return only named (`true`) or unnamed (`false`) transformations. If this parameter isn't included, both named and unnamed transformations will be returned.",
   ).optional(),
-  max_results: z.number().int().default(10).describe(
+  max_results: z.int().default(10).describe(
     "The maximum number of results to return. Default is 10.",
   ),
   next_cursor: z.string().describe(
@@ -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.
 `,
@@ -37,7 +38,7 @@ Retrieves a list of all transformations, which can be filtered to show either on
   },
   args,
   tool: async (client, args, ctx) => {
-    const [result, apiCall] = await transformationsListTransformations(
+    const [result] = await transformationsListTransformations(
       client,
       args.named,
       args.max_results,
@@ -52,8 +53,6 @@ Retrieves a list of all transformations, which can be filtered to show either on
       };
     }
 
-    const value = result.value;
-
-    return formatResult(value, apiCall);
+    return formatResult(result.value);
   },
 };

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";
@@ -9,19 +10,20 @@ import { formatResult, ToolDefinition } from "../tools.js";
 
 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"
-      + "",
+    "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.describe(
+    `The updated transformation definition.`,
   ),
-  update_request: UpdateRequest$zodSchema,
 };
 
 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: {
@@ -33,7 +35,7 @@ Update an existing named or unnamed transformation.
   },
   args,
   tool: async (client, args, ctx) => {
-    const [result, apiCall] = await transformationsUpdateTransformation(
+    const [result] = await transformationsUpdateTransformation(
       client,
       args.transformation,
       args.update_request,
@@ -47,8 +49,6 @@ Update an existing named or unnamed transformation.
       };
     }
 
-    const value = result.value;
-
-    return formatResult(value, apiCall);
+    return formatResult(result.value);
   },
 };

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> = {
@@ -28,7 +31,7 @@ Your product environment supports triggers up to a maximum determined by multipl
   },
   args,
   tool: async (client, args, ctx) => {
-    const [result, apiCall] = await triggersCreateTrigger(
+    const [result] = await triggersCreateTrigger(
       client,
       args.request,
       { fetchOptions: { signal: ctx.signal } },
@@ -41,8 +44,6 @@ Your product environment supports triggers up to a maximum determined by multipl
       };
     }
 
-    const value = result.value;
-
-    return formatResult(value, apiCall);
+    return formatResult(result.value);
   },
 };

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> = {
@@ -25,7 +26,7 @@ Deletes a trigger.`,
   },
   args,
   tool: async (client, args, ctx) => {
-    const [result, apiCall] = await triggersDeleteTrigger(
+    const [result] = await triggersDeleteTrigger(
       client,
       args.id,
       { fetchOptions: { signal: ctx.signal } },
@@ -38,8 +39,6 @@ Deletes a trigger.`,
       };
     }
 
-    const value = result.value;
-
-    return formatResult(value, apiCall);
+    return formatResult(result.value);
   },
 };

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.
 `,
@@ -29,7 +30,7 @@ Retrieves a list of all event triggers and notifications within your product env
   },
   args,
   tool: async (client, args, ctx) => {
-    const [result, apiCall] = await triggersListTrigger(
+    const [result] = await triggersListTrigger(
       client,
       args.event_type,
       { fetchOptions: { signal: ctx.signal } },
@@ -42,8 +43,6 @@ Retrieves a list of all event triggers and notifications within your product env
       };
     }
 
-    const value = result.value;
-
-    return formatResult(value, apiCall);
+    return formatResult(result.value);
   },
 };

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

@@ -0,0 +1,51 @@
+/*
+ * 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 { TestTriggerRequest$zodSchema } from "../../models/testtriggerrequest.js";
+import { formatResult, ToolDefinition } from "../tools.js";
+
+const args = {
+  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> = {
+  name: "test-trigger",
+  description: `Tests an existing trigger's filter against sample data
+
+Evaluates an existing trigger's filter against provided sample data.
+Use this endpoint to verify that a trigger's filter will match expected events.
+`,
+  scopes: ["admin"],
+  annotations: {
+    "title": "Test Trigger Filter",
+    "destructiveHint": false,
+    "idempotentHint": true,
+    "openWorldHint": false,
+    "readOnlyHint": true,
+  },
+  args,
+  tool: async (client, args, ctx) => {
+    const [result] = await triggersTestTrigger(
+      client,
+      args.id,
+      args.test_trigger_request,
+      { fetchOptions: { signal: ctx.signal } },
+    ).$inspect();
+
+    if (!result.ok) {
+      return {
+        content: [{ type: "text", text: result.error.message }],
+        isError: true,
+      };
+    }
+
+    return formatResult(result.value);
+  },
+};