@cloudinary/asset-management-mcp 0.6.1 → 0.6.3

package/README.md

@@ -266,6 +266,40 @@ The MCP server uses your Cloudinary API key and secret for authentication:
 
 The MCP server exposes Cloudinary's Asset Management API as tools. Use your AI application to discover and invoke the available tools for uploading, managing, searching, and transforming your media assets.
 
+### Usage Examples
+
+#### Example 1: Upload and Transform an Image
+
+```
+1. Upload a local image: "Upload file:///Users/me/photo.jpg to Cloudinary as 'hero-image'"
+2. Transform it: "Transform asset 'hero-image' with transformations 'c_fill,w_800,h_600/e_sharpen'"
+3. Get details: "Show me details for asset with ID [asset-id]"
+```
+
+#### Example 2: Search and Organize Assets
+
+```
+1. Search for images: "Find all images with tag 'product' uploaded in the last 7 days"
+2. Create folder: "Create a new folder called 'summer-2024-products'"
+3. List assets: "Show me all video assets in the 'marketing' folder"
+```
+
+#### Example 3: Generate Archive
+
+```
+1. Get transformation docs: "Show me the Cloudinary transformation reference"
+2. Apply transformations: "Transform 'banner' asset with 'c_scale,w_1200/f_auto,q_auto'"
+3. Create archive: "Generate a ZIP archive of all images with tag 'export-ready'"
+```
+
+#### Example 4: Asset Management Workflow
+
+```
+1. Upload multiple files: "Upload all images from folder /assets/new-products/"
+2. Add tags: "Update asset [asset-id] and add tags 'featured,homepage'"
+3. Get usage stats: "Show my Cloudinary account usage statistics"
+```
+
 ## Custom Tools
 
 This MCP server includes two powerful custom tools:

package/bin/mcp-server.js

@@ -4054,9 +4054,9 @@ var init_config = __esm(() => {
   SDK_METADATA = {
     language: "typescript",
     openapiDocVersion: "0.3.5",
-    sdkVersion: "0.6.1",
-    genVersion: "2.755.9",
-    userAgent: "speakeasy-sdk/mcp-typescript 0.6.1 2.755.9 0.3.5 @cloudinary/asset-management-mcp"
+    sdkVersion: "0.6.3",
+    genVersion: "2.767.2",
+    userAgent: "speakeasy-sdk/mcp-typescript 0.6.3 2.767.2 0.3.5 @cloudinary/asset-management-mcp"
   };
 });
 
@@ -48134,8 +48134,9 @@ function match(...matchers) {
       const result = safeParse(data, (v2) => matcher.schema.parse(v2), "Response validation failed");
       return [result.ok ? { ok: false, error: result.value } : result, raw];
     } else {
+      const valueToParse = resultKey && isPlainObject2(data) && resultKey in data ? data[resultKey] : data;
       return [
-        safeParse(data, (v2) => matcher.schema.parse(v2), "Response validation failed"),
+        safeParse(valueToParse, (v2) => matcher.schema.parse(v2), "Response validation failed"),
         raw
       ];
     }
@@ -48509,13 +48510,10 @@ var init_explicitassetop = __esm(() => {
     RequestBody: lazyType(() => ExplicitAssetRequestBody$zodSchema),
     resource_type: ResourceType$zodSchema
   });
-  ExplicitAssetResponse$zodSchema = objectType({
-    ContentType: stringType(),
-    RawResponse: instanceOfType(Response),
-    StatusCode: numberType().int(),
-    api_error: ApiError$zodSchema.optional(),
-    upload_response: UploadResponse$zodSchema.optional()
-  });
+  ExplicitAssetResponse$zodSchema = unionType([
+    ApiError$zodSchema,
+    UploadResponse$zodSchema
+  ]);
 });
 
 // src/types/async.ts
