Prototype · Preview: every server in the official registry, synced every 30 minutes. Sign in with Google to write reviews.Prototype · updated every 30 min
PopNx MCPMCP servers for people who use AI · explained in plain words

Cloudinary Asset Management

✓ service owner · cloudinary.com✓ In Claude’s connector directory

by cloudinaryversion 0.11.8i★ 0iComputer or cloudOfficial site ↗
Registry namecom.cloudinary/asset-management-mcp

How to install

What it does

Upload, generate, organize, search, and transform images, videos, and files with AI-powered tools.

  • Connects Computer or cloud
  • Account or key Cloud: Needs cloudinary-cloud-name, cloudinary-api-key, cloudinary-api-secret · Local: Needs CLOUDINARY_API_KEY, CLOUDINARY_API_SECRET · 1 setting to fill in (CLOUDINARY_CLOUD_NAME)
  • Category Design, images & audio

Use together with

Skills that teach the AI this kind of work; they work alongside this one

impeccable

The design vocabulary for your coding agent. Steer with polish and bolder, review with critique and audit, catch AI slop before it ships.

by pbakaus★ 112,5441 skills

Skill · How-to guide

diagram-design

Editorial diagram design for Claude Code, Codex, GitHub Copilot, Cursor, Factory Droid, Qoder, and Pi. 45 diagram types. Self-contained HTML + SVG. No shadows. No Mermaid slop.

by cathrynlavery★ 68,0691 skills

Skill · How-to guide

frontend-slides

Create beautiful slides on the web using a coding agent's frontend skills

by zarazhangrui★ 32,5141 skills

Skill · How-to guide

Why it ranks here

This one is in the “Apps that connect to AI” tab, which is ordered without stars, in this order

1. In Claude’s connector directoryYesdirectory popularity 15,302
2. Tried by our teamNo
3. Works for Thai usersNo
4. Usage without stars42/100Popularity 22 · Freshness 12 · Still answering 8 · Likes from users +0
5. Listed on2026-11-15

Likes from users: 0 · Adds at most 5 points to the order (1 per person). It cannot be bought.

Quality: Passed 5/5 basic checks (shown, not used for ordering)

Install

Pick the AI app you use, then copy the settings.

Let your AI install it with one sentence

Please install Cloudinary Asset Management. Follow https://mcp.popnx.com/i/cloudinary-asset-management-mcp-1t9ln.md, show me the commands and wait for my OK before running them.

Paste it into an AI that can work on your computer (such as Claude Code or Cursor). It reads our steps, shows you the commands and waits for your OK. No key, no sign-up. · See the full text your AI reads

Passed 5/5 checks · What you ask goes through the maker’s server (asset-management.mcp.cloudinary.com) · ✓ Commands checked Nov 15, 2026

First: which AI do you use?

Pick your app and the steps appear below.

Install it in the Claude app, no setup needed

Cloudinary is in the list Claude curates. Use the button below to add it · checked Nov 16, 2026

  1. Open the Cloudinary page in Claude

    Opens on claude.ai · if you are not signed in, the page shows “Sign in to add” first

  2. Click “Connect to Claude”, then sign in to your Cloudinary account if asked

    If you see “Failed to add the connector”, wait a moment and try again, or use another way below

  3. Try it

    Use Cloudinary Asset Management and tell me what you can do for me, then show me one thing

    ✓ If Claude says it is using Cloudinary Asset Management or shows a Cloudinary Asset Management tool in the answer, you are connected

Link won’t open? Use the menu instead
  1. Open Claude on the web (claude.ai) or the Claude Desktop app

  2. Click “Customize” in the left sidebar

    Customize

  3. Choose the “Connectors” tab, then click the “+” button next to Connectors

    CustomizeConnectors+

  4. Type “Cloudinary” in the search box or scroll the list, then click it

  5. Click “Connect” (some say “Install”)

  6. Sign in to that service if asked

  7. Turn it on in a chat: click “+” at the lower left of the chat box → “Connectors” → switch on Cloudinary

Menu names are in English, as on Claude’s screen

