How to Use the Cloudinary MCP in Mastra AI

Q: How do I register the Cloudinary MCP Server tools in Mastra AI?

Initialize the client using new MCPClient and point it to your Vinkius endpoint. Then, call listTools() and spread the resulting tools directly into your Mastra AI agent configuration.

Q: Can a Mastra AI agent automatically delete old Cloudinary assets?

Yes, by combining getmediaresourcedetails and deletemediaresource in a Mastra workflow. The agent can check the creation date of an asset and delete it if it exceeds your storage policy limits.

Q: Can I require manual approval before Mastra AI modifies Cloudinary presets?

Yes, you can configure requireToolApproval for sensitive actions. This ensures your Mastra AI agent won't execute changes to your upload configurations without explicit human consent.

Run automated Cloudinary media workflows and conditional transformations with Mastra AI agents.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Cloudinary MCP to Mastra AI

Create your Vinkius account to connect Cloudinary to Mastra AI and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup Cloudinary with Mastra AI

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Automated Media Optimization Workflows

`list_media_transformations` lets your Mastra AI agent evaluate how your assets are formatted. The agent inspects your available Cloudinary image sizes and automatically applies the correct named transformation based on your workflow rules. If a transformation fails, Mastra's built-in retry engine with exponential backoff triggers a fallback. This ensures your Cloudinary media processing pipeline never stalls, even during heavy traffic spikes or API rate limits.

Conditional Asset Cleanup and Management

`delete_media_resource` and `get_media_resource_details` allow your Mastra AI agent to run scheduled cleanup routines using this MCP Server. The agent checks the details of specific Cloudinary assets and deletes them if they violate your retention policies. You can implement human-in-the-loop validation using Mastra's `requireToolApproval` setting. This stops the Mastra AI agent from executing `delete_media_resource` until a team member confirms the action in your admin panel.

Dynamic Tagging and Preset Audits via MCP Server

`list_media_tags` and `list_upload_presets` give your Mastra AI workflows complete visibility into how media is organized. The Mastra AI agent scans your Cloudinary account to find untagged files or outdated upload settings. Once the agent identifies a discrepancy, it branches the Mastra AI workflow to trigger an alert or apply a correct preset. This keeps your Cloudinary asset library clean without manual auditing.

Setup guide

Set up Cloudinary MCP in Mastra AI

Prerequisites

Node.js 18+ and a TypeScript project
@mastra/mcp + @mastra/core packages
Active Vinkius subscription with a valid endpoint token

1

Install dependencies
Run npm install @mastra/mcp @mastra/core plus your preferred model provider (e.g. @ai-sdk/openai).
2

Configure the MCPClient
Create an MCPClient with your Vinkius endpoint as a URL object. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com.
3

Discover and inject tools
Call mcpClient.listTools() and spread the result into your agent's tools object. All Cloudinary tools become native Mastra tools.
4

Run with any model
Swap openai("gpt-4o") for any AI SDK-compatible provider. Call agent.generate() and the agent routes tool calls through MCP automatically.

agent.ts

import { MCPClient } from "@mastra/mcp";
import { Agent } from "@mastra/core/agent";
import { openai } from "@ai-sdk/openai";

const mcpClient = new MCPClient({
  id: "cloudinary-mcp-client",
  servers: {
    "cloudinary-mcp": {
      url: new URL(
        "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
      ),
    },
  },
});

const agent = new Agent({
  name: "Cloudinary Agent",
  model: openai("gpt-4o"),
  instructions: "You have access to Cloudinary tools.",
  tools: {
    ...(await mcpClient.listTools()),
  },
});

const result = await agent.generate(
  "List recent Cloudinary transactions"
);
console.log(result.text);

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Cloudinary. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect Cloudinary now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about Cloudinary MCP in Mastra AI

Initialize the client using `new MCPClient` and point it to your Vinkius endpoint. Then, call `listTools()` and spread the resulting tools directly into your Mastra AI agent configuration.

Yes, by combining `get_media_resource_details` and `delete_media_resource` in a Mastra workflow. The agent can check the creation date of an asset and delete it if it exceeds your storage policy limits.

Mastra AI uses its built-in workflow engine to queue requests. If a tool like `search_media_library` hits a Cloudinary API limit, Mastra automatically retries the call with exponential backoff.

Yes, you can configure `requireToolApproval` for sensitive actions. This ensures your Mastra AI agent won't execute changes to your upload configurations without explicit human consent.

Absolutely. The server only handles your Cloudinary asset tags, transformation profiles, and storage reports. Vinkius runs the server in an ephemeral, isolated V8 sandbox, which means your credentials and media metadata are destroyed the moment the execution finishes.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript