## Mcp-typescript SDK Changes: (#7)

* `CloudinaryAssetMgmt.assets.listVideos()`:  `response.resources[]` **Changed** (Breaking ⚠️)
* `CloudinaryAssetMgmt.assets.updateResourceByAssetId()`: 
  *  `request.ResourceUpdateRequest` **Changed** (Breaking ⚠️)
  *  `response` **Changed** (Breaking ⚠️)
* `CloudinaryAssetMgmt.search.visualSearchAssets()`:  `response.resources[].status` **Changed** (Breaking ⚠️)
* `CloudinaryAssetMgmt.search.searchAssets()`:  `response.resources[].status` **Changed** (Breaking ⚠️)
* `CloudinaryAssetMgmt.moderations.listResourcesByModerationKindAndStatus()`:  `response.resources[]` **Changed** (Breaking ⚠️)
* `CloudinaryAssetMgmt.upload.upload()`:  `request.upload_request` **Changed** (Breaking ⚠️)
* `CloudinaryAssetMgmt.upload.uploadNoResourceType()`:  `request` **Changed** (Breaking ⚠️)
* `CloudinaryAssetMgmt.upload.uploadChunk()`:  `request.upload_request` **Changed** (Breaking ⚠️)
* `CloudinaryAssetMgmt.upload.destroyAsset()`:  `response.result.enum(not found)` **Added** (Breaking ⚠️)
* `CloudinaryAssetMgmt.assets.listRawFiles()`:  `response.resources[]` **Changed** (Breaking ⚠️)
* `CloudinaryAssetMgmt.assets.explicitAsset()`: 
  *  `request.RequestBody.moderation` **Changed** (Breaking ⚠️)
* `CloudinaryAssetMgmt.assets.listImages()`:  `response.resources[]` **Changed** (Breaking ⚠️)
* `CloudinaryAssetMgmt.assets.getResourceByAssetId()`:  `response` **Changed** (Breaking ⚠️)
* `CloudinaryAssetMgmt.assets.updateResourceByPublicId()`: 
  *  `request.ResourceUpdateRequest` **Changed** (Breaking ⚠️)
  *  `response` **Changed** (Breaking ⚠️)
* `CloudinaryAssetMgmt.assets.restoreResourcesByAssetIDs()`:  `response.Map<restore_response>.union(info)` **Changed** (Breaking ⚠️)
* `CloudinaryAssetMgmt.assets.listResourcesByAssetIDs()`:  `response.resources[]` **Changed** (Breaking ⚠️)
* `CloudinaryAssetMgmt.assets.listResourcesByContext()`:  `response.resources[]` **Changed** (Breaking ⚠️)
* `CloudinaryAssetMgmt.assets.listResourcesByModerationKindAndStatus()`:  `response.resources[]` **Changed** (Breaking ⚠️)
* `CloudinaryAssetMgmt.assets.listResourcesByAssetFolder()`:  `response.resources[]` **Changed** (Breaking ⚠️)
* `CloudinaryAssetMgmt.assets.getResourceByPublicId()`:  `response` **Changed** (Breaking ⚠️)
* `CloudinaryAssetMgmt.folders.getFolderRoles()`: **Added**
* `CloudinaryAssetMgmt.folders.assignFolderRoles()`: **Added**
* `CloudinaryAssetMgmt.upload.text()`:  `response` **Changed**
* `CloudinaryAssetMgmt.people.updatePerson()`: **Added**
* `CloudinaryAssetMgmt.people.getPerson()`: **Added**
* `CloudinaryAssetMgmt.people.listPeople()`: **Added**

Co-authored-by: speakeasybot <bot@speakeasyapi.dev>

Author: github-actions[bot]

.npmignore

@@ -3,7 +3,10 @@
 !/**/*.ts
 !/**/*.js
 !/**/*.mjs
-!/**/*.json
+!/package.json
+!/jsr.json
+!/dist/**/*.json
+!/esm/**/*.json
 !/**/*.map
 
 /eslint.config.mjs

.speakeasy/gen.lock

@@ -14,6 +14,7 @@ generation:
     securityFeb2025: true
     sharedErrorComponentsApr2025: true
     sharedNestedComponentsJan2026: false
