Cloudinary

Cloudinary MCP Server for Cloudflare Workers

Available Tools

67 tools available in the Cloudinary MCP server. Each tool can be called by AI assistants to perform specific actions.

cloudinary_list_metadata_rules

List all metadata rules.

Metadata rules automatically apply metadata based on conditions.

Args:

format: Response format

{
  "type": "object",
  "properties": {}
}

cloudinary_publish_resources

Publish resources (make them available via CDN).

Args:

publicIds: Array of public IDs to publish (required)
resourceType: Type of resource - default: image

{
  "type": "object",
  "required": [
    "publicIds"
  ],
  "properties": {
    "publicIds": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Public IDs"
    }
  }
}

cloudinary_get_usage

Get usage statistics for your Cloudinary account.

Returns information about:

Plan type
Transformations, storage, bandwidth usage
Resource counts
Media size limits

Args:

date: Optional date to get historical usage (format: YYYY-MM-DD or "last-7-days", "last-30-days", etc.)
format: Response format

{
  "type": "object",
  "properties": {
    "date": {
      "type": "string",
      "description": "Date for historical usage"
    }
  }
}

cloudinary_get_config

Get your Cloudinary account configuration settings.

Returns account settings including folder mode, security settings, and more.

Args:

format: Response format

{
  "type": "object",
  "properties": {}
}

cloudinary_list_resource_types

List all resource types in your account (typically: image, video, raw).

Args:

format: Response format

{
  "type": "object",
  "properties": {}
}

cloudinary_update_access_mode_by_prefix

Update the access mode for all resources matching a prefix.

Args:

prefix: Public ID prefix to match (required)
accessMode: New access mode - public or authenticated (required)
resourceType: Type of resource - default: image
deliveryType: Delivery type - default: upload

{
  "type": "object",
  "required": [
    "prefix",
    "accessMode"
  ],
  "properties": {
    "prefix": {
      "type": "string",
      "description": "Public ID prefix"
    },
    "accessMode": {
      "enum": [
        "public",
        "authenticated"
      ],
      "type": "string",
      "description": "New access mode"
    }
  }
}

cloudinary_update_access_mode_by_tag

Update the access mode for all resources with a specific tag.

Args:

tag: Tag to match (required)
accessMode: New access mode - public or authenticated (required)
resourceType: Type of resource - default: image

{
  "type": "object",
  "required": [
    "tag",
    "accessMode"
  ],
  "properties": {
    "tag": {
      "type": "string",
      "description": "Tag to match"
    },
    "accessMode": {
      "enum": [
        "public",
        "authenticated"
      ],
      "type": "string",
      "description": "New access mode"
    }
  }
}

cloudinary_update_access_mode_by_ids

Update the access mode for specific resources by their public IDs.

Args:

publicIds: Array of public IDs (required)
accessMode: New access mode - public or authenticated (required)
resourceType: Type of resource - default: image
deliveryType: Delivery type - default: upload

{
  "type": "object",
  "required": [
    "publicIds",
    "accessMode"
  ],
  "properties": {
    "publicIds": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Public IDs"
    },
    "accessMode": {
      "enum": [
        "public",
        "authenticated"
      ],
      "type": "string",
      "description": "New access mode"
    }
  }
}

cloudinary_analyze

Run AI analysis on a resource.

Requires AI add-ons to be enabled.

Args:

inputType: Input type - uri (required)
uri: URI of the resource to analyze (required)
analysisType: Type of analysis to perform (required)
- captioning: Generate captions
- tagging: Auto-tag content
- moderation: Content moderation
- etc.

{
  "type": "object",
  "required": [
    "uri",
    "analysisType"
  ],
  "properties": {
    "uri": {
      "type": "string",
      "description": "Resource URI"
    },
    "inputType": {
      "type": "string",
      "default": "uri",
      "description": "Input type"
    },
    "analysisType": {
      "type": "string",
      "description": "Analysis type"
    }
  }
}

cloudinary_list_folders

List root-level folders in your Cloudinary account.

Args:

maxResults: Number of folders to return (default: 100)
nextCursor: Pagination cursor
format: Response format

