@cloudinary/environment-config-mcp 0.5.0

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

@@ -0,0 +1,60 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod";
+import { uploadMappingsListUploadMappings } from "../../funcs/uploadMappingsListUploadMappings.js";
+import { formatResult, ToolDefinition } from "../tools.js";
+
+const args = {
+  folder: z.string().describe(
+    "Get details of a specific mapping by folder name",
+  ).optional(),
+  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(),
+  max_results: z.number().int().default(10).describe(
+    "The maximum number of results to return. Default is 10.",
+  ),
+};
+
+export const tool$uploadMappingsListUploadMappings: ToolDefinition<
+  typeof args
+> = {
+  name: "list-upload-mappings",
+  description:
+    `Retrieves a list of all upload mapping rules configured in your Cloudinary product environment
+
+Returns a list of all upload mappings defined for your account.
+Upload mappings allow you to map an upload preset to a specific folder and URL template.
+`,
+  scopes: ["builder"],
+  annotations: {
+    "title": "List Upload Mappings",
+    "destructiveHint": false,
+    "idempotentHint": true,
+    "openWorldHint": false,
+    "readOnlyHint": true,
+  },
+  args,
+  tool: async (client, args, ctx) => {
+    const [result, apiCall] = await uploadMappingsListUploadMappings(
+      client,
+      args.folder,
+      args.next_cursor,
+      args.max_results,
+      { fetchOptions: { signal: ctx.signal } },
+    ).$inspect();
+
+    if (!result.ok) {
+      return {
+        content: [{ type: "text", text: result.error.message }],
+        isError: true,
+      };
+    }
+
+    const value = result.value;
+
+    return formatResult(value, apiCall);
+  },
+};

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

@@ -0,0 +1,48 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { uploadMappingsUpdateUploadMapping } from "../../funcs/uploadMappingsUpdateUploadMapping.js";
+import { UpdateUploadMappingRequest$zodSchema } from "../../models/updateuploadmappingop.js";
+import { formatResult, ToolDefinition } from "../tools.js";
+
+const args = {
+  request: UpdateUploadMappingRequest$zodSchema,
+};
+
+export const tool$uploadMappingsUpdateUploadMapping: ToolDefinition<
+  typeof args
+> = {
+  name: "update-upload-mapping",
+  description:
+    `Updates an existing upload mapping by changing its remote URL template for a given
+
+Updates the URL template for an existing folder mapping`,
+  scopes: ["builder"],
+  annotations: {
+    "title": "Update Upload Mapping",
+    "destructiveHint": false,
+    "idempotentHint": true,
+    "openWorldHint": false,
+    "readOnlyHint": false,
+  },
+  args,
+  tool: async (client, args, ctx) => {
+    const [result, apiCall] = await uploadMappingsUpdateUploadMapping(
+      client,
+      args.request,
+      { fetchOptions: { signal: ctx.signal } },
+    ).$inspect();
+
+    if (!result.ok) {
+      return {
+        content: [{ type: "text", text: result.error.message }],
+        isError: true,
+      };
+    }
+
+    const value = result.value;
+
+    return formatResult(value, apiCall);
+  },
+};

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

@@ -0,0 +1,45 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { uploadPresetsCreateUploadPreset } from "../../funcs/uploadPresetsCreateUploadPreset.js";
+import { UploadPreset$zodSchema } from "../../models/uploadpreset.js";
+import { formatResult, ToolDefinition } from "../tools.js";
+
+const args = {
+  request: UploadPreset$zodSchema,
+};
+
+export const tool$uploadPresetsCreateUploadPreset: ToolDefinition<typeof args> =
+  {
+    name: "create-upload-preset",
+    description:
+      `Creates a new upload preset with specified configuration settings`,
+    scopes: ["builder"],
+    annotations: {
+      "title": "Create Upload Preset",
+      "destructiveHint": false,
+      "idempotentHint": false,
+      "openWorldHint": false,
+      "readOnlyHint": false,
+    },
+    args,
+    tool: async (client, args, ctx) => {
+      const [result, apiCall] = await uploadPresetsCreateUploadPreset(
+        client,
+        args.request,
+        { fetchOptions: { signal: ctx.signal } },
+      ).$inspect();
+
+      if (!result.ok) {
+        return {
+          content: [{ type: "text", text: result.error.message }],
+          isError: true,
+        };
+      }
+
+      const value = result.value;
+
+      return formatResult(value, apiCall);
+    },
+  };

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

@@ -0,0 +1,44 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod";
+import { uploadPresetsDeleteUploadPreset } from "../../funcs/uploadPresetsDeleteUploadPreset.js";
+import { formatResult, ToolDefinition } from "../tools.js";
+
+const args = {
+  name: z.string(),
+};
+
+export const tool$uploadPresetsDeleteUploadPreset: ToolDefinition<typeof args> =
+  {
+    name: "delete-upload-preset",
+    description: `Deletes an upload preset from the account`,
+    scopes: ["builder"],
+    annotations: {
+      "title": "Delete Upload Preset",
+      "destructiveHint": true,
+      "idempotentHint": true,
+      "openWorldHint": false,
+      "readOnlyHint": false,
+    },
+    args,
+    tool: async (client, args, ctx) => {
+      const [result, apiCall] = await uploadPresetsDeleteUploadPreset(
+        client,
+        args.name,
+        { fetchOptions: { signal: ctx.signal } },
+      ).$inspect();
+
+      if (!result.ok) {
+        return {
+          content: [{ type: "text", text: result.error.message }],
+          isError: true,
+        };
+      }
+
+      const value = result.value;
+
+      return formatResult(value, apiCall);
+    },
+  };

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

@@ -0,0 +1,43 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod";
+import { uploadPresetsGetUploadPreset } from "../../funcs/uploadPresetsGetUploadPreset.js";
+import { formatResult, ToolDefinition } from "../tools.js";
+
+const args = {
+  name: z.string(),
+};
+
+export const tool$uploadPresetsGetUploadPreset: ToolDefinition<typeof args> = {
+  name: "get-upload-preset-details",
+  description: `Retrieves details of a single upload preset`,
+  scopes: ["builder"],
+  annotations: {
+    "title": "Get Upload Preset Details",
+    "destructiveHint": false,
+    "idempotentHint": true,
+    "openWorldHint": false,
+    "readOnlyHint": true,
+  },
+  args,
+  tool: async (client, args, ctx) => {
+    const [result, apiCall] = await uploadPresetsGetUploadPreset(
+      client,
+      args.name,
+      { fetchOptions: { signal: ctx.signal } },
+    ).$inspect();
+
+    if (!result.ok) {
+      return {
+        content: [{ type: "text", text: result.error.message }],
+        isError: true,
+      };
+    }
+
+    const value = result.value;
+
+    return formatResult(value, apiCall);
+  },
+};

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

@@ -0,0 +1,54 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod";
+import { uploadPresetsListUploadPresets } from "../../funcs/uploadPresetsListUploadPresets.js";
+import {
+  Direction$zodSchema,
+  OrderBy$zodSchema,
+} from "../../models/listuploadpresetsop.js";
+import { formatResult, ToolDefinition } from "../tools.js";
+
+const args = {
+  order_by: OrderBy$zodSchema.optional(),
+  direction: Direction$zodSchema.optional(),
+  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(),
+};
+
+export const tool$uploadPresetsListUploadPresets: ToolDefinition<typeof args> =
+  {
+    name: "list-upload-presets",
+    description: `Lists all upload presets configured in the account`,
+    scopes: ["builder"],
+    annotations: {
+      "title": "List Upload Presets",
+      "destructiveHint": false,
+      "idempotentHint": true,
+      "openWorldHint": false,
+      "readOnlyHint": true,
+    },
+    args,
+    tool: async (client, args, ctx) => {
+      const [result, apiCall] = await uploadPresetsListUploadPresets(
+        client,
+        args.order_by,
+        args.direction,
+        args.next_cursor,
+        { fetchOptions: { signal: ctx.signal } },
+      ).$inspect();
+
+      if (!result.ok) {
+        return {
+          content: [{ type: "text", text: result.error.message }],
+          isError: true,
+        };
+      }
+
+      const value = result.value;
+
+      return formatResult(value, apiCall);
+    },
+  };

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

