Cloudinary MCP for AI Agents

Securely connect your AI agents and chatbots (Claude, ChatGPT, Cursor, etc) with Cloudinary MCP or direct API to upload media, search and retrieve assets, generate optimized image transformations, and manage folders through natural language.

Cloudinary logoCloudinary
Api Key

Cloudinary is a cloud-based platform for managing, uploading, and transforming images and videos. It streamlines media workflows and delivers optimized assets globally.

108 Tools

Try Cloudinary now

Type what you want done — sign in and watch it run live in the Tool Router playground.

TOOL ROUTER PLAYGROUND
Cloudinary
Try asking
TOOLS

Supported Tools

Every Cloudinary action and event your agent gets out of the box.

Activate Live Stream

Tool to manually activate a Cloudinary live stream.

Create Asset Relations by Asset ID

Tool to add related assets by asset ID.

Create Asset Relations by Public ID

Tool to create relations between assets by public ID.

Create Folder

Tool to create a new asset folder.

Create Image from Text

Tool to create an image from text using Cloudinary's text generation API.

Create Live Stream

Tool to create a new live stream in Cloudinary.

Create Live Stream Output

Tool to create a new live stream output configuration.

Create Metadata Field

Tool to create a new metadata field definition.

Create Metadata Rule

Tool to create a new conditional metadata rule.

Create Multi-Resource Animation

Tool to create an animated image, video, or PDF from a set of images.

Create Slideshow

Tool to create an auto-generated video slideshow from existing Cloudinary assets.

Create Streaming Profile

Tool to create a new adaptive streaming profile in your Cloudinary account.

Create Transformation

Tool to create a new named transformation by assigning a custom name to a set of transformation parameters.

Create Trigger

Tool to create a new webhook trigger for a specified event type.

Create Upload Mapping

Tool to create a new upload mapping folder and URL template.

Create Upload Preset

Tool to create a new upload preset.

Delete Asset Relations by Asset ID

Tool to delete asset relations by asset ID.

Delete Asset Relations by Public ID

Tool to delete asset relations by public ID.

Delete Derived Resources

Tool to delete derived assets.

Delete Metadata Field Datasource Entries

Tool to delete datasource entries for a specified metadata field.

Delete Folder

Tool to delete an empty asset folder.

Delete Live Stream

Tool to delete a live stream from Cloudinary.

Delete Live Stream Output

Tool to delete a live stream output from Cloudinary.

Delete Metadata Field

Tool to delete a metadata field by external ID.

Delete Metadata Rule

Tool to delete a conditional metadata rule by its ID.

Delete Resources by Asset ID

Tool to delete resources by asset IDs.

Delete Resources by Public ID

Tool to delete Cloudinary resources by public ID, prefix, or all resources.

Delete Resources by Tags

Tool to delete Cloudinary assets by tag.

Delete Streaming Profile

Tool to delete a custom streaming profile or revert a built-in profile to original settings.

Delete Transformation (v2)

Tool to delete a named transformation from your Cloudinary account.

Delete Trigger

Tool to delete a trigger (webhook notification).

Delete Upload Mapping

Tool to delete a folder upload mapping.

Delete Upload Preset

Tool to delete an upload preset from the account.

Destroy Asset

Tool to permanently destroy a Cloudinary asset/resource by public ID.

Destroy Asset by ID

Tool to delete an asset by its immutable asset ID.

Explicit Resource Update

Tool to update an existing asset and/or eagerly generate derived transformations using Cloudinary's Explicit API.

Explode Multi-Page Resource

Tool to create derived images from multi-page files (PDF, PSD, TIFF, animated GIF) by exploding them into separate images.

Generate Archive

Tool to create an archive (ZIP or TGZ file) containing a set of assets from your Cloudinary environment.

Get Adaptive Streaming Profiles

Tool to list adaptive streaming profiles.

Get Analysis Task Status

Tool to get the status of an analysis task.

Get product environment config details

Tool to get product environment config details.

Get Live Stream

Tool to get details of a single live stream by ID.

Get Live Stream Output

Tool to get details of a single live stream output.

Get Live Stream Outputs

Tool to get a list of live stream outputs.

Get Live Streams

Tool to get a list of live streams from Cloudinary.

Get Metadata Field By ID

