How to Use the Uploadcare MCP in Mastra AI

Q: How does the Mastra AI framework handle Uploadcare file operations?

The MCP Server exposes tools like getfiledetails and listfiles. Your workflow can now check asset metadata or pull an inventory list before deciding on its next step. This adds massive reliability.

Q: If a file copy fails, how do I manage the state in Uploadcare with Mastra AI?

You use copyfile within your workflow steps. If it fails, you can build retry logic around that step. The server provides clear data on what assets exist and where they've been copied.

Q: Can I list all files in Uploadcare using the Mastra AI client?

Absolutely. Call listfiles to get a paginated record of every file. This information is essential for running full audits or checking if necessary assets are present before deployment.

Q: How do I confirm successful deletion in Uploadcare with Mastra AI?

You run deletefile for permanent removal. The system confirms the action, allowing your workflow to move on, knowing that asset is gone and cannot be accidentally used.

Build reliable multi-step workflows using Mastra AI and Uploadcare media management.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Uploadcare MCP to Mastra AI

Create your Vinkius account to connect Uploadcare 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 Uploadcare with Mastra AI

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Managing Media Assets in Complex Workflows

The `copy_file` tool lets your workflow copy an existing file to local or remote storage, which is critical for building multi-step processes. You're not just running a single action; you're moving data reliably between states. Need to mark assets as permanent? Use `batch_store_files`. This ensures that temporary files are marked as stored and ready for future steps in your workflow.

Deep File System Inspection with the MCP Server

Use `get_file_details` to pull technical data on any specific Uploadcare file. Your agent can check dimensions, formats, or other metadata before proceeding with a conditional step. If you need an inventory check, run `list_files`. This retrieves all files in your project and supports pagination so you don't miss anything.

Cleaning Up Media Infrastructure

When a workflow fails or completes, cleanup is necessary. You can use `delete_file` to permanently remove an asset and its variants. This action is irreversible, so define your retry logic carefully. For large cleanups, `batch_delete_files` lets you wipe out multiple files in one operation, making failure handling much cleaner.

Setup guide

Set up Uploadcare 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 Uploadcare 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: "uploadcare-mcp-client",
  servers: {
    "uploadcare-mcp": {
      url: new URL(
        "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
      ),
    },
  },
});

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

const result = await agent.generate(
  "List recent Uploadcare 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 Uploadcare. 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 Uploadcare 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 Uploadcare MCP in Mastra AI

The MCP Server exposes tools like `get_file_details` and `list_files`. Your workflow can now check asset metadata or pull an inventory list before deciding on its next step. This adds massive reliability.

You use `copy_file` within your workflow steps. If it fails, you can build retry logic around that step. The server provides clear data on what assets exist and where they've been copied.

Absolutely. Call `list_files` to get a paginated record of every file. This information is essential for running full audits or checking if necessary assets are present before deployment.

The server manages file metadata, project usage statistics, and asset group details. It lets you read technical information on every media piece.

You run `delete_file` for permanent removal. The system confirms the action, allowing your workflow to move on, knowing that asset is gone and cannot be accidentally used.

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