@@ -0,0 +1,47 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod";
+import { uploadPresetsUpdateUploadPreset } from "../../funcs/uploadPresetsUpdateUploadPreset.js";
+import { UploadPreset$zodSchema } from "../../models/uploadpreset.js";
+import { formatResult, ToolDefinition } from "../tools.js";
+
+const args = {
+  name: z.string(),
+  upload_preset: UploadPreset$zodSchema,
+};
+
+export const tool$uploadPresetsUpdateUploadPreset: ToolDefinition<typeof args> =
+  {
+    name: "update-upload-preset",
+    description: `Updates an existing upload preset's configuration settings`,
+    scopes: ["builder"],
+    annotations: {
+      "title": "Update Upload Preset",
+      "destructiveHint": false,
+      "idempotentHint": true,
+      "openWorldHint": false,
+      "readOnlyHint": false,
+    },
+    args,
+    tool: async (client, args, ctx) => {
+      const [result, apiCall] = await uploadPresetsUpdateUploadPreset(
+        client,
+        args.name,
+        args.upload_preset,
+        { fetchOptions: { signal: ctx.signal } },
+      ).$inspect();
+
+      if (!result.ok) {
+        return {
+          content: [{ type: "text", text: result.error.message }],
+          isError: true,
+        };
+      }
+
+      const value = result.value;
+
+      return formatResult(value, apiCall);
+    },
+  };

package/src/mcp-server/tools.ts

