Cloudinary MCP Server — Hosted Api Connectors Integration
MCP Server language Hosted language PublicUpload, transform, search, and manage images and videos in Cloudinary — AI-native media asset management for any agent.
Use with AI AssistantsMCP
Connect Claude, Cursor, or any MCP-compatible client — then call tools directly
① Add This MCP Server
Paste into your AI client config — then all its tools are available instantly.
{
"mcpServers": {
"cloudinary": {
"url": "https://mcp.aerostack.dev/s/aerostack/mcp-cloudinary",
"headers": {
"Authorization": "Bearer YOUR_AEROSTACK_TOKEN"
}
}
}
}Replace YOUR_AEROSTACK_TOKEN with your API token from the dashboard.
② Call a Tool
Ask your AI assistant to call a specific tool, or send raw JSON-RPC:
Natural Language Prompt
“Use the _ping tool to verify cloudinary connectivity by fetching account usage stats. used internally by aerostack to validate credentials”
Using a Workspace?
Add this MCP to your Workspace — your team shares one token, secrets are stored securely, and every AI agent in the workspace can call it without per-user setup.
description Overview
mcp-cloudinary — Cloudinary Media MCP Server
Upload, transform, search, and manage images and videos in Cloudinary — AI-native media asset management for any agent.
Give your AI agents full access to Cloudinary. Search media assets, upload from URLs, generate transformation URLs for resizing/cropping/effects, browse folders, check usage stats, and manage your media library — all through natural language.
Live endpoint: https://mcp.aerostack.dev/s/aerostack/mcp-cloudinary
What You Can Do
- Search images and videos by expression, tags, folder, or metadata
- Get detailed asset metadata with dimensions, colors, and faces
- Upload images/videos from public URLs with folder/tag assignment
- Generate transformation URLs (resize, crop, blur, format, quality)
- Browse folder structure
- Check account usage (storage, bandwidth, transformations)
- Delete assets by public ID
Available Tools
| Tool | Description |
|---|---|
_ping |
Verify Cloudinary connectivity and show usage stats |
search |
Search assets by expression, tags, folder, metadata |
get_resource |
Get asset metadata — dimensions, colors, faces, tags |
upload_from_url |
Upload an image/video from a public URL |
generate_url |
Create a transformation URL (resize, crop, effects) |
list_folders |
Browse folder structure |
delete_resource |
Delete an asset by public ID |
get_usage |
Account usage — storage, bandwidth, transformations |
Configuration
| Variable | Required | Description | How to Get |
|---|---|---|---|
CLOUDINARY_CLOUD_NAME |
Yes | Your Cloudinary cloud name | console.cloudinary.com → Dashboard → Cloud name (top left) |
CLOUDINARY_API_KEY |
Yes | Cloudinary API Key | console.cloudinary.com → Settings → Access Keys → API Key |
CLOUDINARY_API_SECRET |
Yes | Cloudinary API Secret | console.cloudinary.com → Settings → Access Keys → API Secret |
Quick Start
Add to Aerostack Workspace
- Go to aerostack.dev → Your Project → MCPs
- Search for "Cloudinary" and click Add to Workspace
- Add
CLOUDINARY_CLOUD_NAME,CLOUDINARY_API_KEY, andCLOUDINARY_API_SECRETunder Project → Secrets
Example Prompts
"Search for all JPG images in the products folder"
"Upload this image URL to Cloudinary in the hero-banners folder"
"Generate a 800x600 cropped thumbnail URL for product-123"
"How much storage and bandwidth have I used this month?"
"List all folders in my Cloudinary account"
Direct API Call
curl -X POST https://mcp.aerostack.dev/s/aerostack/mcp-cloudinary \
-H 'Content-Type: application/json' \
-H 'X-Mcp-Secret-CLOUDINARY-CLOUD-NAME: mycloud' \
-H 'X-Mcp-Secret-CLOUDINARY-API-KEY: 123456789' \
-H 'X-Mcp-Secret-CLOUDINARY-API-SECRET: abcdef' \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"search","arguments":{"expression":"folder:products AND format:jpg"}}}'
Security Notes
- Cloudinary credentials are injected at the Aerostack gateway layer — never stored in the worker
- Upload API uses authenticated requests — no unsigned uploads
- Search results are limited to 500 assets per request
- Transformation URLs are public — use signed URLs for private assets
License
MIT
terminal Tools (8)
Available tools on this MCP server. Each tool can be called directly from any AI agent.
_ping #1 Verify Cloudinary connectivity by fetching account usage stats. Used internally by Aerostack to validate credentials.
search #2 Search for images and videos by expression, tags, folder, or metadata — returns public IDs, URLs, format, dimensions, and size
get_resource #3 Get detailed metadata for an image or video — dimensions, format, size, colors, faces, tags, context, and transformation URL
upload_from_url #4 Upload an image or video to Cloudinary from a public URL with optional folder, tags, and transformations
generate_url #5 Generate a Cloudinary delivery URL with transformations applied — resize, crop, format, quality, effects, overlays
list_folders #6 List all root-level folders or subfolders in a Cloudinary account
delete_resource #7 Delete an image or video from Cloudinary by public ID
get_usage #8 Get Cloudinary account usage stats — storage, bandwidth, transformations, API calls used this month
Details
language Live Endpoint
https://mcp.aerostack.dev/s/aerostack/mcp-cloudinary
Sub-50ms globally · Zero cold start
Publisher
Pre-built functions for the most common MCP tool patterns. Clone, extend, and deploy.
More in API Connectors
Browse API Connectors MCPs →Aerostack Registry
by @aerostack
Discover and invoke any MCP, Function, or Skill published to the Aerostack marketplace — the universal AI capability hub.
Algolia
by @aerostack
Search indexes, manage records, browse data, and configure ranking in Algolia — AI-native instant search access.
Arangodb
by @aerostack
Query documents, run AQL, traverse graphs, and manage collections in your ArangoDB database — AI-native multi-model database access.
Ayrshare
by @aerostack
Post, schedule, and analyze social media across 13 platforms — Facebook, Instagram, X, LinkedIn, TikTok, Bluesky, Threads, Reddit, Pinterest, YouTube, Telegram, Snapchat, Google Business.
Basecamp
by @aerostack
Manage projects, to-dos, messages, schedules, and campfire chats in Basecamp — AI-native project management.
Bigquery
by @aerostack
Run SQL queries, list datasets and tables, inspect schemas, and export results from Google BigQuery — AI-native data warehouse access.
Frequently asked questions
What is the Cloudinary MCP server and what can it do? +
The Cloudinary MCP server is hosted on Aerostack and exposes these tools to your AI agent: `_ping`, `search`, `get_resource`, `upload_from_url`, `generate_url`. You get one hosted URL — no self-hosting — that works from Claude, Cursor, ChatGPT, Gemini, VS Code, or any MCP-compatible client, and you can share it with your team or combine it with other MCP servers in a workspace.
Is the Cloudinary MCP server hosted, or do I have to run it myself? +
It's hosted on Aerostack's edge infrastructure — you don't deploy or maintain anything. Add it to a workspace and you get one authenticated URL, with secrets encrypted, that any AI agent or editor can connect to. Use it solo or share the same URL across your whole team.
Which AI agents and editors can use the Cloudinary MCP server? +
Any MCP client: Claude and Claude Code, Cursor, ChatGPT, Gemini, Windsurf, Cline, VS Code, and custom agents. Because it's one hosted URL, the same Cloudinary MCP server works everywhere — and you can compose it with other MCP servers, skills, and functions behind a single workspace URL.
How do I install the Cloudinary MCP server in Claude Desktop? +
Add the following to your Claude Desktop config (`claude_desktop_config.json`): ```json { "mcpServers": { "@aerostack/mcp-cloudinary": { "command": "npx", "args": ["-y", "@aerostack/@aerostack/mcp-cloudinary"] } } } ``` Then restart Claude Desktop and the tools will appear automatically.
How do I use the Cloudinary MCP server in Cursor? +
In Cursor, open **Settings → MCP** and add: ```json { "name": "@aerostack/mcp-cloudinary", "command": "npx", "args": ["-y", "@aerostack/@aerostack/mcp-cloudinary"] } ``` Save and reload Cursor. The MCP tools will be available in Agent mode.
Does Cloudinary MCP require authentication? +
Yes. Cloudinary requires authentication. Check the MCP's documentation for the required credentials.