Menu names checked against Anthropic’s help page on Nov 13, 2026 · your screen may differ slightly by app version

Other way: add it yourself by URL (custom connector)

Works with Claude · about 5 min

You need a Cloudinary Asset Management key (create it on the maker’s site) · Set it up once on claude.ai or the desktop app, then use it in chat · free accounts can add 1 · on Team/Enterprise an Owner adds it

  1. Sign up and create a Cloudinary Asset Management key

    Open the maker’s site, sign up and create an API key for the next step. Check the maker’s site for pricing and free plans.

    Open the Cloudinary Asset Management site ↗

  2. Open Claude’s Connectors page

    CustomizeConnectors

    CustomizeConnectors1Add2https://…3Add4
  3. Click “Add” → “Custom” → “Web” and fill in these 2 fields

    Copy each value into the field with the same name in Claude, then click Continue

    Name · NameCloudinary Asset Management
    Remote MCP server URL · Addresshttps://asset-management.mcp.cloudinary.com/mcp

    Under Request headers, add this name and value

    Header namecloudinary-cloud-name
    Value<paste your key here>
    Header namecloudinary-api-key
    Value<paste your key here>
    Header namecloudinary-api-secret
    Value<paste your key here>

    Paste the key only into the app’s field, never into a chat or to anyone

    Click Continue past the sign-in settings Claude detected · under Authentication choose what the maker says (Sign in now, Sign in when needed or No sign in), then click Add

  4. Turn it on in a chat

    +ConnectorsCloudinary Asset Management

  5. Try it

    Use Cloudinary Asset Management and tell me what you can do for me, then show me one thing

    ✓ If Claude says it is using Cloudinary Asset Management or shows a Cloudinary Asset Management tool in the answer, you are connected

Menu names checked against Anthropic’s help page on Nov 11, 2026 · your screen may differ slightly by app version

ChatGPT cannot connect Cloudinary Asset Management yet

Cloudinary Asset Management needs your own key to connect, but OpenAI’s help page only describes OAuth sign-in; there is no key option we could verify

What you can do instead

A · Use an app that can connect Cloudinary Asset Management

  • You need a Cloudinary Asset Management key (create it on the maker’s site) · Set it up once on claude.ai or the desktop app, then use it in chat · free accounts can add 1 · on Team/Enterprise an Owner adds it
  • You need a Cloudinary Asset Management key (create it on the maker’s site)
  • You need a Cloudinary Asset Management key (create it on the maker’s site)
  • You need a Cloudinary Asset Management key (create it on the maker’s site)

B · Others in Design, images & audio that work with ChatGPT

Picked from the most used in the same category, only ones that connect by address with no key

Works with Claude Code · about 5 min

You need a Cloudinary Asset Management key (create it on the maker’s site)

  1. Sign up and create a Cloudinary Asset Management key

    Open the maker’s site, sign up and create an API key for the next step. Check the maker’s site for pricing and free plans.

    Open the Cloudinary Asset Management site ↗

  2. Open Terminal

    Mac: press Command+Space and type Terminal · Windows: open PowerShell

  3. Paste this command and press Enter

    claude mcp add --transport http --scope user asset-management https://asset-management.mcp.cloudinary.com/mcp --header 'cloudinary-cloud-name: your-value' --header 'cloudinary-api-key: your-value' --header 'cloudinary-api-secret: your-value'

    Replace “your-value” with your key before pressing Enter

    Paste the key only into the app’s field, never into a chat or to anyone

  4. Type /mcp in Claude Code

    You should see Cloudinary Asset Management listed as connected

  5. Try it

    Use Cloudinary Asset Management and tell me what you can do for me, then show me one thing

    ✓ If Claude Code says it is using Cloudinary Asset Management or shows a Cloudinary Asset Management tool in the answer, you are connected

Menu names checked against Anthropic’s help page on Nov 11, 2026 · your screen may differ slightly by app version

Works with Cursor · about 5 min