+    nameOverrideFeb2026: false
   auth:
     oAuth2ClientCredentialsEnabled: true
     oAuth2PasswordEnabled: true
@@ -30,7 +31,7 @@ generation:
     generateNewTests: true
     skipResponseBodyAssertions: false
 mcp-typescript:
-  version: 0.7.0
+  version: 0.8.0
   additionalDependencies:
     dependencies: {}
     devDependencies: {}

.speakeasy/gen.yaml

@@ -1,19 +1,18 @@
-speakeasyVersion: 1.718.0
+speakeasyVersion: 1.755.0
 sources:
     CloudinaryAssetMgmt-MCP-OAS:
         sourceNamespace: cloudinary-asset-mgmt-mcp-oas
-        sourceRevisionDigest: sha256:54488bad4e45592eff31da0005697492192900c66cce2a8cd6cf4ec767a7c921
-        sourceBlobDigest: sha256:f4caad987450dc6391aacfcad94c27c951ff8a84fb03db609c8a1b470d0a9e0c
+        sourceRevisionDigest: sha256:98b76aa350b6b9401a8ed927940ad205d5c04c72b470d67c40befe1558ea6fb2
+        sourceBlobDigest: sha256:8f3672ab7f5ca9c1539d8daab3280e6f3e6019936d01c4c2956ce628082c4314
         tags:
             - latest
-            - speakeasy-sdk-regen-1771242575
-            - 0.3.5
+            - 0.4.0
 targets:
     cloudinary-asset-mgmt-mcp:
         source: CloudinaryAssetMgmt-MCP-OAS
         sourceNamespace: cloudinary-asset-mgmt-mcp-oas
-        sourceRevisionDigest: sha256:54488bad4e45592eff31da0005697492192900c66cce2a8cd6cf4ec767a7c921
-        sourceBlobDigest: sha256:f4caad987450dc6391aacfcad94c27c951ff8a84fb03db609c8a1b470d0a9e0c
+        sourceRevisionDigest: sha256:98b76aa350b6b9401a8ed927940ad205d5c04c72b470d67c40befe1558ea6fb2
+        sourceBlobDigest: sha256:8f3672ab7f5ca9c1539d8daab3280e6f3e6019936d01c4c2956ce628082c4314
 workflow:
     workflowVersion: 1.0.0
     speakeasyVersion: latest

.speakeasy/workflow.lock

