How to Use the Uploadcare MCP in Claude Code

Q: How do I audit my Uploadcare usage with Claude Code?

Use the getprojectinfo tool. It returns project-level metadata, giving you the exact metrics needed for auditing purposes within your terminal scripts.

Q: Can I copy files from Uploadcare using Claude Code?

Yes, the copyfile action allows you to write a script that moves an existing asset between local or remote storage paths. This is great for setting up reproducible build environments.

Q: Is it safe to list assets with Uploadcare using Claude Code?

Yes, listfiles and listfilegroups are read-only operations that simply generate a manifest of existing files or groups. They don't change anything.

Q: What kind of data does this MCP Server touch regarding Uploadcare?

This server manages file assets, technical metadata (getfiledetails), and project-level usage statistics. It allows Claude Code to script interactions with your entire media infrastructure on Uploadcare.

Run complex asset management scripts from the terminal with Claude Code.

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 Claude Code

Create your Vinkius account to connect Uploadcare to Claude Code 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 Claude Code

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Project Reporting via MCP Server

To create automated usage reports, run `get_project_info` to retrieve project-level metadata and current statistics. This is ideal for CI/CD pipelines that need to check resource limits. This lets your shell script output a clean JSON payload containing the necessary metrics without any GUI overhead.

Mass File Management with Claude Code

Cleanup tasks are simple: `batch_delete_files` permanently removes multiple assets, making it perfect for scheduled cron jobs. Just pipe a list of IDs to the tool. Alternatively, you can use `list_file_groups` to identify collections that need bulk removal before executing a script.

Asset Inventory with Claude Code

Need a full file manifest? Use `list_files` in conjunction with pagination handling. This provides the core data set for any scripted workflow. If you only care about logical containers, `list_file_groups` gives you an immediate list of all immutable groups to check.

Setup guide

Set up Uploadcare MCP in Claude Code

Prerequisites

Claude Code CLI installed (npm install -g @anthropic-ai/claude-code)
Active Vinkius subscription with a valid endpoint token

1

Run the add command

Open your terminal and run the command shown on the right. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com. Use --scope user to make it available across all projects.
2

Verify the connection

Start a Claude Code session and type /mcp to list connected servers. You should see uploadcare-mcp with a green status indicator.
3

Start using tools

Ask Claude Code something like "Check my latest Uploadcare transactions." It will automatically discover and invoke the available Uploadcare tools.

Terminal

claude mcp add --transport http uploadcare-mcp https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp

Get your connection token →

Prerequisites

Claude Code CLI installed
Active Vinkius subscription with a valid endpoint token

1

Open the config file

Create or edit .mcp.json in your project root for project-level scope, or ~/.claude.json for user-level scope.
2

Add the Uploadcare MCP

Paste the JSON snippet shown on the right into the mcpServers object. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Restart Claude Code

Start a new Claude Code session. Type /mcp to confirm the server is connected. The tools will be automatically available in your conversation.

.mcp.json

{
  "mcpServers": {
    "uploadcare-mcp": {
      "type": "url",
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

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 Claude Code

Use the `get_project_info` tool. It returns project-level metadata, giving you the exact metrics needed for auditing purposes within your terminal scripts.

Yes, the `copy_file` action allows you to write a script that moves an existing asset between local or remote storage paths. This is great for setting up reproducible build environments.

The action irreversibly removes multiple files in a single operation, which is highly efficient for cleanup scripts. Always validate the IDs before running this command.

Yes, `list_files` and `list_file_groups` are read-only operations that simply generate a manifest of existing files or groups. They don't change anything.

This server manages file assets, technical metadata (`get_file_details`), and project-level usage statistics. It allows Claude Code to script interactions with your entire media infrastructure on Uploadcare.

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