You need a Cloudinary Asset Management key (create it on the maker’s site)

  1. Sign up and create a Cloudinary Asset Management key

    Open the maker’s site, sign up and create an API key for the next step. Check the maker’s site for pricing and free plans.

    Open the Cloudinary Asset Management site ↗

  2. Click this button to open Cursor

    Open in Cursor

    Cursor asks you to confirm; click Install

  3. Fill in your key

    In the Cloudinary Asset Management settings, cloudinary-cloud-name, cloudinary-api-key, cloudinary-api-secret is empty; add your key and save

    Paste the key only into the app’s field, never into a chat or to anyone

  4. Open the AI chat in Cursor in Agent mode

  5. Try it

    Use Cloudinary Asset Management and tell me what you can do for me, then show me one thing

    ✓ If Cursor says it is using Cloudinary Asset Management or shows a Cloudinary Asset Management tool in the answer, you are connected

Menu names checked against Cursor’s help page on Nov 11, 2026 · your screen may differ slightly by app version

Works with VS Code · about 5 min

You need a Cloudinary Asset Management key (create it on the maker’s site)

  1. Sign up and create a Cloudinary Asset Management key

    Open the maker’s site, sign up and create an API key for the next step. Check the maker’s site for pricing and free plans.

    Open the Cloudinary Asset Management site ↗

  2. Click this button to open VS Code

    Open in VS Code

    VS Code asks you to confirm; click Install

  3. Fill in your key

    In the Cloudinary Asset Management settings, cloudinary-cloud-name, cloudinary-api-key, cloudinary-api-secret is empty; add your key and save

    Paste the key only into the app’s field, never into a chat or to anyone

  4. Open the AI chat in VS Code in Agent mode

  5. Try it

    Use Cloudinary Asset Management and tell me what you can do for me, then show me one thing

    ✓ If VS Code says it is using Cloudinary Asset Management or shows a Cloudinary Asset Management tool in the answer, you are connected

Menu names checked against VS Code’s help page on Nov 11, 2026 · your screen may differ slightly by app version

Other apps that use MCP, such as Windsurf, Zed or Gemini CLI, each add servers differently. See how in the app list.

See every app that uses MCP →

Address for apps that connect over the web

Addresshttps://asset-management.mcp.cloudinary.com/mcp

JSON settings are under “For developers” below

Stuck? Ask people who use Cloudinary Asset Management💬 Discussion →
For developers: Terminal commands and JSON settings

Over the web

Claude Code

claude mcp add --transport http --scope user asset-management https://asset-management.mcp.cloudinary.com/mcp --header 'cloudinary-cloud-name: your-value' --header 'cloudinary-api-key: your-value' --header 'cloudinary-api-secret: your-value'

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "asset-management": {
      "url": "https://asset-management.mcp.cloudinary.com/mcp",
      "headers": {
        "cloudinary-cloud-name": "your-value",
        "cloudinary-api-key": "your-value",
        "cloudinary-api-secret": "your-value"
      }
    }
  }
}

VS Code (mcp.json)

{
  "servers": {
    "asset-management": {
      "type": "http",
      "url": "https://asset-management.mcp.cloudinary.com/mcp",
      "headers": {
        "cloudinary-cloud-name": "your-value",
        "cloudinary-api-key": "your-value",
        "cloudinary-api-secret": "your-value"
      }
    }
  }
}

Installed on your computer

Claude Code

claude mcp add --scope user asset-management --env CLOUDINARY_CLOUD_NAME=your-value --env CLOUDINARY_API_KEY=your-value --env CLOUDINARY_API_SECRET=your-value -- npx -y @cloudinary/asset-management-mcp

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "asset-management": {
      "command": "npx",
      "args": [
        "-y",
        "@cloudinary/asset-management-mcp"
      ],
      "env": {
        "CLOUDINARY_CLOUD_NAME": "your-value",
        "CLOUDINARY_API_KEY": "your-value",
        "CLOUDINARY_API_SECRET": "your-value"
      }
    }
  }
}

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "asset-management": {
      "command": "npx",
      "args": [
        "-y",
        "@cloudinary/asset-management-mcp"
      ],
      "env": {
        "CLOUDINARY_CLOUD_NAME": "your-value",
        "CLOUDINARY_API_KEY": "your-value",
        "CLOUDINARY_API_SECRET": "your-value"
      }
    }
  }
}

VS Code (mcp.json)

{
  "servers": {
    "asset-management": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@cloudinary/asset-management-mcp"
      ],
      "env": {
        "CLOUDINARY_CLOUD_NAME": "your-value",
        "CLOUDINARY_API_KEY": "your-value",
        "CLOUDINARY_API_SECRET": "your-value"
      }
    }
  }
}

Values you fill in

  • CLOUDINARY_CLOUD_NAME required env
    Your Cloudinary cloud name. Find it in your Cloudinary Dashboard.
  • CLOUDINARY_API_KEY secret required env
    Your Cloudinary API key. Found in Dashboard > Settings > Access Keys.
  • CLOUDINARY_API_SECRET secret required env
    Your Cloudinary API secret. Found in Dashboard > Settings > Access Keys.
  • cloudinary-cloud-name HTTP header
    Your Cloudinary cloud name. Find it in your Cloudinary Dashboard.
  • cloudinary-api-key HTTP header
    Your Cloudinary API key. Found in Dashboard > Settings > Access Keys.
  • cloudinary-api-secret secret HTTP header
    Your Cloudinary API secret. Found in Dashboard > Settings > Access Keys.

Descriptions are as written by the maker.

These settings are generated from the maker’s registry entry. If the README says otherwise, follow the README.

At a glance

Downloads per weeki
968/wk
Verified domain
✓ cloudinary.com
Connection
Computer or cloud
Transport
stdio, streamable-http
Latest versioni
0.11.8
Published to registryi
Nov 15, 2026
Code last changedi
Nov 18, 2026
Last checked
Nov 18, 2026
Maker
cloudinary
Packages
npm: @cloudinary/asset-management-mcp
oci: docker.io/cloudinary/asset-management-mcp:0.11.8
Registry status
Active

Which apps can use it

Based on how this server connects and on each app’s own docs, checked Nov 10, 2026.

Connect over the internet in

ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatOpen WebUIRaycast

Run on your computer in

ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast

All apps, with pros and cons →

Related guides

What it can do

The server asks you to sign in before it lists its tools.

Basic checksi

We check information anyone can see; we have not read the code. Checks that do not apply are left out of the count. · Checked Nov 19, 2026

  • ✓ Pass

    Maker matches the repo

    The registry name was verified against the domain cloudinary.com (the registry checks domain ownership)

  • ✓ Pass

    Still maintained

    Code last changed yesterday

  • ✓ Pass

    Has a licence

    Uses MIT

  • ✓ Pass

    Endpoint responds

    Responded in 87 ms (HTTP 401)

  • ✓ Pass

    Sign-in with OAuth

    Declares OAuth sign-in, so your AI app can take you to log in

  • … Not checked yet

    No hidden instructions in tool descriptions

    Not checked yet; we read the tool list when we check the endpoint

Published vulnerabilities (OSV.dev)

Not checked yet

What we check → · JSON

Makers: ask for a re-check or report wrong info
For makers: add a badge to your README

If you made this, paste this code into your README. The badge links back to this page.

