Cloudinary

listing.by

Upload, search, organize and transform images, videos and files in your Cloudinary media library, and generate images with AI.

state.auth.long (state.auth.title)Streamable HTTP

listing.connect

listing.explain.oauth

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

listing.note.oauth

listing.share.h

listing.share.p

mcp.tc/i/cloudinary

listing.about

Connects to the asset management API of a Cloudinary product environment. You can upload assets from local paths, URLs or data URIs, list and search images, videos and raw files, manage tags, context and structured metadata, organize folders, apply transformations, and generate images from text or reference images.

Runs as a hosted streamable HTTP endpoint with OAuth sign-in by default. Header authentication also works with a cloudinary-url header or the cloudinary-cloud-name, cloudinary-api-key and cloudinary-api-secret headers. A local npm package, @cloudinary/asset-management-mcp, is available and needs the same credentials as environment variables.

listing.can

  • Upload images, videos and raw files from paths, URLs or data URIs
  • Search assets with queries or by visual similarity
  • Add, remove or replace tags and metadata on many assets
  • Create, move and delete folders in the media library
  • Apply transformations to existing assets
  • Generate images from text prompts or reference images
  • Create ZIP or TGZ archives of assets
  • Check account usage and credits

listing.tools 29

  • upload-asset

    Upload images, videos or raw files from file paths, URLs or base64 data URIs.

  • asset-rename

    Change an asset's public ID and optionally other metadata.

  • generate-archive

    Create a ZIP or TGZ archive containing a set of assets.

  • download-asset-backup

    Download a backup copy of an asset.

  • delete-asset

    Delete an asset by its asset ID.

  • list-images

    List image assets, filtered by tags, prefix or public IDs.

  • list-videos

    List video assets, filtered by tags, prefix or public IDs.

  • list-files

    List raw assets, filtered by tags, prefix or public IDs.

  • get-asset-details

    Return the details of one asset by asset ID.

  • asset-update

    Update an asset's metadata, tags and other attributes by asset ID.

  • list-tags

    List tags applied to assets of a given type.

  • delete-derived-assets

    Delete derived resources by derived resource ID.

listing.tools_more
  • manage-asset-tags

    Add, remove or replace tags on multiple assets by public ID.

  • manage-asset-context

    Add or clear contextual metadata on multiple assets.

  • manage-asset-metadata

    Set structured metadata values on multiple assets.

  • get-usage-details

    Report storage, credits, bandwidth, requests and add-on usage.

  • create-asset-relations

    Relate an asset to other assets by asset ID.

  • delete-asset-relations

    Remove relations between an asset and other assets.

  • move-folder

    Rename or move a folder with all its assets.

  • create-folder

    Create a new empty folder at a given path.

  • delete-folder

    Delete a folder and the assets within it.

  • search-folders

    Find folders matching a search expression.

  • search-assets

    Search assets with a Lucene-like query over attributes, dates and metadata.

  • visual-search-assets

    Find images by visual similarity to a URL, asset ID or text description.

  • generate-image

    Generate an image from a text prompt using AI models.

  • generate-image-from-images

    Generate or edit an image guided by reference images and a prompt.

  • get-generation-task

    Get the status of an image generation task.

  • get-tx-reference

    Fetch Cloudinary transformation documentation before building transformations.

  • transform-asset

    Create derived transformations of existing assets using eager transformations.

listing.prov.mcpb_on

listing.prompts

  • Upload this local image to Cloudinary and tag it summer-campaign

  • Find all videos tagged product-demo uploaded this month

  • Generate an image of a red bicycle on a beach and check the task status

  • Show my Cloudinary storage and bandwidth usage

listing.setup.h

listing.setup.oauth

Claude Code

  1. Run this in a terminal, in your project folder:
claude mcp add --transport http cloudinary https://asset-management.mcp.cloudinary.com/mcp
  1. Start Claude Code, type /mcp, pick cloudinary and choose Authenticate. A browser window opens for the Cloudinary sign-in.

Add --scope user to make it available in every project, not just this one.

Claude Desktop

  1. Open Settings → Connectors and click Add custom connector.
  2. Name it Cloudinary and paste this URL:
https://asset-management.mcp.cloudinary.com/mcp
  1. Click Add, then Connect, and sign in when Cloudinary asks.

Claude Desktop's JSON config file only starts local servers. Remote servers go through Connectors, and connectors you add on claude.ai show up here too.

claude.ai

  1. Open the connector form on claude.ai. This button fills in the name and URL for you:
  1. Check that the URL reads https://asset-management.mcp.cloudinary.com/mcp and click Add.
  2. Click Connect and sign in when Cloudinary asks.

Free plans allow one custom connector. On Team and Enterprise plans an owner adds it under Organization settings → Connectors.

ChatGPT

  1. On chatgpt.com, open Settings → Security and login and turn on Developer mode.
  2. Go to chatgpt.com/plugins and click + to create an app for a remote MCP server.
  3. Paste https://asset-management.mcp.cloudinary.com/mcp as the server URL and choose OAuth. ChatGPT sends you to Cloudinary to sign in.