@@ -48890,13 +48888,10 @@ var init_createassetrelationsbyassetidop = __esm(() => {
     RequestBody: lazyType(() => CreateAssetRelationsByAssetIdRequestBody$zodSchema),
     asset_id: stringType().describe("The asset ID of the resource. Must be a 32-character hexadecimal string.")
   });
-  CreateAssetRelationsByAssetIdResponse$zodSchema = objectType({
-    ContentType: stringType(),
-    RawResponse: instanceOfType(Response),
-    StatusCode: numberType().int(),
-    api_error: ApiError$zodSchema.optional(),
-    asset_relations_response: AssetRelationsResponse$zodSchema.optional()
-  });
+  CreateAssetRelationsByAssetIdResponse$zodSchema = unionType([
+    ApiError$zodSchema,
+    AssetRelationsResponse$zodSchema
+  ]);
 });
 
 // src/funcs/assetRelationsCreateAssetRelationsByAssetId.ts
@@ -49058,13 +49053,10 @@ var init_deleteassetrelationsbyassetidop = __esm(() => {
     RequestBody: lazyType(() => DeleteAssetRelationsByAssetIdRequestBody$zodSchema),
     asset_id: stringType().describe("The asset ID of the resource. Must be a 32-character hexadecimal string.")
   });
-  DeleteAssetRelationsByAssetIdResponse$zodSchema = objectType({
-    ContentType: stringType(),
-    RawResponse: instanceOfType(Response),
-    StatusCode: numberType().int(),
-    api_error: ApiError$zodSchema.optional(),
-    asset_relations_delete_response: AssetRelationsDeleteResponse$zodSchema.optional()
-  });
+  DeleteAssetRelationsByAssetIdResponse$zodSchema = unionType([
+    ApiError$zodSchema,
+    AssetRelationsDeleteResponse$zodSchema
+  ]);
 });
 
 // src/funcs/assetRelationsDeleteAssetRelationsByAssetId.ts
@@ -49227,13 +49219,10 @@ var init_deriveddestroyop = __esm(() => {
   DerivedDestroyGlobals$zodSchema = objectType({
     cloud_name: stringType().describe("The cloud name of your product environment.").optional()
   });
-  DerivedDestroyResponseResponse$zodSchema = objectType({
-    ContentType: stringType(),
-    DerivedDestroyResponse: DerivedDestroyResponse$zodSchema.optional(),
-    RawResponse: instanceOfType(Response),
-    StatusCode: numberType().int(),
-    api_error: ApiError$zodSchema.optional()
-  });
+  DerivedDestroyResponseResponse$zodSchema = unionType([
+    ApiError$zodSchema,
+    DerivedDestroyResponse$zodSchema
+  ]);
 });
 
 // src/models/deriveddestroyrequest.ts
@@ -49392,13 +49381,10 @@ var init_destroybyassetidop = __esm(() => {
   DestroyByAssetIdGlobals$zodSchema = objectType({
     cloud_name: stringType().describe("The cloud name of your product environment.").optional()
   });
-  DestroyByAssetIdResponse$zodSchema = objectType({
-    ContentType: stringType(),
-    RawResponse: instanceOfType(Response),
-    StatusCode: numberType().int(),
-    api_error: ApiError$zodSchema.optional(),
-    destroy_response: DestroyResponse$zodSchema.optional()
-  });
+  DestroyByAssetIdResponse$zodSchema = unionType([
+    DestroyResponse$zodSchema,
+    ApiError$zodSchema
+  ]);
 });
 
 // src/models/destroyrequest.ts