{
  "type": "object",
  "properties": {
    "maxResults": {
      "type": "integer",
      "default": 100,
      "maximum": 500,
      "minimum": 1
    },
    "nextCursor": {
      "type": "string"
    }
  }
}

cloudinary_list_subfolders

List subfolders within a specific folder path.

Args:

path: Parent folder path (required)
maxResults: Number of folders to return (default: 100)
nextCursor: Pagination cursor
format: Response format

{
  "type": "object",
  "required": [
    "path"
  ],
  "properties": {
    "path": {
      "type": "string",
      "description": "Parent folder path"
    },
    "maxResults": {
      "type": "integer",
      "default": 100,
      "maximum": 500,
      "minimum": 1
    },
    "nextCursor": {
      "type": "string"
    }
  }
}

cloudinary_create_folder

Create a new folder at the specified path.

Args:

path: Full folder path to create (required)

Note: Parent folders are created automatically if they don't exist.

{
  "type": "object",
  "required": [
    "path"
  ],
  "properties": {
    "path": {
      "type": "string",
      "description": "Folder path to create"
    }
  }
}

cloudinary_rename_folder

Rename/move a folder to a new path.

Args:

fromPath: Current folder path (required)
toPath: New folder path (required)

Note: This updates the folder path for all resources in the folder.

{
  "type": "object",
  "required": [
    "fromPath",
    "toPath"
  ],
  "properties": {
    "toPath": {
      "type": "string",
      "description": "New folder path"
    },
    "fromPath": {
      "type": "string",
      "description": "Current folder path"
    }
  }
}

cloudinary_delete_folder

Delete a folder.

Args:

path: Folder path to delete (required)

Note: The folder must be empty before it can be deleted.

{
  "type": "object",
  "required": [
    "path"
  ],
  "properties": {
    "path": {
      "type": "string",
      "description": "Folder path to delete"
    }
  }
}

cloudinary_list_metadata_fields

List all structured metadata field definitions.

Args:

format: Response format

{
  "type": "object",
  "properties": {}
}

cloudinary_get_metadata_field

Get details of a specific metadata field.

Args:

fieldId: External ID of the field (required)
format: Response format

{
  "type": "object",
  "required": [
    "fieldId"
  ],
  "properties": {
    "fieldId": {
      "type": "string",
      "description": "Field external ID"
    }
  }
}

cloudinary_create_metadata_field

Create a new structured metadata field.

Args:

externalId: Unique external ID for the field
label: Display label (required)
type: Field type - string, integer, date, enum, or set (required)
mandatory: Whether the field is required (default: false)
defaultValue: Default value for the field
datasource: For enum/set types, array of values with {value, external_id}

{
  "type": "object",
  "required": [
    "label"
  ],
  "properties": {
    "label": {
      "type": "string",
      "description": "Display label"
    },
    "mandatory": {
      "type": "boolean",
      "description": "Is required"
    },
    "externalId": {
      "type": "string",
      "description": "External ID"
    },
    "defaultValue": {
      "description": "Default value"
    }
  }
}

cloudinary_update_metadata_field

Update an existing metadata field.

Args:

fieldId: External ID of the field (required)
label: New display label
mandatory: Whether the field is required
defaultValue: New default value

{
  "type": "object",
  "required": [
    "fieldId"
  ],
  "properties": {
    "label": {
      "type": "string"
    },
    "fieldId": {
      "type": "string",
      "description": "Field external ID"
    },
    "mandatory": {
      "type": "boolean"
    },
    "defaultValue": {}
  }
}

cloudinary_delete_metadata_field

Delete a metadata field definition.

Args:

fieldId: External ID of the field to delete (required)

{
  "type": "object",
  "required": [
    "fieldId"
  ],
  "properties": {
    "fieldId": {
      "type": "string",
      "description": "Field external ID"
    }
  }
}

cloudinary_update_metadata_datasource

Update the datasource values for an enum/set metadata field.

Args:

fieldId: External ID of the field (required)
values: Array of datasource entries with {value, external_id} (required)