@@ -0,0 +1,158 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { RequestHandlerExtra } from "@modelcontextprotocol/sdk/shared/protocol.js";
+import {
+  CallToolResult,
+  ServerNotification,
+  ServerRequest,
+} from "@modelcontextprotocol/sdk/types.js";
+import { objectOutputType, ZodRawShape, ZodTypeAny } from "zod";
+import { CloudinaryEnvConfigCore } from "../core.js";
+import { ConsoleLogger } from "./console-logger.js";
+import { MCPScope } from "./scopes.js";
+import { isAsyncIterable, isBinaryData, valueToBase64 } from "./shared.js";
+
+export type ToolDefinition<Args extends undefined | ZodRawShape = undefined> =
+  Args extends ZodRawShape ? {
+      name: string;
+      description: string;
+      scopes?: MCPScope[];
+      args: Args;
+      annotations: {
+        title: string;
+        destructiveHint: boolean;
+        idempotentHint: boolean;
+        openWorldHint: boolean;
+        readOnlyHint: boolean;
+      };
+      tool: (
+        client: CloudinaryEnvConfigCore,
+        args: objectOutputType<Args, ZodTypeAny>,
+        extra: RequestHandlerExtra<ServerRequest, ServerNotification>,
+      ) => CallToolResult | Promise<CallToolResult>;
+    }
+    : {
+      name: string;
+      description: string;
+      scopes?: MCPScope[];
+      args?: undefined;
+      annotations: {
+        title: string;
+        destructiveHint: boolean;
+        idempotentHint: boolean;
+        openWorldHint: boolean;
+        readOnlyHint: boolean;
+      };
+      tool: (
+        client: CloudinaryEnvConfigCore,
+        extra: RequestHandlerExtra<ServerRequest, ServerNotification>,
+      ) => CallToolResult | Promise<CallToolResult>;
+    };
+
+// Optional function to assist with formatting tool results
+export async function formatResult(
+  value: unknown,
+  init: { response?: Response | undefined },
+): Promise<CallToolResult> {
+  if (typeof value === "undefined") {
+    return { content: [] };
+  }
+
+  const { response } = init;
+  const contentType = response?.headers.get("content-type") ?? "";
+  let content: CallToolResult["content"] = [];
+
+  if (contentType.search(/\bjson\b/g)) {
+    content = [{ type: "text", text: JSON.stringify(value) }];
+  } else if (
+    contentType.startsWith("text/event-stream")
+    && isAsyncIterable(value)
+  ) {
+    content = await consumeSSE(value);
+  } else if (contentType.startsWith("text/") && typeof value === "string") {
+    content = [{ type: "text", text: value }];
+  } else if (isBinaryData(value) && contentType.startsWith("image/")) {
+    const data = await valueToBase64(value);
+    content = data == null
+      ? []
+      : [{ type: "image", data, mimeType: contentType }];
+  } else {
+    return {
+      content: [{
+        type: "text",
+        text: `Unsupported content type: "${contentType}"`,
+      }],
+      isError: true,
+    };
+  }
+
+  return { content };
+}
+
+async function consumeSSE(
+  value: AsyncIterable<unknown>,
+): Promise<CallToolResult["content"]> {
+  const content: CallToolResult["content"] = [];
+
+  for await (const chunk of value) {
+    if (typeof chunk === "string") {
+      content.push({ type: "text", text: chunk });
+    } else {
+      content.push({ type: "text", text: JSON.stringify(chunk) });
+    }
+  }
+
+  return content;
+}
+
+export function createRegisterTool(
+  logger: ConsoleLogger,
+  server: McpServer,
+  getSDK: () => CloudinaryEnvConfigCore,
+  allowedScopes: Set<MCPScope>,
+  allowedTools?: Set<string>,
+): <A extends ZodRawShape | undefined>(tool: ToolDefinition<A>) => void {
+  return <A extends ZodRawShape | undefined>(tool: ToolDefinition<A>): void => {
+    if (allowedTools && !allowedTools.has(tool.name)) {
+      return;
+    }
+
+    const scopes = tool.scopes ?? [];
+    if (allowedScopes.size > 0 && scopes.length === 0) {
+      return;
+    }
+
+    if (
+      allowedScopes.size > 0
+      && !scopes.every((s: MCPScope) => allowedScopes.has(s))
+    ) {
+      return;
+    }
+
+    if (tool.args) {
+      server.tool(
+        tool.name,
+        tool.description,
+        tool.args,
+        tool.annotations,
+        async (args, ctx) => {
+          return tool.tool(getSDK(), args, ctx);
+        },
+      );
+    } else {
+      server.tool(
+        tool.name,
+        tool.description,
+        tool.annotations,
+        async (_, ctx) => {
+          return tool.tool(getSDK(), ctx);
+        },
+      );
+    }
+
+    logger.debug("Registered tool", { name: tool.name });
+  };
+}

package/src/models/accesscontrolitem.ts

@@ -0,0 +1,38 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod";
+
+/**
+ * The type of access control to apply to the asset.
+ */
+export const AccessType$zodSchema = z.enum([
+  "token",
+  "anonymous",
+]).describe("The type of access control to apply to the asset.");
+
+export type AccessType = z.infer<typeof AccessType$zodSchema>;
+
+/**
+ * Access control rule that defines when and how the asset can be accessed.
+ */
+export type AccessControlItem = {
+  access_type: AccessType;
+  key?: string | undefined;
+  start?: string | undefined;
+  end?: string | undefined;
+};
+
+export const AccessControlItem$zodSchema: z.ZodType<
+  AccessControlItem,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  access_type: AccessType$zodSchema,
+  end: z.string().optional(),
+  key: z.string().optional(),
+  start: z.string().optional(),
+}).describe(
+  "Access control rule that defines when and how the asset can be accessed.",
+);

package/src/models/apierror.ts