@@ -49576,18 +49562,15 @@ var init_downloadbackupassetop = __esm(() => {
   DownloadBackupAssetBadRequestResponseBody$zodSchema = objectType({
     error: lazyType(() => BadRequestError$zodSchema).optional()
   }).describe("Bad request");
-  DownloadBackupAssetResponse$zodSchema = objectType({
-    ContentType: stringType(),
-    RawResponse: instanceOfType(Response),
-    StatusCode: numberType().int(),
-    fourHundredAndFourApplicationJsonObject: lazyType(() => DownloadBackupAssetNotFoundResponseBody$zodSchema).optional(),
-    fourHundredAndOneApplicationJsonObject: lazyType(() => DownloadBackupAssetUnauthorizedResponseBody$zodSchema).optional(),
-    fourHundredApplicationJsonObject: lazyType(() => DownloadBackupAssetBadRequestResponseBody$zodSchema).optional(),
-    twoHundredApplicationOctetStreamBytes: stringType().base64().describe("Asset backup downloaded successfully").optional(),
-    twoHundredImageWildcardBytes: stringType().base64().describe("Asset backup downloaded successfully").optional(),
-    twoHundredTextPlainBytes: stringType().base64().describe("Asset backup downloaded successfully").optional(),
-    twoHundredVideoWildcardBytes: stringType().base64().describe("Asset backup downloaded successfully").optional()
-  });
+  DownloadBackupAssetResponse$zodSchema = unionType([
+    stringType().base64().describe("Asset backup downloaded successfully"),
+    stringType().base64().describe("Asset backup downloaded successfully"),
+    stringType().base64().describe("Asset backup downloaded successfully"),
+    stringType().base64().describe("Asset backup downloaded successfully"),
+    lazyType(() => DownloadBackupAssetBadRequestResponseBody$zodSchema),
+    lazyType(() => DownloadBackupAssetUnauthorizedResponseBody$zodSchema),
+    lazyType(() => DownloadBackupAssetNotFoundResponseBody$zodSchema)
+  ]);
 });
 
 // src/funcs/assetsDownloadBackupAsset.ts
@@ -49821,14 +49804,11 @@ var init_generatearchiveop = __esm(() => {
     version: numberType().int().optional(),
     version_id: stringType().optional()
   }).describe("Archive successfully generated or downloaded");
-  GenerateArchiveResponse$zodSchema = objectType({
-    ContentType: stringType(),
-    RawResponse: instanceOfType(Response),
-    StatusCode: numberType().int(),
-    api_error: ApiError$zodSchema.optional(),
-    bytes: stringType().base64().describe("Archive successfully generated or downloaded").optional(),
-    object: lazyType(() => GenerateArchiveResponseBody$zodSchema).optional()
-  });
+  GenerateArchiveResponse$zodSchema = unionType([
+    ApiError$zodSchema,
+    stringType().base64().describe("Archive successfully generated or downloaded"),
+    lazyType(() => GenerateArchiveResponseBody$zodSchema)
+  ]);
 });
 
 // src/funcs/assetsGenerateArchive.ts
@@ -50053,13 +50033,10 @@ var init_getresourcebyassetidop = __esm(() => {
     quality_analysis: booleanType().default(false).describe("Whether to return quality analysis scores for the image. Default: false."),
     versions: booleanType().default(false).describe("Whether to include details of all the backed up versions of the asset. Default: false.")
   });
-  GetResourceByAssetIdResponse$zodSchema = objectType({
-    ContentType: stringType(),
-    RawResponse: instanceOfType(Response),
-    StatusCode: numberType().int(),
-    api_error: ApiError$zodSchema.optional(),
-    info: Info$zodSchema.optional()
-  });
+  GetResourceByAssetIdResponse$zodSchema = unionType([
+    ApiError$zodSchema,
+    Info$zodSchema
+  ]);
 });
 
 // src/funcs/assetsGetResourceByAssetId.ts
@@ -50316,13 +50293,10 @@ var init_listimagesop = __esm(() => {
     tags: booleanType().describe("Whether to include the list of tag names assigned to each asset. Default: false").optional(),
     type: ListStorageType$zodSchema.optional()
   });