Tool to get a single metadata field definition by external ID.

Get Resource by Asset ID

Get Resource by Asset ID

Get Resource by Public ID

Tool to get details of a single resource by public ID.

Get Resources by Asset Folder

Tool to list assets stored directly in a specified folder.

Get Resources by Context

Tool to retrieve assets with a specified contextual metadata key/value.

Get Resources in Moderation

Tool to retrieve assets in a moderation queue by status.

Get Root Folders

Tool to list all root folders in the product environment.

Get Streaming Profile Details

Tool to get details of a single streaming profile by name.

Get Resource Tags

Tool to list all tags used for a specified resource type.

Get Transformation

Tool to retrieve details of a specific transformation.

Get Transformations

Tool to list all transformations (named and unnamed).

List Webhook Triggers

Tool to list all webhook triggers for event types in your environment.

Get Upload Mapping Details

Tool to retrieve details of a single upload mapping by folder.

Get Upload Mappings

Tool to list all upload mappings.

Get Upload Preset

Tool to retrieve details of a single upload preset by name.

Get Usage

Tool to get product environment usage details.

Get Video Views

Tool to get video analytics views from Cloudinary.

Idle Live Stream

Tool to manually idle a Cloudinary live stream.

List Images

Tool to list image assets from Cloudinary.

List Metadata Fields

Tool to list all structured metadata fields defined in your Cloudinary product environment.

List Metadata Rules

Tool to retrieve all conditional metadata rules defined in your Cloudinary account.

List Raw Files

Tool to list raw assets from Cloudinary.

List Resources by Asset IDs

Tool to retrieve multiple resources by their asset IDs.

List Resources by External IDs

Tool to retrieve resources by their external IDs.

List Resources by Tag

Tool to list resources (assets) with a specified tag.

List Resources by Type

Tool to retrieve resources (assets) by resource type and storage type.

List Resource Types

Tool to list all available resource types in your Cloudinary product environment.

List Upload Presets

Tool to list all upload presets configured in the account.

List Video Assets

Tool to list video assets from Cloudinary.

Manage Context Metadata

Tool to add or remove contextual metadata on Cloudinary assets.

Order Metadata Field Datasource

Tool to update ordering of a metadata field datasource.

Ping Cloudinary Servers

Tool to ping Cloudinary servers.

Publish Resources

Tool to publish Cloudinary assets by public IDs, prefix, or tag.

Rename or Move Resource Public ID

Tool to rename an asset's public ID using Cloudinary's rename endpoint.

Reorder Metadata Field

Tool to change the position of a specific metadata field.

Reorder Metadata Fields

Tool to reorder all metadata fields in the product environment.

Restore Metadata Field Datasource Entries

Tool to restore previously deleted datasource entries for a metadata field.

Restore Deleted Resources

Tool to restore deleted Cloudinary resources by public IDs.

Restore Resources by Asset IDs

Tool to restore backed up assets by asset IDs.

Search Assets

Tool to search and filter assets using powerful query expressions.

Search Datasource in Metadata Field

Tool to search datasource values in a metadata field.

Search Folders

Tool to search asset folders with filtering, sorting, and pagination.

Search All Metadata Field Datasources

Tool to search across all metadata field datasources.

Visual Search Assets

Tool to find images in your asset library based on visual similarity or content.

Show Folder

Tool to list sub-folders within a specified folder.

Update Asset Metadata

Tool to populate or update metadata field values on one or more Cloudinary assets.

Update Folder

Tool to rename or move an existing asset folder.

Update Live Stream

Tool to update a live stream's configuration in Cloudinary.

Update Live Stream Output

Tool to modify an existing live stream output configuration.

Update Metadata Field

Tool to update a metadata field definition by external ID.

Update Metadata Field Datasource

Tool to update the datasource (allowed values) for a metadata field.

Update Metadata Rule

Tool to update an existing conditional metadata rule.

Update Resource by Asset ID

Tool to update asset properties by asset ID in Cloudinary.

Update Resource by Public ID

Tool to update asset properties by public ID in Cloudinary.

Update Resource Tags

Tool to add, remove, replace, or remove all tags for one or more Cloudinary assets.

Update Streaming Profile

Tool to modify an existing adaptive streaming profile's configuration.

Update Transformation (v2)

Tool to update the definition of an existing named transformation.