@@ -0,0 +1,19 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod";
+
+export type ErrorT = { message: string };
+
+export const ErrorT$zodSchema: z.ZodType<ErrorT, z.ZodTypeDef, unknown> = z
+  .object({
+    message: z.string(),
+  });
+
+export type ApiError = { error: ErrorT };
+
+export const ApiError$zodSchema: z.ZodType<ApiError, z.ZodTypeDef, unknown> = z
+  .object({
+    error: z.lazy(() => ErrorT$zodSchema),
+  });

package/src/models/createrequest.ts

@@ -0,0 +1,19 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod";
+
+export type CreateRequest = {
+  transformation: string;
+  allowed_for_strict?: boolean | undefined;
+};
+
+export const CreateRequest$zodSchema: z.ZodType<
+  CreateRequest,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  allowed_for_strict: z.boolean().optional(),
+  transformation: z.string(),
+});

package/src/models/createstreamingprofileop.ts

@@ -0,0 +1,47 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod";
+import { ApiError, ApiError$zodSchema } from "./apierror.js";
+import {
+  StreamingProfile,
+  StreamingProfile$zodSchema,
+} from "./streamingprofile.js";
+
+export type CreateStreamingProfileGlobals = { cloud_name?: string | undefined };
+
+export const CreateStreamingProfileGlobals$zodSchema: z.ZodType<
+  CreateStreamingProfileGlobals,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  cloud_name: z.string().describe("The cloud name of your product environment.")
+    .optional(),
+});
+
+/**
+ * Streaming profile created
+ */
+export type CreateStreamingProfileResponseBody = { data: StreamingProfile };
+
+export const CreateStreamingProfileResponseBody$zodSchema: z.ZodType<
+  CreateStreamingProfileResponseBody,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  data: StreamingProfile$zodSchema,
+}).describe("Streaming profile created");
+
+export type CreateStreamingProfileResponse =
+  | CreateStreamingProfileResponseBody
+  | ApiError;
+
+export const CreateStreamingProfileResponse$zodSchema: z.ZodType<
+  CreateStreamingProfileResponse,
+  z.ZodTypeDef,
+  unknown
+> = z.union([
+  z.lazy(() => CreateStreamingProfileResponseBody$zodSchema),
+  ApiError$zodSchema,
+]);

package/src/models/createtransformationop.ts

@@ -0,0 +1,61 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod";
+import { ApiError, ApiError$zodSchema } from "./apierror.js";
+import { CreateRequest, CreateRequest$zodSchema } from "./createrequest.js";
+
+export type CreateTransformationGlobals = { cloud_name?: string | undefined };
+
+export const CreateTransformationGlobals$zodSchema: z.ZodType<
+  CreateTransformationGlobals,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  cloud_name: z.string().describe("The cloud name of your product environment.")
+    .optional(),
+});
+
+export type CreateTransformationRequest = {
+  transformation: string;
+  create_request: CreateRequest;
+};
+
+export const CreateTransformationRequest$zodSchema: z.ZodType<
+  CreateTransformationRequest,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  create_request: CreateRequest$zodSchema,
+  transformation: z.string().describe(
+    "The valid transformation name to create.\n"
+      + "",
+  ),
+});
+
+/**
+ * Transformation created
+ */
+export type CreateTransformationResponseBody = { message?: string | undefined };
+
+export const CreateTransformationResponseBody$zodSchema: z.ZodType<
+  CreateTransformationResponseBody,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  message: z.string().optional(),
+}).describe("Transformation created");
+
+export type CreateTransformationResponse =
+  | ApiError
+  | CreateTransformationResponseBody;
+
+export const CreateTransformationResponse$zodSchema: z.ZodType<
+  CreateTransformationResponse,
+  z.ZodTypeDef,
+  unknown
+> = z.union([
+  ApiError$zodSchema,
+  z.lazy(() => CreateTransformationResponseBody$zodSchema),
+]);