-  ListImagesResponse$zodSchema = objectType({
-    ContentType: stringType(),
-    RawResponse: instanceOfType(Response),
-    StatusCode: numberType().int(),
-    api_error: ApiError$zodSchema.optional(),
-    list_response: ListResponse$zodSchema.optional()
-  });
+  ListImagesResponse$zodSchema = unionType([
+    ApiError$zodSchema,
+    ListResponse$zodSchema
+  ]);
 });
 
 // src/funcs/assetsListImages.ts
@@ -50501,13 +50475,10 @@ var init_listrawfilesop = __esm(() => {
     tags: booleanType().describe("Whether to include the list of tag names assigned to each asset. Default: false").optional(),
     type: ListStorageType$zodSchema.optional()
   });
-  ListRawFilesResponse$zodSchema = objectType({
-    ContentType: stringType(),
-    RawResponse: instanceOfType(Response),
-    StatusCode: numberType().int(),
-    api_error: ApiError$zodSchema.optional(),
-    list_response: ListResponse$zodSchema.optional()
-  });
+  ListRawFilesResponse$zodSchema = unionType([
+    ApiError$zodSchema,
+    ListResponse$zodSchema
+  ]);
 });
 
 // src/funcs/assetsListRawFiles.ts
@@ -50682,13 +50653,10 @@ var init_listresourcetagsop = __esm(() => {
     next_cursor: stringType().nullable().optional(),
     tags: arrayType(stringType()).optional()
   }).describe("List of tags retrieved");
-  ListResourceTagsResponse$zodSchema = objectType({
-    ContentType: stringType(),
-    RawResponse: instanceOfType(Response),
-    StatusCode: numberType().int(),
-    api_error: ApiError$zodSchema.optional(),
-    object: lazyType(() => ListResourceTagsResponseBody$zodSchema).optional()
-  });
+  ListResourceTagsResponse$zodSchema = unionType([
+    ApiError$zodSchema,
+    lazyType(() => ListResourceTagsResponseBody$zodSchema)
+  ]);
 });
 
 // src/funcs/assetsListResourceTags.ts
@@ -50856,13 +50824,10 @@ var init_listvideosop = __esm(() => {
     tags: booleanType().describe("Whether to include the list of tag names assigned to each asset. Default: false").optional(),
     type: ListStorageType$zodSchema.optional()
   });
-  ListVideosResponse$zodSchema = objectType({
-    ContentType: stringType(),
-    RawResponse: instanceOfType(Response),
-    StatusCode: numberType().int(),
-    api_error: ApiError$zodSchema.optional(),
-    list_response: ListResponse$zodSchema.optional()
-  });
+  ListVideosResponse$zodSchema = unionType([
+    ApiError$zodSchema,
+    ListResponse$zodSchema
+  ]);
 });
 
 // src/funcs/assetsListVideos.ts
@@ -51058,13 +51023,10 @@ var init_renameassetop = __esm(() => {
     RequestBody: lazyType(() => RenameAssetRequestBody$zodSchema),
     resource_type: ResourceType$zodSchema
   });
-  RenameAssetResponse$zodSchema = objectType({
-    ContentType: stringType(),
-    RawResponse: instanceOfType(Response),
-    StatusCode: numberType().int(),
-    api_error: ApiError$zodSchema.optional(),
-    upload_response: UploadResponse$zodSchema.optional()
-  });
+  RenameAssetResponse$zodSchema = unionType([
+    ApiError$zodSchema,
+    UploadResponse$zodSchema
+  ]);
 });
 
 // src/funcs/assetsRenameAsset.ts
@@ -51260,13 +51222,10 @@ var init_updateresourcebyassetidop = __esm(() => {
     ResourceUpdateRequest: ResourceUpdateRequest$zodSchema,
     asset_id: stringType().describe("The asset ID of the resource. Must be a 32-character hexadecimal string.")
   });