{
  "type": "object",
  "required": [
    "fieldId"
  ],
  "properties": {
    "fieldId": {
      "type": "string",
      "description": "Field external ID"
    }
  }
}

cloudinary_delete_datasource_entries

Soft-delete (deactivate) datasource entries for a metadata field.

Args:

fieldId: External ID of the field (required)
externalIds: Array of datasource entry external IDs to deactivate (required)

{
  "type": "object",
  "required": [
    "fieldId",
    "externalIds"
  ],
  "properties": {
    "fieldId": {
      "type": "string",
      "description": "Field external ID"
    },
    "externalIds": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Entry external IDs"
    }
  }
}

cloudinary_restore_datasource_entries

Restore (reactivate) previously deleted datasource entries.

Args:

fieldId: External ID of the field (required)
externalIds: Array of datasource entry external IDs to restore (required)

{
  "type": "object",
  "required": [
    "fieldId",
    "externalIds"
  ],
  "properties": {
    "fieldId": {
      "type": "string",
      "description": "Field external ID"
    },
    "externalIds": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Entry external IDs"
    }
  }
}

cloudinary_reorder_metadata_fields

Reorder metadata fields.

Args:

order: Array of field external IDs in desired order (required)

{
  "type": "object",
  "required": [
    "order"
  ],
  "properties": {
    "order": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Field external IDs in order"
    }
  }
}

cloudinary_create_metadata_rule

Create a new metadata rule.

Args:

name: Rule name (required)
condition: Condition object defining when the rule applies (required)
result: Result object defining the metadata to apply (required)
state: Rule state - active or inactive (default: active)

{
  "type": "object",
  "required": [
    "name",
    "condition",
    "result"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "Rule name"
    },
    "state": {
      "enum": [
        "active",
        "inactive"
      ],
      "type": "string",
      "description": "Rule state"
    },
    "result": {
      "type": "object",
      "description": "Result object"
    },
    "condition": {
      "type": "object",
      "description": "Condition object"
    }
  }
}

cloudinary_update_metadata_rule

Update an existing metadata rule.

Args:

ruleId: Rule ID (required)
name: New rule name
condition: New condition object
result: New result object
state: New state (active or inactive)

{
  "type": "object",
  "required": [
    "ruleId"
  ],
  "properties": {
    "name": {
      "type": "string"
    },
    "state": {
      "enum": [
        "active",
        "inactive"
      ],
      "type": "string"
    },
    "result": {
      "type": "object"
    },
    "ruleId": {
      "type": "string",
      "description": "Rule ID"
    },
    "condition": {
      "type": "object"
    }
  }
}

cloudinary_delete_metadata_rule

Delete a metadata rule.

Args:

ruleId: Rule ID to delete (required)

{
  "type": "object",
  "required": [
    "ruleId"
  ],
  "properties": {
    "ruleId": {
      "type": "string",
      "description": "Rule ID"
    }
  }
}

cloudinary_list_upload_presets

List all upload presets in your Cloudinary account.

Upload presets define default upload options that can be applied to uploads.

Args:

maxResults: Number of presets to return (default: 100)
nextCursor: Pagination cursor
format: Response format

{
  "type": "object",
  "properties": {
    "maxResults": {
      "type": "integer",
      "default": 100,
      "maximum": 500,
      "minimum": 1
    },
    "nextCursor": {
      "type": "string"
    }
  }
}

cloudinary_get_upload_preset

Get details of a specific upload preset.

Args:

name: Preset name (required)
format: Response format

{
  "type": "object",
  "required": [
    "name"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "Preset name"
    }
  }
}

cloudinary_create_upload_preset

Create a new upload preset.

Args:

name: Preset name (required)
unsigned: Allow unsigned uploads (default: false)
folder: Default folder for uploads
tags: Default tags (comma-separated)
transformation: Default transformation to apply
format: Default output format
accessMode: Access mode (public or authenticated)
overwrite: Allow overwriting existing resources
useFilename: Use original filename as public ID
uniqueFilename: Append random characters to filename

{
  "type": "object",
  "required": [
    "name"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "Preset name"
    },
    "tags": {
      "type": "string",
      "description": "Default tags (comma-separated)"
    },
    "folder": {
      "type": "string",
      "description": "Default folder"
    },
    "format": {
      "type": "string",
      "description": "Default output format"
    },
    "unsigned": {
      "type": "boolean",
      "description": "Allow unsigned uploads"
    },
    "overwrite": {
      "type": "boolean"
    },
    "accessMode": {
      "enum": [
        "public",
        "authenticated"
      ],
      "type": "string"
    },
    "useFilename": {
      "type": "boolean"
    },
    "transformation": {
      "type": "string",
      "description": "Default transformation"
    },
    "uniqueFilename": {
      "type": "boolean"
    }
  }
}

cloudinary_update_upload_preset

Update an existing upload preset.

Args:

name: Preset name (required)
unsigned: Allow unsigned uploads
folder: Default folder for uploads
tags: Default tags (comma-separated)
transformation: Default transformation to apply
format: Default output format
accessMode: Access mode (public or authenticated)
overwrite: Allow overwriting existing resources
useFilename: Use original filename as public ID
uniqueFilename: Append random characters to filename

{
  "type": "object",
  "required": [
    "name"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "Preset name"
    },
    "tags": {
      "type": "string"
    },
    "folder": {
      "type": "string"
    },
    "format": {
      "type": "string"
    },
    "unsigned": {
      "type": "boolean"
    },
    "overwrite": {
      "type": "boolean"
    },
    "accessMode": {
      "enum": [
        "public",
        "authenticated"
      ],
      "type": "string"
    },
    "useFilename": {
      "type": "boolean"
    },
    "transformation": {
      "type": "string"
    },
    "uniqueFilename": {
      "type": "boolean"
    }
  }
}

cloudinary_delete_upload_preset

Delete an upload preset.

Args:

name: Preset name to delete (required)

{
  "type": "object",
  "required": [
    "name"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "Preset name to delete"
    }
  }
}

cloudinary_list_upload_mappings

List all upload mappings.

Upload mappings define auto-upload rules that map folder paths to remote URLs.

Args:

maxResults: Number of mappings to return (default: 100)
nextCursor: Pagination cursor
format: Response format

{
  "type": "object",
  "properties": {
    "maxResults": {
      "type": "integer",
      "default": 100,
      "maximum": 500,
      "minimum": 1
    },
    "nextCursor": {
      "type": "string"
    }
  }
}

cloudinary_get_upload_mapping

Get details of a specific upload mapping.

Args:

folder: Folder name (required)
format: Response format

{
  "type": "object",
  "required": [
    "folder"
  ],
  "properties": {
    "folder": {
      "type": "string",
      "description": "Folder name"
    }
  }
}

cloudinary_create_upload_mapping

Create a new upload mapping for auto-upload.

Args:

folder: Folder name for the mapping (required)
template: URL template for auto-upload (required)

Example: folder: "external_images" template: "https://example.com/images/"

{
  "type": "object",
  "required": [
    "folder",
    "template"
  ],
  "properties": {
    "folder": {
      "type": "string",
      "description": "Folder name"
    },
    "template": {
      "type": "string",
      "description": "URL template"
    }
  }
}

cloudinary_update_upload_mapping

Update an existing upload mapping.

Args:

folder: Folder name (required)
template: New URL template (required)

{
  "type": "object",
  "required": [
    "folder",
    "template"
  ],
  "properties": {
    "folder": {
      "type": "string",
      "description": "Folder name"
    },
    "template": {
      "type": "string",
      "description": "New URL template"
    }
  }
}

cloudinary_delete_upload_mapping

Delete an upload mapping.

Args:

folder: Folder name to delete (required)

{
  "type": "object",
  "required": [
    "folder"
  ],
  "properties": {
    "folder": {
      "type": "string",
      "description": "Folder name"
    }
  }
}

cloudinary_list_resources_by_ids

Get multiple resources by their public IDs in a single request.

Args:

publicIds: Array of public IDs to retrieve (required)
resourceType: Type of resource - default: image
deliveryType: Delivery type - default: upload
format: Response format