Update Trigger

Tool to update the callback URL of an existing webhook trigger.

Update Upload Mapping

Tool to update an existing upload mapping by changing its remote URL template.

Update Upload Preset

Tool to update an existing upload preset's configuration settings.

Upload Asset

Tool to upload media assets (images, videos, raw files) to Cloudinary.

Upload File Chunk

Tool to upload a single chunk of a large file to Cloudinary.

Upload File (Auto Detect)

Tool to upload files with automatic resource type detection.

SETUP GUIDE

Connect Cloudinary MCP Tool with your Agent

1

Install Composio

typescript
npm install @composio/core ai @ai-sdk/openai @ai-sdk/mcp
Install the Composio SDK and Claude Agent SDK
2

Create Tool Router Session

typescript
import { Composio } from '@composio/core';

const composio = new Composio({ apiKey: 'your-api-key' });

console.log("Creating Tool Router session...");
const { mcp } = await composio.create('your-user-id');
console.log(`Tool Router session created: ${mcp.url}`);
Initialize the Composio client and create a Tool Router session
3

Connect to AI Agent

typescript
import { openai } from '@ai-sdk/openai';
import { experimental_createMCPClient as createMCPClient } from '@ai-sdk/mcp';
import { generateText, stepCountIs } from 'ai';

const client = await createMCPClient({
  transport: {
    type: 'http',
    url: mcp.url,
    headers: { 'x-api-key': 'your-composio-api-key' }
  }
});

const tools = await client.tools();

const { text } = await generateText({
  model: openai('gpt-4o'),
  tools,
  messages: [{ role: 'user', content: 'Create a new folder named marketing-assets in Cloudinary' }],
  stopWhen: stepCountIs(5)
});

console.log(`Agent: ${text}`);
Use the MCP server with your AI agent
SETUP GUIDE

Connect Cloudinary API Tool with your Agent

1

Install Composio

typescript
npm install @composio/openai
Install the Composio SDK
2

Initialize Composio and Create Tool Router Session

typescript
import OpenAI from 'openai';
import { Composio } from '@composio/core';
import { OpenAIResponsesProvider } from '@composio/openai';

const composio = new Composio({
  provider: new OpenAIResponsesProvider(),
});
const openai = new OpenAI({});
const session = await composio.create('your-user-id');
Import and initialize Composio client, then create a Tool Router session
3

Execute Cloudinary Tools via Tool Router with Your Agent

typescript
const tools = session.tools;
const response = await openai.responses.create({
  model: 'gpt-4.1',
  tools: tools,
  input: [{
    role: 'user',
    content: 'Create a new folder called "2024-campaign-assets" in Cloudinary.'
  }],
});
const result = await composio.provider.handleToolCalls(
  'your-user-id',
  response.output
);
console.log(result);
Get tools from Tool Router session and execute Cloudinary actions with your Agent

Why Use Composio?

AI Native Cloudinary Integration

  • Supports both Cloudinary MCP and direct API based integrations
  • Structured, LLM-friendly schemas for reliable tool execution
  • Rich coverage for uploading, searching, and transforming your Cloudinary media

Managed Auth

  • Built-in API key handling with secure storage and rotation
  • Central place to manage, scope, and revoke Cloudinary access
  • Per user and per environment credentials instead of hard-coded keys

Agent Optimized Design

  • Tools are tuned using real error and success rates to improve reliability over time
  • Comprehensive execution logs so you always know what ran, when, and on whose behalf

Enterprise Grade Security

  • Fine-grained RBAC so you control which agents and users can access Cloudinary
  • Scoped, least privilege access to Cloudinary resources
  • Full audit trail of agent actions to support review and compliance
FAQ

Frequently asked questions

Yes, Cloudinary requires you to configure your own API key credentials. Once set up, Composio handles secure credential storage and API request handling for you.

Yes! Composio's Tool Router enables agents to use multiple toolkits. Learn more.

Composio is SOC 2 and ISO 27001 compliant with all data encrypted in transit and at rest. Learn more.

Composio maintains and updates all toolkit integrations automatically, so your agents always work with the latest API versions.

Start with Cloudinary.It takes 30 seconds.

Managed auth, hosted MCP servers, and every Cloudinary tool your agent needs.Free to start.

Start building