-  UpdateResourceByAssetIdResponse$zodSchema = objectType({
-    ContentType: stringType(),
-    RawResponse: instanceOfType(Response),
-    StatusCode: numberType().int(),
-    api_error: ApiError$zodSchema.optional(),
-    info: Info$zodSchema.optional()
-  });
+  UpdateResourceByAssetIdResponse$zodSchema = unionType([
+    ApiError$zodSchema,
+    Info$zodSchema
+  ]);
 });
 
 // src/funcs/assetsUpdateResourceByAssetId.ts
@@ -51418,13 +51377,10 @@ var init_createfolderop = __esm(() => {
     path: stringType().optional(),
     success: booleanType().optional()
   }).describe("Folder created successfully");
-  CreateFolderResponse$zodSchema = objectType({
-    ContentType: stringType(),
-    RawResponse: instanceOfType(Response),
-    StatusCode: numberType().int(),
-    api_error: ApiError$zodSchema.optional(),
-    object: lazyType(() => CreateFolderResponseBody$zodSchema).optional()
-  });
+  CreateFolderResponse$zodSchema = unionType([
+    ApiError$zodSchema,
+    lazyType(() => CreateFolderResponseBody$zodSchema)
+  ]);
 });
 
 // src/funcs/foldersCreateFolder.ts
@@ -51567,13 +51523,10 @@ var init_destroyfolderop = __esm(() => {
   DestroyFolderResponseBody$zodSchema = objectType({
     deleted: arrayType(stringType())
   }).describe("Folder deleted successfully");
-  DestroyFolderResponse$zodSchema = objectType({
-    ContentType: stringType(),
-    RawResponse: instanceOfType(Response),
-    StatusCode: numberType().int(),
-    api_error: ApiError$zodSchema.optional(),
-    object: lazyType(() => DestroyFolderResponseBody$zodSchema).optional()
-  });
+  DestroyFolderResponse$zodSchema = unionType([
+    lazyType(() => DestroyFolderResponseBody$zodSchema),
+    ApiError$zodSchema
+  ]);
 });
 
 // src/funcs/foldersDestroyFolder.ts
@@ -51750,13 +51703,10 @@ var init_searchfoldersop = __esm(() => {
     next_cursor: stringType().describe("The cursor for pagination. Use the next_cursor value from a previous response to get the next page of results.").optional(),
     sort_by: arrayType(stringType()).describe("An array of key-value pairs for sorting. Each value is a key and direction (asc/desc).").optional()
   });
-  SearchFoldersResponse$zodSchema = objectType({
-    ContentType: stringType(),
-    RawResponse: instanceOfType(Response),
-    StatusCode: numberType().int(),
-    api_error: ApiError$zodSchema.optional(),
-    folders_search_response: FoldersSearchResponse$zodSchema.optional()
-  });
+  SearchFoldersResponse$zodSchema = unionType([
+    FoldersSearchResponse$zodSchema,
+    ApiError$zodSchema
+  ]);
 });
 
 // src/funcs/foldersSearchFolders.ts
@@ -51923,13 +51873,10 @@ var init_updatefolderop = __esm(() => {
     from: lazyType(() => From$zodSchema),
     to: lazyType(() => To$zodSchema)
   }).describe("Folder renamed successfully");
-  UpdateFolderResponse$zodSchema = objectType({
-    ContentType: stringType(),
-    RawResponse: instanceOfType(Response),
-    StatusCode: numberType().int(),
-    api_error: ApiError$zodSchema.optional(),
-    object: lazyType(() => UpdateFolderResponseBody$zodSchema).optional()
-  });
+  UpdateFolderResponse$zodSchema = unionType([
+    lazyType(() => UpdateFolderResponseBody$zodSchema),
+    ApiError$zodSchema
+  ]);
 });
 
 // src/funcs/foldersUpdateFolder.ts