{
  "type": "object",
  "required": [
    "publicIds"
  ],
  "properties": {
    "publicIds": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Public IDs to retrieve"
    }
  }
}

cloudinary_list_resources_by_asset_ids

Get multiple resources by their immutable asset IDs in a single request.

Args:

assetIds: Array of asset IDs to retrieve (required)
format: Response format

{
  "type": "object",
  "required": [
    "assetIds"
  ],
  "properties": {
    "assetIds": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Asset IDs to retrieve"
    }
  }
}

cloudinary_list_resources

List resources (assets) from Cloudinary with pagination.

Returns a paginated list of resources. Use the cursor from the response to fetch the next page.

Args:

resourceType: Type of resource (image, video, raw) - default: image
deliveryType: Delivery type (upload, private, authenticated, etc.) - default: upload
prefix: Filter by public ID prefix
maxResults: Number of resources to return (1-500, default: 20)
nextCursor: Pagination cursor from previous response
tags: Include tags in response
context: Include context metadata in response
moderations: Include moderation status
metadata: Include structured metadata
format: Response format ('json' or 'markdown')

{
  "type": "object",
  "properties": {
    "tags": {
      "type": "boolean",
      "description": "Include tags"
    },
    "prefix": {
      "type": "string",
      "description": "Filter by public ID prefix"
    },
    "context": {
      "type": "boolean",
      "description": "Include context metadata"
    },
    "metadata": {
      "type": "boolean",
      "description": "Include structured metadata"
    },
    "maxResults": {
      "type": "integer",
      "default": 20,
      "maximum": 500,
      "minimum": 1,
      "description": "Number of resources to return"
    },
    "nextCursor": {
      "type": "string",
      "description": "Pagination cursor"
    },
    "moderations": {
      "type": "boolean",
      "description": "Include moderation status"
    }
  }
}

cloudinary_list_resources_by_tag

List resources that have a specific tag.

Args:

tag: The tag to filter by (required)
resourceType: Type of resource (image, video, raw) - default: image
maxResults: Number of resources to return
nextCursor: Pagination cursor
format: Response format

{
  "type": "object",
  "required": [
    "tag"
  ],
  "properties": {
    "tag": {
      "type": "string",
      "description": "Tag to filter by"
    },
    "maxResults": {
      "type": "integer",
      "default": 20,
      "maximum": 500,
      "minimum": 1
    },
    "nextCursor": {
      "type": "string"
    }
  }
}

cloudinary_list_resources_by_context

List resources that have a specific context key/value.

Args:

key: Context key to filter by (required)
value: Context value to filter by (optional)
resourceType: Type of resource - default: image
maxResults: Number of resources to return
nextCursor: Pagination cursor
format: Response format

{
  "type": "object",
  "required": [
    "key"
  ],
  "properties": {
    "key": {
      "type": "string",
      "description": "Context key"
    },
    "value": {
      "type": "string",
      "description": "Context value"
    },
    "maxResults": {
      "type": "integer",
      "default": 20,
      "maximum": 500,
      "minimum": 1
    },
    "nextCursor": {
      "type": "string"
    }
  }
}

cloudinary_list_resources_by_folder

List resources in a specific asset folder.

Args:

folder: Asset folder path (required)
maxResults: Number of resources to return
nextCursor: Pagination cursor
format: Response format

{
  "type": "object",
  "required": [
    "folder"
  ],
  "properties": {
    "folder": {
      "type": "string",
      "description": "Asset folder path"
    },
    "maxResults": {
      "type": "integer",
      "default": 20,
      "maximum": 500,
      "minimum": 1
    },
    "nextCursor": {
      "type": "string"
    }
  }
}

cloudinary_get_resource

Get detailed information about a specific resource by public ID.

Args:

publicId: The public ID of the resource (required)
resourceType: Type of resource (image, video, raw) - default: image
deliveryType: Delivery type - default: upload
format: Response format

{
  "type": "object",
  "required": [
    "publicId"
  ],
  "properties": {
    "publicId": {
      "type": "string",
      "description": "Public ID of the resource"
    }
  }
}