[![Featured on PopNx MCP](https://mcp.popnx.com/badge/cloudinary-asset-management-mcp-1t9ln.svg)](https://mcp.popnx.com/en/servers/cloudinary-asset-management-mcp-1t9ln)

Discussion

Ask, share a tip or report that it does not work. Sorted by what people marked helpful.

No posts yet. Be the first to ask or share.

Posts here are written by users, not the PopNx team.

Sign in to post

User reviews

No reviews yet

Sign in to write a review

Compared with others in Design, images & audioi

  • More stars than 0% of the other 3275 servers in this category
  • Published to the registry more recently than 90% of the other 3275 servers in this category
  • Basic checks equal to or better than 99% of the other 3275 servers in this category

Compared with every active server in this category in the registry. Stars count only when the publisher owns the repo.

Common questions

Is Cloudinary Asset Management safe?

It passed 5 of 5 applicable basic checks. We have not read the code. Before adding a key or token, see what access the server asks for and use a key with only the permissions you need.

What keys or codes does it need?

You need to fill in: cloudinary-cloud-name, cloudinary-api-key, cloudinary-api-secret, CLOUDINARY_API_KEY, CLOUDINARY_API_SECRET

Does it run on my computer or in the cloud?

Either way works: install it on your computer or connect to the cloud version.

Is it still maintained?

The GitHub repo last changed yesterday, and the latest version (0.11.8) reached the registry 4 days ago.

Which apps can use it?

Apps that support MCP, such as Claude Desktop, Claude Code, Cursor and VS Code. It connects by URL, so apps that accept remote MCP servers work too, such as ChatGPT on the web (full MCP on Business and above; Pro read-only).

What can I use instead?

In the same category: HyperFrames by HeyGen, Pascal 3D Editor, draw.io, Figma MCP Server, Remocn: Remotion MCP server

Similar alternatives

Same category, other makers, commands already checked. Official ones first, then by stars.

Reading a card:↓ Downloads per weeki★ GitHub starsiThree pillars: reviews · checks · usageiUpdated = latest version published to the registryi

HyperFrames by HeyGen

Official HyperFrames by HeyGen: the best AI video editor in chat. Captions, motion graphics, MP4.

by heygen-comWidely used★ 86.4K Stars for the whole repoUpdated yesterday

Runs in the cloud✓ heygen.com

Pascal 3D Editor

Create, inspect, validate, and save editable 3D building scenes with Pascal's MCP server.

by pascalorgWidely used↓ 1K/wk★ 25.6K Stars for the whole repoUpdated yesterday

Computer or cloud✓ service owner · pascal.app

draw.io

Create draw.io diagrams in chat from Mermaid or XML, shown live and interactive. 10,000+ shapes.

by jgraphWidely used★ 5.8KUpdated 2 days ago

Runs in the cloud✓ service owner · draw.ioTried by the PopNx team

Figma MCP Server

Figma’s official server gives AI your design data so it can turn designs into code or describe them accurately. Connects to Figma’s cloud.

by figmaWidely used★ 2.2KUpdated 13 months ago

Runs in the cloud✓ service owner · mcp.figma.com
Compared with similar ones
This one
Cloudinary Asset Management
HyperFrames by HeyGenPascal 3D Editordraw.ioFigma MCP ServerRemocn: Remotion MCP server
Runs whereCloud or install on your computerRuns in the cloud, nothing to installCloud or install on your computerRuns in the cloud, nothing to installRuns in the cloud, nothing to installRuns in the cloud, nothing to install
Needs a keyYesNoNoNoNoNo
Add with + in ClaudeYesYesNoNoYesNo
Basic checks5/54/45/54/44/44/4
LicenseMITApache-2.0MITApache-2.0–MIT
PriceNo cost listed in the registryNo cost listed in the registryNo cost listed in the registryNo cost listed in the registryNo cost listed in the registryNo cost listed in the registry

README from the maker

Open the README

Copied from the maker’s repo as written. PopNx MCP has not reviewed or endorsed it. HTML, images and scripts are removed. Links lead off this site.

Cloudinary Asset Management MCP Server

Summary

Table of Contents

  • Cloudinary Asset Management MCP Server
  • Installation
  • Configuration
  • Authentication
  • Available Tools
  • Custom Tools
  • Progressive Discovery
  • Development
  • Building from Source
  • Contributions

Installation

The MCP server requires Node.js 20.19.0 or later.

Claude Desktop

Install the MCP server as a Desktop Extension using the pre-built mcp-server.mcpb file:

Simply drag and drop the 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.

[!NOTE]

MCP bundles provide a streamlined way to package and distribute MCP servers. Learn more about Desktop Extensions.

Cursor

Or manually:

  1. Open Cursor Settings
  2. Select Tools and Integrations
  3. Select New MCP Server
  4. If the configuration file is empty paste the following JSON into the MCP Server Configuration:
{

"command": "npx", "args": [ "@cloudinary/asset-management-mcp", "start", "--api-key", "", "--api-secret", "", "--cloud-name", "" ] }

Claude Code CLI

claude mcp add CloudinaryAssetMgmt -- npx -y @cloudinary/asset-management-mcp start --api-key  --api-secret  --cloud-name 

Gemini

gemini mcp add CloudinaryAssetMgmt -- npx -y @cloudinary/asset-management-mcp start --api-key  --api-secret  --cloud-name 

Windsurf

Refer to Official Windsurf documentation for latest information

  1. Open Windsurf Settings
  2. Select Cascade on left side menu
  3. Click on Manage MCPs. (To Manage MCPs you should be signed in with a Windsurf Account)
  4. Click on View raw config to open up the mcp configuration file.
  5. If the configuration file is empty paste the full json
{

"command": "npx", "args": [ "@cloudinary/asset-management-mcp", "start", "--api-key", "", "--api-secret", "", "--cloud-name", "" ] }

</details>

VS Code

Or manually:

Refer to Official VS Code documentation for latest information

  1. Open Command Palette
  2. Search and open MCP: Open User Configuration. This should open mcp.json file
  3. If the configuration file is empty paste the full json
{

"command": "npx", "args": [ "@cloudinary/asset-management-mcp", "start", "--api-key", "", "--api-secret", "", "--cloud-name", "" ] }

Stdio installation via npm To start the MCP server, run:

npx @cloudinary/asset-management-mcp start --api-key  --api-secret  --cloud-name 

For a full list of server arguments, run:

npx @cloudinary/asset-management-mcp --help

Configuration

Environment Variables

The MCP server supports the following environment variables:

VariableDescriptionRequired
CLOUDINARY_CLOUD_NAMEYour Cloudinary cloud nameYes
CLOUDINARY_API_KEYYour Cloudinary API keyYes
CLOUDINARY_API_SECRETYour Cloudinary API secretYes
CLOUDINARY_URLComplete Cloudinary URL (alternative to individual vars)No
CLOUDINARY_COLLECT_HEADERSCollect API response headers (see below)No
CLOUDINARY_MCP_APPSOverride MCP Apps default (see MCP Apps)No
CLOUDINARY_URL Format

You can use a single CLOUDINARY_URL instead of individual variables:

CLOUDINARY_URL=cloudinary://API_KEY:API_SECRET@CLOUD_NAME
Response Header Collection

You can configure the server to include Cloudinary API response headers (such as x-request-id and rate limit info) in tool output. This is useful for debugging and monitoring.

Set CLOUDINARY_COLLECT_HEADERS to control which headers are collected:

# Collect all response headers

CLOUDINARY_COLLECT_HEADERS=true

Collect specific headers by exact name (comma-separated)

CLOUDINARY_COLLECT_HEADERS=x-request-id,x-featureratelimit-limit,x-featureratelimit-remaining

Mix exact names, prefix matching, and regex matching

CLOUDINARY_COLLECT_HEADERS=x-request-id,prefix:x-featureratelimit-

Header matching specs

Each entry in the comma-separated list is matched against response header names:

FormatExampleBehaviour
exact namex-request-idmatches only x-request-id
prefix: prefix:x-featureratelimit-matches any header starting with x-featureratelimit-
regex: regex:ratelimitmatches any header whose name contains ratelimit

You can also set this via the CLOUDINARY_URL query parameter:

CLOUDINARY_URL=cloudinary://API_KEY:API_SECRET@CLOUD_NAME?collect_headers=true

When enabled, collected headers appear in an _headers field in the tool response. When not set, no headers are collected and responses are unchanged.

MCP Apps

The server can expose interactive MCP UI Apps (spec-aligned with io.modelcontextprotocol/ui) that hosts can render alongside tool results — for example, an asset gallery for list results, a single-asset detail view, and an upload UI.

Apps are enabled by default. Use the --mcp-apps flag (available on both start and serve) or the CLOUDINARY_MCP_APPS environment variable to override this behaviour:

ValueEffect
unsetDefault — all apps enabled
bare --mcp-apps (no value), all, or trueEnable every app (same as default)
none or falseDisable every app (kill-switch)
comma-separated subset, e.g. asset-gallery,asset-detailsEnable only the listed apps

Available app names: asset-gallery, asset-details, asset-upload.

# Disable all apps

npx @cloudinary/asset-management-mcp serve --mcp-apps none

Enable only the gallery

npx @cloudinary/asset-management-mcp start --mcp-apps asset-gallery

Disable via env var

CLOUDINARY_MCP_APPS=none npx @cloudinary/asset-management-mcp start

Precedence: CLI flag > environment variable > built-in default.

Authentication

The MCP server uses your Cloudinary API key and secret for authentication:

{

"env": { "CLOUDINARY_CLOUD_NAME": "demo", "CLOUDINARY_API_KEY": "123456789012345", "CLOUDINARY_API_SECRET": "abcdefghijklmnopqrstuvwxyz12" } }

Available Tools

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, transforming, and generating your media assets.

  • Assets: upload, inspect, update, rename, and delete images, videos, and raw files
  • Tags and metadata: tag assets, set contextual and structured metadata, and relate assets to each other
  • Search: find assets by tags, folder, format, metadata, and dates, or by visual similarity
  • Folders: create, move, and delete folders in the media library
  • Transformations: create and remove derived versions: resize, crop, change format, apply effects
  • Image generation: create an image from a text prompt, or edit and combine existing images with a prompt
  • Video generation (Beta): animate an image from your account into a short video with a prompt
  • Collections: group assets into collections without moving them, and share a collection on a public page
  • Archives and usage: package assets as ZIP or TGZ files, and check account usage
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'"
  1. Transform it: "Transform asset 'hero-image' with transformations 'c_fill,w_800,h_600/e_sharpen'"
  2. Get details: "Show me details for asset with ID [asset-id]"
Example 2: Generate and Edit Images
1. Generate an image: "Generate a product shot of a white sneaker on a pastel background and save it to my 'campaigns' folder"
  1. Edit it: "Using [asset-id] as the reference, replace the background with a city street at night"
  2. Check a long-running job: "What's the status of generation task [task-id]?"
Example 3: Generate a Video from an Image
1. Pick the source image: "Find the image with public ID 'sneaker-hero'"
  1. Start the job: "Turn asset [asset-id] into an 8-second 16:9 video of the camera slowly orbiting the sneaker"
  2. Get the result: "Check video generation job [job-id] and give me the video URL when it's done"
Example 4: Search and Organize Assets
1. Search for images: "Find all images with tag 'product' uploaded in the last 7 days"
  1. Create folder: "Create a new folder called 'summer-2024-products'"
  2. List assets: "Show me all video assets in the 'marketing' folder"
Example 5: Build and Share a Collection
1. Create it: "Create a collection called 'Spring launch'"
  1. Add assets: "Add all images tagged 'spring-2026' to the 'Spring launch' collection"
  2. Share it: "Publish the 'Spring launch' collection and give me the public page link"
Example 6: Asset Management Workflow
1. Upload multiple files: "Upload all images from folder /assets/new-products/"
  1. Add tags: "Update asset [asset-id] and add tags 'featured,homepage'"
  2. Get usage stats: "Show my Cloudinary account usage statistics"
Example 7: Generate Archive
1. Get transformation docs: "Show me the Cloudinary transformation reference"
  1. Apply transformations: "Transform 'banner' asset with 'c_scale,w_1200/f_auto,q_auto'"
  2. Create archive: "Generate a ZIP archive of all images with tag 'export-ready'"

Custom Tools

This MCP server includes two powerful custom tools:

get-tx-reference

Retrieves the complete Cloudinary transformation reference documentation.

When to use:

  • Before creating or modifying transformations
  • When user asks about image/video effects, resiz

Only the beginning is shown; read the rest in the repo