Developer mode is available on the web for Plus, Pro, Business, Enterprise and Education accounts.

Cursor

Or add it by hand to ~/.cursor/mcp.json (all projects) or .cursor/mcp.json (this project):

mcp.json
{
  "mcpServers": {
    "cloudinary": {
      "url": "https://asset-management.mcp.cloudinary.com/mcp"
    }
  }
}

Cursor shows Needs login next to the server. Click it to sign in.

VS Code

Or from a terminal:

code --add-mcp '{"name":"cloudinary","type":"http","url":"https://asset-management.mcp.cloudinary.com/mcp"}'

Or commit it to the repo in .vscode/mcp.json:

.vscode/mcp.json
{
  "servers": {
    "cloudinary": {
      "type": "http",
      "url": "https://asset-management.mcp.cloudinary.com/mcp"
    }
  }
}

VS Code asks you to sign in the first time the server starts.

Devin Desktop

  1. Add it to ~/.config/devin/mcp_config.json (macOS and Linux) or %APPDATA%\devin\mcp_config.json (Windows):
mcp_config.json
{
  "mcpServers": {
    "cloudinary": {
      "serverUrl": "https://asset-management.mcp.cloudinary.com/mcp"
    }
  }
}
  1. Refresh the MCP server list in Cascade and sign in when asked.

Devin Desktop is the new name for Windsurf. It reads serverUrl (or url) for remote servers.

Codex

codex mcp add cloudinary --url https://asset-management.mcp.cloudinary.com/mcp
codex mcp login cloudinary

Or edit ~/.codex/config.toml directly:

config.toml
[mcp_servers.cloudinary]
url = "https://asset-management.mcp.cloudinary.com/mcp"

Gemini CLI

gemini mcp add --transport http cloudinary https://asset-management.mcp.cloudinary.com/mcp

Then, inside Gemini CLI, run /mcp auth cloudinary to sign in.

This adds it to the current project. Add -s user to use it everywhere.

Any client

Most clients accept this shape. Some name the URL field differently: serverUrl in Devin Desktop, httpUrl in Gemini CLI's settings file.

{
  "mcpServers": {
    "cloudinary": {
      "type": "http",
      "url": "https://asset-management.mcp.cloudinary.com/mcp"
    }
  }
}

Zed puts servers under context_servers in its settings. Cline needs "type": "streamableHttp", or it assumes SSE.

Client only starts local servers? Bridge it with npx -y mcp-remote https://asset-management.mcp.cloudinary.com/mcp.

listing.faq

Can I paste mcp.tc/i/cloudinary into my MCP client?

No. mcp.tc links are pages, not server addresses. Connect with https://asset-management.mcp.cloudinary.com/mcp, so your client talks to Cloudinary directly. The sign-in token only works there anyway. The quick link is for sharing: it opens this page, with setup steps for every client.

Does Cloudinary need an API key or a sign-in?

Yes, you need a Cloudinary account. The first time your client connects, it opens Cloudinary's sign-in page. The token goes straight to the server's own URL, never through mcp.tc.

Is Cloudinary a remote or a local server?

Remote. Cloudinary hosts it at https://asset-management.mcp.cloudinary.com/mcp, and it speaks Streamable HTTP. There's nothing to install.

What can Cloudinary do?

It has 29 tools, including upload-asset, asset-rename and generate-archive. You can upload images, videos and raw files from paths, URLs or data URIs, search assets with queries or by visual similarity and add, remove or replace tags and metadata on many assets.

Which clients can use it?

Any client that supports remote MCP servers: Claude Code, Claude Desktop, claude.ai, ChatGPT in developer mode, Cursor, VS Code, Devin Desktop, Codex, Gemini CLI, Zed and others. The setup steps cover each one.

Who wrote this page?

mcp.tc's robot read Cloudinary's own metadata (its MCP handshake, tool list and public pages), and an AI model drafted the text from it. A person reviews anything the checks can't confirm. The text can still be wrong, so if you spot a mistake, use Report this listing on this page.

listing.em.h

listing.em.lead listing.em.how

listing.em.badge

em.prev_lightem.prev_dark
Markdown
[![Cloudinary on mcp.tc](https://mcp.tc/i/cloudinary/badge.svg)](https://mcp.tc/i/cloudinary)
HTML
<a href="https://mcp.tc/i/cloudinary"><img src="https://mcp.tc/i/cloudinary/badge.svg" alt="Cloudinary on mcp.tc" height="20"></a>

listing.em.badge_note

listing.em.widget

HTML
<script src="https://mcp.tc/w/cloudinary.js" async></script>

listing.em.widget_note

iframe

HTML
<iframe src="https://mcp.tc/embed/cloudinary" title="Cloudinary on mcp.tc" width="420" height="200" loading="lazy" allow="clipboard-write" style="border:0;border-radius:8px;max-width:100%"></iframe>

listing.em.iframe_note

JSON

listing.em.json

https://mcp.tc/i/cloudinary.json

listing.em.fields

listing.disclaimer_checked