cloudinary_get_resource_by_asset_id

Get detailed information about a specific resource by its immutable asset ID.

Args:

assetId: The asset ID of the resource (required)
format: Response format

{
  "type": "object",
  "required": [
    "assetId"
  ],
  "properties": {
    "assetId": {
      "type": "string",
      "description": "Asset ID of the resource"
    }
  }
}

cloudinary_update_resource

Update a resource's metadata, tags, context, or other attributes.

Args:

publicId: The public ID of the resource (required)
resourceType: Type of resource - default: image
deliveryType: Delivery type - default: upload
tags: Array of tags to set
context: Context metadata object
metadata: Structured metadata object
moderationStatus: Set moderation status (pending, approved, rejected)
assetFolder: Move to a different asset folder
displayName: Set display name

{
  "type": "object",
  "required": [
    "publicId"
  ],
  "properties": {
    "tags": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Tags to set"
    },
    "context": {
      "type": "object",
      "description": "Context metadata"
    },
    "metadata": {
      "type": "object",
      "description": "Structured metadata"
    },
    "publicId": {
      "type": "string",
      "description": "Public ID"
    },
    "assetFolder": {
      "type": "string",
      "description": "Asset folder path"
    },
    "displayName": {
      "type": "string",
      "description": "Display name"
    },
    "moderationStatus": {
      "enum": [
        "pending",
        "approved",
        "rejected"
      ],
      "type": "string"
    }
  }
}

cloudinary_delete_resources

Delete one or more resources by their public IDs.

Args:

publicIds: Array of public IDs to delete (required)
resourceType: Type of resource - default: image
deliveryType: Delivery type - default: upload

{
  "type": "object",
  "required": [
    "publicIds"
  ],
  "properties": {
    "publicIds": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Public IDs to delete"
    }
  }
}

cloudinary_delete_resources_by_prefix

Delete all resources with a specific public ID prefix.

WARNING: This can delete many resources at once.

Args:

prefix: Public ID prefix to match (required)
resourceType: Type of resource - default: image
deliveryType: Delivery type - default: upload

{
  "type": "object",
  "required": [
    "prefix"
  ],
  "properties": {
    "prefix": {
      "type": "string",
      "description": "Public ID prefix"
    }
  }
}

cloudinary_delete_resources_by_tag

Delete all resources with a specific tag.

WARNING: This can delete many resources at once.

Args:

tag: Tag to match (required)
resourceType: Type of resource - default: image

{
  "type": "object",
  "required": [
    "tag"
  ],
  "properties": {
    "tag": {
      "type": "string",
      "description": "Tag to match"
    }
  }
}

cloudinary_restore_resources

Restore backed-up resources that were deleted.

Args:

publicIds: Array of public IDs to restore (required)
resourceType: Type of resource - default: image
deliveryType: Delivery type - default: upload

{
  "type": "object",
  "required": [
    "publicIds"
  ],
  "properties": {
    "publicIds": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Public IDs to restore"
    }
  }
}

cloudinary_list_resources_by_moderation

List resources by their moderation status.

Args:

kind: Moderation kind (e.g., 'aws_rek', 'manual', 'webpurify') (required)
status: Moderation status - pending, approved, or rejected (required)
resourceType: Type of resource - default: image
maxResults: Number of resources to return
nextCursor: Pagination cursor
format: Response format

{
  "type": "object",
  "required": [
    "kind",
    "status"
  ],
  "properties": {
    "kind": {
      "type": "string",
      "description": "Moderation kind"
    },
    "status": {
      "enum": [
        "pending",
        "approved",
        "rejected"
      ],
      "type": "string",
      "description": "Moderation status"
    },
    "maxResults": {
      "type": "integer",
      "default": 20,
      "maximum": 500,
      "minimum": 1
    },
    "nextCursor": {
      "type": "string"
    }
  }
}

cloudinary_add_related_assets

Add related assets to a resource.

Args:

publicId: The public ID of the primary resource (required)
assetsToRelate: Array of asset IDs to relate (required)
resourceType: Type of resource - default: image
deliveryType: Delivery type - default: upload