@@ -18,6 +18,7 @@
 * [Development](#development)
   * [Building from Source](#building-from-source)
   * [Contributions](#contributions)
+  * [Progressive Discovery](#progressive-discovery)
 
 <!-- End Table of Contents [toc] -->
 
@@ -27,9 +28,9 @@
 <details>
 <summary>Claude Desktop</summary>
 
-Install the MCP server as a Desktop Extension using the pre-built [`mcp-server.mcpb`](https://github.com/cloudinary/asset-management-mcp/releases/download/v0.7.0/mcp-server.mcpb) file:
+Install the MCP server as a Desktop Extension using the pre-built [`mcp-server.mcpb`](https://github.com/cloudinary/asset-management-mcp/releases/download/v0.8.0/mcp-server.mcpb) file:
 
-Simply drag and drop the [`mcp-server.mcpb`](https://github.com/cloudinary/asset-management-mcp/releases/download/v0.7.0/mcp-server.mcpb) file onto Claude Desktop to install the extension.
+Simply drag and drop the [`mcp-server.mcpb`](https://github.com/cloudinary/asset-management-mcp/releases/download/v0.8.0/mcp-server.mcpb) file onto Claude Desktop to install the extension.
 
 The MCP bundle package includes the MCP server and all necessary configuration. Once installed, the server will be available without additional setup.
 
@@ -379,4 +380,47 @@ We look forward to hearing your feedback. Feel free to open a PR or issue with a
 
 ### MCP Server Created by [Speakeasy](https://www.speakeasy.com/?utm_source=asset-management-mcp&utm_campaign=mcp-typescript)
 
+<!-- Start Progressive Discovery [dynamic-mode] -->
+## Progressive Discovery
+
+MCP servers with many tools can bloat LLM context windows, leading to increased token usage and tool confusion. Dynamic mode solves this by exposing only a small set of meta-tools that let agents progressively discover and invoke tools on demand.
+
+To enable dynamic mode, pass the `--mode dynamic` flag when starting your server:
+
+```jsonc
+{
+  "mcpServers": {
+    "CloudinaryAssetMgmt": {
+      "command": "npx",
+      "args": ["@cloudinary/asset-management-mcp", "start", "--mode", "dynamic"],
+      // ... other server arguments
+    }
+  }
+}
+```
+
+In dynamic mode, the server registers only the following meta-tools instead of every individual tool:
+
+- **`list_tools`**: Lists all available tools with their names and descriptions.
+- **`describe_tool`**: Returns the input schema for one or more tools by name.
+- **`execute_tool`**: Executes a tool by name with the provided input parameters.
+- **`list_scopes`**: Lists the scopes available on the server.
+
+This approach significantly reduces the number of tokens sent to the LLM on each request, which is especially useful for servers with a large number of tools.
+
+You can combine dynamic mode with scope and tool filters:
+
+```jsonc
+{
+  "mcpServers": {
+    "CloudinaryAssetMgmt": {
+      "command": "npx",
+      "args": ["@cloudinary/asset-management-mcp", "start", "--mode", "dynamic", "--scope", "admin"],
+      // ... other server arguments
+    }
+  }
+}
+```
+<!-- End Progressive Discovery [dynamic-mode] -->
+
 <!-- Placeholder for Future Speakeasy SDK Sections -->

README.md

@@ -30,4 +30,12 @@ Based on:
 - OpenAPI Doc  
 - Speakeasy CLI 1.718.0 (2.824.1) https://github.com/speakeasy-api/speakeasy
 ### Generated
-- [mcp-typescript v0.7.0] .
+- [mcp-typescript v0.7.0] .
+
+## 2026-03-16 00:05:40
+### Changes
+Based on:
+- OpenAPI Doc  
+- Speakeasy CLI 1.755.0 (2.865.2) https://github.com/speakeasy-api/speakeasy
+### Generated
+- [mcp-typescript v0.8.0] .

RELEASES.md

@@ -71,7 +71,7 @@
       "type": "string"
     }
   },
-  "version": "0.7.0",
+  "version": "0.8.0",
   "tools": [
     {
       "name": "upload-asset",

manifest.json

@@ -1,6 +1,6 @@
 {
   "name": "@cloudinary/asset-management-mcp",
-  "version": "0.7.0",
+  "version": "0.8.0",
   "author": "Cloudinary",
   "type": "module",
   "sideEffects": false,

package-lock.json

@@ -0,0 +1,173 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { CloudinaryAssetMgmtCore } from "../core.js";
+import { encodeJSON, encodeSimple } from "../lib/encodings.js";
+import { compactMap } from "../lib/primitives.js";
+import { safeParse } from "../lib/schemas.js";
+import { RequestOptions } from "../lib/sdks.js";
+import { extractSecurity, resolveGlobalSecurity } from "../lib/security.js";
+import { pathToFunc } from "../lib/url.js";
+import {
+  AssignFolderRolesRequestRequest,
+  AssignFolderRolesRequestRequest$zodSchema,
+} from "../models/assignfolderrolesop.js";
+import { AssignFolderRolesRequest } from "../models/assignfolderrolesrequest.js";
+import { APIError } from "../models/errors/apierror.js";
+import {
+  ConnectionError,
+  InvalidRequestError,
+  RequestAbortedError,
+  RequestTimeoutError,
+  UnexpectedClientError,
+} from "../models/errors/httpclienterrors.js";
+import { SDKValidationError } from "../models/errors/sdkvalidationerror.js";
+import { APICall, APIPromise } from "../types/async.js";
+import { Result } from "../types/fp.js";
+
+/**
+ * Assign folder roles
+ *
+ * @remarks
+ * Assigns or removes folder roles for a principal (user, group, or API key).
+ * Supports all system folder roles (see [System roles reference](https://cloudinary.com/documentation/permissions_system_roles_policies#folder_roles)).
+ * Enterprise customers can also assign custom roles by ID.
+ * Note: Assigning roles to users or groups via this endpoint requires their user or group IDs, which are available through the Provisioning API (Enterprise only). Free customers can use this endpoint to assign roles only to API keys, but can assign folder roles to users and groups through the UI.
+ */
+export function foldersAssignFolderRoles(
+  client$: CloudinaryAssetMgmtCore,
+  folder_id: string,
+  assign_folder_roles_request: AssignFolderRolesRequest,
+  options?: RequestOptions,
+): APIPromise<
+  Result<
+    Response,
+    | APIError
+    | SDKValidationError
+    | UnexpectedClientError
+    | InvalidRequestError
+    | RequestAbortedError
+    | RequestTimeoutError
+    | ConnectionError
+  >
+> {
+  return new APIPromise($do(
+    client$,
+    folder_id,
+    assign_folder_roles_request,
+    options,
+  ));
+}
+
+async function $do(
+  client$: CloudinaryAssetMgmtCore,
+  folder_id: string,
+  assign_folder_roles_request: AssignFolderRolesRequest,
+  options?: RequestOptions,
+): Promise<
+  [
+    Result<
+      Response,
+      | APIError
+      | SDKValidationError
+      | UnexpectedClientError
+      | InvalidRequestError
+      | RequestAbortedError
+      | RequestTimeoutError
+      | ConnectionError
+    >,
+    APICall,
+  ]
+> {
+  const input$: AssignFolderRolesRequestRequest = {
+    folder_id: folder_id,
+    assign_folder_roles_request: assign_folder_roles_request,
+  };
+
+  const parsed$ = safeParse(
+    input$,
+    (value$) => AssignFolderRolesRequestRequest$zodSchema.parse(value$),
+    "Input validation failed",
+  );
+  if (!parsed$.ok) {
+    return [parsed$, { status: "invalid" }];
+  }
+  const payload$ = parsed$.value;
+  const body$ = encodeJSON("body", payload$.assign_folder_roles_request, {
+    explode: true,
+  });
+
+  const pathParams$ = {
+    cloud_name: encodeSimple("cloud_name", client$._options.cloud_name, {
+      explode: false,
+      charEncoding: "percent",
+    }),
+    folder_id: encodeSimple("folder_id", payload$.folder_id, {
+      explode: false,
+      charEncoding: "percent",
+    }),
+  };
+  const path$ = pathToFunc(
+    "/v1_1/{cloud_name}/folder_operations/invite/{folder_id}",
+  )(
+    pathParams$,
+  );
+
+  const headers$ = new Headers(compactMap({
+    "Content-Type": "application/json",
+    Accept: "application/json",
+  }));
+  const securityInput = await extractSecurity(client$._options.security);
+  const requestSecurity = resolveGlobalSecurity(securityInput);
+
+  const context = {
+    options: client$._options,
+    baseURL: options?.serverURL ?? client$._baseURL ?? "",
+    operationID: "assignFolderRoles",
+    oAuth2Scopes: null,
+    resolvedSecurity: requestSecurity,
+    securitySource: client$._options.security,
+    retryConfig: options?.retries
+      || client$._options.retryConfig
+      || { strategy: "none" },
+    retryCodes: options?.retryCodes || [
+      "429",
+      "500",
+      "502",
+      "503",
+      "504",
+    ],
+  };
+
+  const requestRes = client$._createRequest(context, {
+    security: requestSecurity,
+    method: "POST",
+    baseURL: options?.serverURL,
+    path: path$,
+    headers: headers$,
+    body: body$,
+    userAgent: client$._options.userAgent,
+    timeoutMs: options?.timeoutMs || client$._options.timeoutMs
+      || -1,
+  }, options);
+  if (!requestRes.ok) {
+    return [requestRes, { status: "invalid" }];
+  }
+  const req$ = requestRes.value;
+
+  const doResult = await client$._do(req$, {
+    context,
+    errorCodes: [],
+    retryConfig: context.retryConfig,
+    retryCodes: context.retryCodes,
+  });
+  if (!doResult.ok) {
+    return [doResult, { status: "request-error", request: req$ }];
+  }
+  return [doResult, {
+    status: "complete",
+    "request": req$,
+    response: doResult.value,
+  }];
+}