@@ -52162,13 +52109,10 @@ var init_searchassetsop = __esm(() => {
   SearchAssetsGlobals$zodSchema = objectType({
     cloud_name: stringType().describe("The cloud name of your product environment.").optional()
   });
-  SearchAssetsResponse$zodSchema = objectType({
-    ContentType: stringType(),
-    RawResponse: instanceOfType(Response),
-    StatusCode: numberType().int(),
-    api_error: ApiError$zodSchema.optional(),
-    search_response: SearchResponse$zodSchema.optional()
-  });
+  SearchAssetsResponse$zodSchema = unionType([
+    ApiError$zodSchema,
+    SearchResponse$zodSchema
+  ]);
 });
 
 // src/models/searchsortpair.ts
@@ -52365,13 +52309,10 @@ var init_visualsearchassetsop = __esm(() => {
   VisualSearchAssetsGlobals$zodSchema = objectType({
     cloud_name: stringType().describe("The cloud name of your product environment.").optional()
   });
-  VisualSearchAssetsResponse$zodSchema = objectType({
-    ContentType: stringType(),
-    RawResponse: instanceOfType(Response),
-    StatusCode: numberType().int(),
-    api_error: ApiError$zodSchema.optional(),
-    search_response: SearchResponse$zodSchema.optional()
-  });
+  VisualSearchAssetsResponse$zodSchema = unionType([
+    ApiError$zodSchema,
+    SearchResponse$zodSchema
+  ]);
 });
 
 // src/models/visualsearchparametersunion.ts
@@ -52729,17 +52670,14 @@ var init_uploadop = __esm(() => {
     AsyncUploadResponse$zodSchema,
     UploadResponse$zodSchema
   ]).describe("Successful upload");
-  UploadResponseResponse$zodSchema = objectType({
-    ContentType: stringType(),
-    RawResponse: instanceOfType(Response),
-    StatusCode: numberType().int(),
-    api_error: ApiError$zodSchema.optional(),
-    html_redirect: stringType().describe("Redirect to callback URL (when 'callback' parameter is provided and request is not XHR).").optional(),
-    oneOf: unionType([
+  UploadResponseResponse$zodSchema = unionType([
+    ApiError$zodSchema,
+    unionType([
       AsyncUploadResponse$zodSchema,
       UploadResponse$zodSchema
-    ]).optional()
-  });
+    ]),
+    stringType().describe("Redirect to callback URL (when 'callback' parameter is provided and request is not XHR).")
+  ]);
 });
 
 // src/funcs/uploadUpload.ts
@@ -52953,13 +52891,10 @@ var init_getusageop = __esm(() => {
   GetUsageRequest$zodSchema = objectType({
     date: stringType().date().optional()
   });
-  GetUsageResponse$zodSchema = objectType({
-    ContentType: stringType(),
-    RawResponse: instanceOfType(Response),
-    StatusCode: numberType().int(),
-    api_error: ApiError$zodSchema.optional(),
-    usage_response: UsageResponse$zodSchema.optional()
-  });
+  GetUsageResponse$zodSchema = unionType([
+    ApiError$zodSchema,
+    UsageResponse$zodSchema
+  ]);
 });
 
 // src/funcs/usageGetUsage.ts
@@ -53090,7 +53025,7 @@ A report on the status of product environment usage, including storage, credits,
 function createMCPServer(deps) {
   const server = new McpServer({
     name: "CloudinaryAssetMgmt",
-    version: "0.6.1"
+    version: "0.6.3"
   });
   const getClient = deps.getSDK || (() => new CloudinaryAssetMgmtCore({
     security: deps.security,
@@ -54431,7 +54366,7 @@ var routes = ln({
 var app = _e(routes, {
   name: "mcp",
   versionInfo: {
-    currentVersion: "0.6.1"
+    currentVersion: "0.6.3"
   }
 });
 Yt(app, process3.argv.slice(2), buildContext(process3));
@@ -54439,5 +54374,5 @@ export {
   app
 };
 
-//# debugId=CA65099A33E78A0064756E2164756E21
+//# debugId=D4842FAA45F70FBA64756E2164756E21
 //# sourceMappingURL=mcp-server.js.map