{
  "type": "object",
  "required": [
    "publicId",
    "assetsToRelate"
  ],
  "properties": {
    "publicId": {
      "type": "string",
      "description": "Public ID of primary resource"
    },
    "assetsToRelate": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Asset IDs to relate"
    }
  }
}

cloudinary_delete_related_assets

Remove related assets from a resource.

Args:

publicId: The public ID of the primary resource (required)
assetsToUnrelate: Array of asset IDs to unrelate (required)
resourceType: Type of resource - default: image
deliveryType: Delivery type - default: upload

{
  "type": "object",
  "required": [
    "publicId",
    "assetsToUnrelate"
  ],
  "properties": {
    "publicId": {
      "type": "string",
      "description": "Public ID of primary resource"
    },
    "assetsToUnrelate": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Asset IDs to unrelate"
    }
  }
}

cloudinary_search

Search for resources using Cloudinary's powerful search API with Lucene-like query syntax.

Examples of search expressions:

"folder:products" - resources in products folder
"tags:sale AND format:jpg" - JPG images with 'sale' tag
"uploaded_at>[2024-01-01]" - uploaded after Jan 1, 2024
"width>1000 AND height>1000" - large images
"resource_type:video AND duration>60" - videos longer than 60 seconds
"context.category:electronics" - resources with specific context
"faces>0" - images with detected faces

Args:

expression: Search expression in Lucene-like syntax (required)
maxResults: Number of results to return (1-500, default: 20)
nextCursor: Pagination cursor from previous response
sortBy: Array of sort fields with direction (e.g., [{"field": "created_at", "direction": "desc"}])
aggregate: Fields to aggregate (e.g., ["format", "resource_type"])
withField: Additional fields to include (e.g., ["tags", "context"])
format: Response format ('json' or 'markdown')

{
  "type": "object",
  "required": [
    "expression"
  ],
  "properties": {
    "aggregate": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Fields to aggregate"
    },
    "withField": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Additional fields to include"
    },
    "expression": {
      "type": "string",
      "description": "Search expression"
    },
    "maxResults": {
      "type": "integer",
      "default": 20,
      "maximum": 500,
      "minimum": 1,
      "description": "Number of results"
    },
    "nextCursor": {
      "type": "string",
      "description": "Pagination cursor"
    }
  }
}

cloudinary_visual_search

Search for visually similar resources using image URL, asset ID, or text description.

Requires Visual Search add-on to be enabled.

Args:

imageUrl: URL of image to search for similar images
imageAssetId: Asset ID of image to search for similar images
text: Text description to search for matching images
format: Response format

Note: Provide exactly one of imageUrl, imageAssetId, or text.

{
  "type": "object",
  "properties": {
    "text": {
      "type": "string",
      "description": "Text description"
    },
    "imageUrl": {
      "type": "string",
      "description": "Image URL"
    },
    "imageAssetId": {
      "type": "string",
      "description": "Image asset ID"
    }
  }
}

cloudinary_list_tags

List all tags used in your Cloudinary account.

Args:

resourceType: Type of resource (image, video, raw) - default: image
prefix: Filter tags by prefix
maxResults: Number of tags to return
nextCursor: Pagination cursor
format: Response format

{
  "type": "object",
  "properties": {
    "prefix": {
      "type": "string",
      "description": "Tag prefix filter"
    },
    "maxResults": {
      "type": "integer",
      "default": 100,
      "maximum": 500,
      "minimum": 1
    },
    "nextCursor": {
      "type": "string"
    }
  }
}

cloudinary_list_streaming_profiles

List all streaming profiles in your Cloudinary account.

Streaming profiles define video encoding settings for adaptive bitrate streaming (HLS/DASH).

Args:

format: Response format

{
  "type": "object",
  "properties": {}
}

cloudinary_get_streaming_profile

Get details of a specific streaming profile.

Args:

name: Profile name (required)
format: Response format

{
  "type": "object",
  "required": [
    "name"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "Profile name"
    }
  }
}

cloudinary_create_streaming_profile

Create a new streaming profile.

Args:

name: Profile name (required)
displayName: Display name for the profile
representations: Array of representation objects with transformation settings (required)

Example representations: [ { "transformation": { "width": 1920, "height": 1080, "bit_rate": "5000k" } }, { "transformation": { "width": 1280, "height": 720, "bit_rate": "2500k" } }, { "transformation": { "width": 854, "height": 480, "bit_rate": "1000k" } } ]

{
  "type": "object",
  "required": [
    "name"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "Profile name"
    },
    "displayName": {
      "type": "string",
      "description": "Display name"
    }
  }
}

cloudinary_update_streaming_profile

Update an existing streaming profile.

Args:

name: Profile name (required)
displayName: New display name
representations: New representation settings

{
  "type": "object",
  "required": [
    "name"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "Profile name"
    },
    "displayName": {
      "type": "string"
    }
  }
}

cloudinary_delete_streaming_profile

Delete a streaming profile.

Args:

name: Profile name to delete (required)

Note: Predefined profiles cannot be deleted.

{
  "type": "object",
  "required": [
    "name"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "Profile name"
    }
  }
}

cloudinary_list_transformations

List all transformations in your Cloudinary account.

Args:

named: Filter to only named transformations (default: false)
maxResults: Number of transformations to return (default: 100)
nextCursor: Pagination cursor
format: Response format

{
  "type": "object",
  "properties": {
    "named": {
      "type": "boolean",
      "description": "Filter to named transformations only"
    },
    "maxResults": {
      "type": "integer",
      "default": 100,
      "maximum": 500,
      "minimum": 1
    },
    "nextCursor": {
      "type": "string"
    }
  }
}

cloudinary_get_transformation

Get details of a specific transformation.

Args:

name: Transformation name or string (required)
format: Response format

{
  "type": "object",
  "required": [
    "name"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "Transformation name or string"
    }
  }
}

cloudinary_create_transformation

Create a new named transformation.

Args:

name: Name for the transformation (required)
transformation: Transformation string (required)

Example: name: "thumbnail" transformation: "c_thumb,w_150,h_150,g_face"

{
  "type": "object",
  "required": [
    "name",
    "transformation"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "Transformation name"
    },
    "transformation": {
      "type": "string",
      "description": "Transformation string"
    }
  }
}

cloudinary_update_transformation

Update an existing transformation.

Args:

name: Transformation name or string (required)
allowedForStrict: Whether to allow for strict transformations
unsafeUpdate: New transformation string (use with caution)

{
  "type": "object",
  "required": [
    "name"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "Transformation name"
    },
    "unsafeUpdate": {
      "type": "string",
      "description": "New transformation string"
    },
    "allowedForStrict": {
      "type": "boolean",
      "description": "Allow for strict transformations"
    }
  }
}

cloudinary_delete_transformation

Delete a transformation.

Args:

name: Transformation name or string to delete (required)

Note: Only transformations that are not in use can be deleted.

{
  "type": "object",
  "required": [
    "name"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "Transformation name to delete"
    }
  }
}

cloudinary_delete_derived_resources

Delete derived (transformed) versions of resources by their IDs.

Args:

derivedResourceIds: Array of derived resource IDs to delete (required)

{
  "type": "object",
  "required": [
    "derivedResourceIds"
  ],
  "properties": {
    "derivedResourceIds": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Derived resource IDs"
    }
  }
}

cloudinary_delete_derived_by_transformation

Delete derived resources for specific transformations.

Args:

publicIds: Array of public IDs (required)
transformations: Array of transformation strings to delete (required)
resourceType: Type of resource - default: image
deliveryType: Delivery type - default: upload

{
  "type": "object",
  "required": [
    "publicIds",
    "transformations"
  ],
  "properties": {
    "publicIds": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Public IDs"
    },
    "deliveryType": {
      "enum": [
        "upload",
        "private",
        "authenticated"
      ],
      "type": "string"
    },
    "resourceType": {
      "enum": [
        "image",
        "video",
        "raw"
      ],
      "type": "string",
      "default": "image"
    },
    "transformations": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Transformations to delete"
    }
  }
}