How to Use the Uploadcare MCP in Pydantic AI

Q: How do I check usage stats with Uploadcare and Pydantic AI?

Use getprojectinfo to pull project-level metadata and current usage statistics. This lets your agent track how much of the media infrastructure is being used.

Q: Can the Pydantic AI framework handle batch deletion from Uploadcare?

Yes, the batchdeletefiles tool permanently removes multiple files at once. Because this action is irreversible, validation on inputs is critical.

Q: Does Pydantic AI support listing all files in Uploadcare?

It does. The listfiles tool supports pagination via a limit parameter, enabling the agent to retrieve every file stored within the project safely.

Q: If I need group info for Uploadcare and Pydantic AI, what tools do I use?

Use getgroupdetails to get specifics on a single group. For an index of all available collections, call listfilegroups.

Validate media assets with your Pydantic AI agent.

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 Pydantic AI

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Safe File Lifecycle Management

The `delete_file` tool permanently removes a single file and all its variants. This action is irreversible, so the agent must confirm deletion before execution. Similarly, `batch_delete_files` allows for mass removal of media assets, giving your agent control over large cleanups.

Asset Copying and Storage

The `copy_file` tool duplicates an existing file to local or remote storage. This is vital when different downstream services need the same asset copy. If you want to make a temporary upload permanent, use `store_file`. It marks the asset as fully committed to Uploadcare.

Inspecting Project Health

The `get_project_info` tool pulls project-level metadata and usage stats. Your agent uses this to maintain visibility into resource health. For directory structure, the `list_file_groups` tool lists all immutable file collections (groups) available in your Uploadcare account.

Setup guide

Set up Uploadcare MCP in Pydantic AI

Prerequisites

Python 3.10+ installed
pydantic-ai-slim[fastmcp] package
Active Vinkius subscription with a valid endpoint token

1

Install Pydantic AI with FastMCP
Run pip install "pydantic-ai-slim[fastmcp]". The FastMCP toolset replaces the deprecated MCPServerHTTP class with full protocol support.
2

Configure the FastMCPToolset
Pass a JSON-style config dict to FastMCPToolset with your Vinkius URL. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com. Supports Streamable HTTP, SSE, and Stdio transports.
3

Create and run your agent
Pass the toolset to Agent(toolsets=[toolset]) and call agent.run(). Swap openai:gpt-4o for any supported model — Anthropic, Google, Mistral, or Groq.

agent.py

from pydantic_ai import Agent
from pydantic_ai.toolsets.fastmcp import FastMCPToolset

toolset = FastMCPToolset({
    "mcpServers": {
        "uploadcare-mcp": {
            "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
        }
    }
})

agent = Agent(
    "openai:gpt-4o",
    toolsets=[toolset],
    system_prompt="You have access to Uploadcare tools.",
)

result = await agent.run("List recent Uploadcare transactions")
print(result.output)

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 Pydantic AI

Use `get_project_info` to pull project-level metadata and current usage statistics. This lets your agent track how much of the media infrastructure is being used.

Yes, the `batch_delete_files` tool permanently removes multiple files at once. Because this action is irreversible, validation on inputs is critical.

The server handles file metadata, group structure information, and project usage statistics. Specifically, it manages technical metadata retrieved by `get_file_details`.

It does. The `list_files` tool supports pagination via a limit parameter, enabling the agent to retrieve every file stored within the project safely.

Use `get_group_details` to get specifics on a single group. For an index of all available collections, call `list_file_groups`.

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