How to Use the ImageKit (Media Optimization & DAM) MCP in Pydantic AI

Q: Can I run bulk cache purges with ImageKit (Media Optimization & DAM) in Pydantic AI?

Yes. Your agent calls purgecdncache with target paths, and the response structure is verified at runtime. You can then monitor the purge queues using getpurgestatus.

Q: How do I list files in ImageKit (Media Optimization & DAM) using Pydantic AI?

The agent calls listmediafiles to fetch your asset list. Pydantic AI validates the array of file objects, giving your agent a clean, typed list to work with.

Q: How does the server handle custom schemas?

You can use createcustomschema to define custom fields in ImageKit. The agent then uses listcustomfields to fetch the schemas, ensuring your custom tags match your database rules.

Build type-safe media workflows using Pydantic AI and this MCP Server to validate every ImageKit API response.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect ImageKit (Media Optimization & DAM) MCP to Pydantic AI

Create your Vinkius account to connect ImageKit (Media Optimization & DAM) 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 ImageKit (Media Optimization & DAM) with Pydantic AI

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Type-Safe Metadata via Pydantic AI

Extracting camera metadata with strict validation is done via the `get_exif_metadata` tool. Silent data corruption can break your frontend layout when your agent calls this tool using Pydantic AI. The agent uses `get_file_details` to fetch file dimensions and sizes. If the ImageKit API returns unexpected null values, the SDK catches the validation error instantly.

Validated Cache Management

Clearing stale assets from the edge is handled by the `purge_cdn_cache` tool. Managing your CDN shouldn't be a guessing game. To verify the status, the agent polls `get_purge_status` to ensure the CDN has fully cleared. This guarantees your application serves the correct, updated assets to users.

Safe Media Library Cleanup

Cleaning up stale media in bulk is managed by the `wipe_batch_assets` tool in this MCP Server. Deleting the wrong media asset is a nightmare when managing large directories. For single files, the agent uses `wipe_media_asset` to clean up old drafts. Pydantic AI validates the deletion confirmation schema to ensure the asset was successfully dropped.

Setup guide

Set up ImageKit (Media Optimization & DAM) 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": {
        "imagekit-media-optimization-dam-mcp": {
            "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
        }
    }
})

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

result = await agent.run("List recent ImageKit (Media Optimization & DAM) 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 ImageKit. 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 ImageKit (Media Optimization & DAM) 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 ImageKit (Media Optimization & DAM) MCP in Pydantic AI

The framework parses the JSON outputs from this MCP Server against Python type hints. This prevents your agent from acting on corrupt or malformed asset data.

Yes. Your agent calls `purge_cdn_cache` with target paths, and the response structure is verified at runtime. You can then monitor the purge queues using `get_purge_status`.

The agent calls `list_media_files` to fetch your asset list. Pydantic AI validates the array of file objects, giving your agent a clean, typed list to work with.

You can use `create_custom_schema` to define custom fields in ImageKit. The agent then uses `list_custom_fields` to fetch the schemas, ensuring your custom tags match your database rules.

This MCP Server only processes the CDN paths, file metadata, and asset IDs required to execute your commands. All operations run inside an ephemeral V8 sandbox, meaning no media payloads are retained.

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