• DATA
  • INFO
  • LISTS
  • HUMAN

How to find and retrieve media assets with your AI

Connect Cloudinary to your AI client to turn your media library into a searchable database. You can find files using plain English instead of digging through folders.

Ask AI about this page

Short answer

How can I find and pull media files using my AI?

You describe the file you need, and your agent searches your Cloudinary library to find it. You'll get the specific metadata or secure URLs you need to use those assets immediately.

The results.

Where your media search ends up.

The AI handles the heavy lifting of searching and fetching, leaving you with the exact data you requested.

DATA

Direct asset links

The AI finds the exact secure URL for a video or image. You get the link ready for use in your project.

INFO

Detailed metadata

Your agent pulls technical details like file size, format, or dimensions. This helps you confirm the asset fits your needs.

LISTS

Filtered asset groups

The AI can group files based on your description. You get a clean list of all matching media in your library.

HUMAN

Manual asset management

The AI cannot delete or move files in Cloudinary. You still handle all organization and file deletions yourself.

The workflow

What your AI does when you ask for media.

The AI translates your request into specific API calls to your Cloudinary account.

  1. Locating files

    The AI scans your library to find files that match your description, such as specific file types or names.

    search_media_library
  2. Gathering lists

    If you need to see everything in a specific folder or category, the AI pulls a full list of available resources.

    list_media_resources
  3. Extracting details

    Once a file is identified, the AI grabs the specific technical properties or URLs for that single item.

    get_media_resource_details
  4. Presenting results

    The AI formats the found URLs or metadata into a readable response for you to copy or use.

    get_media_resource_details

Try it

Copy these to start.

Use these prompts to begin interacting with your Cloudinary library.

Starting points

These are basic ideas. Swap out the descriptions for your actual file names or folder paths.

Cloudinary Connector

You're all set. Choose your MCP client and follow the setup instructions.

Connector linkhttps://edge.vinkius.com/vk_preview_ZRSREGbQLTnwmcuw9jzVUe0JoZAoAIAIqg1Tf4nY/mcp

Claude Desktop

Follow the steps below to connect in seconds.

  1. 1In Claude Desktop, open Settings → Connectors.
  2. 2Click “Add custom connector” and paste the connector link above as the remote MCP server URL.
  3. 3Click Add and start a new chat — Cloudinary capabilities are ready to use.
Configuration · claude_desktop_config.jsonCopy
{
  "mcpServers": {
    "cloudinary-mcp": {
      "url": "https://edge.vinkius.com/vk_preview_ZRSREGbQLTnwmcuw9jzVUe0JoZAoAIAIqg1Tf4nY/mcp"
    }
  }
}
Copy into chat04
  • Find the secure URL for the logo image in my production folder.

  • List all the video files currently stored in my assets library.

  • Get the metadata for the hero banner image to check its dimensions.

  • Search for any PNG files that have 'icon' in their name.

  • Claude
  • ChatGPT
  • Cursor
  • VS Code
  • Windsurf
  • Claude Code
  • JetBrains
  • Cline

Start here

Connect Cloudinary once, then ask.

Just link your account once. Your credentials stay encrypted and secure, and you can immediately start chatting with your media library.

Connect Cloudinary to your AI

FAQ

How the media search behaves.

  • 01

    Can the AI delete images from my Cloudinary account?

    No. The AI can only find and read information about your media. It cannot delete or modify your files.

  • 02

    Can I use natural language to find files?

    Yes. You can describe what you are looking for in plain English, and the AI will search your library for matches.

  • 03

    Will the AI give me the direct links to my videos?

    Yes. The AI can retrieve secure URLs for your media assets so you can use them in your applications.

  • 04

    Can the AI rename my files for me?

    No. The AI does not have the capability to change file names or move files between folders.

  • 05

    Does the AI see all my Cloudinary data?

    The AI only accesses the specific media resources it needs to answer your search or detail requests.

  • More questions about Cloudinary? See everything the Cloudinary Connector can do

Connect Cloudinary to Claude, Cursor, ChatGPT & more