How to Use the KeyCDN (Content Delivery Network) MCP in Pydantic AI

Q: How do I initialize KeyCDN (Content Delivery Network) in Pydantic AI?

Install pydantic-ai-slimmcp. Create an MCPToolset pointing to your HTTP endpoint and pass it to your Agent's toolsets array. Do not use the deprecated MCPServerHTTP class.

Q: How do I parse the endpoint when creating a KeyCDN (Content Delivery Network) zone via Pydantic AI?

The MCP tool returns structured data after calling addpullzone. Pydantic automatically maps this response into your Python models, so you access the immutable endpoint as a typed attribute.

Bring strict runtime validation to your KeyCDN MCP Server operations with Pydantic AI.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect KeyCDN (Content Delivery Network) MCP to Pydantic AI

Create your Vinkius account to connect KeyCDN (Content Delivery Network) 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 KeyCDN (Content Delivery Network) with Pydantic AI

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Pydantic AI Cache Invalidation

You cannot afford hallucinated cache purges in production. When your agent decides to clear an asset, it executes `purge_specific_url`. Pydantic AI strictly validates the URL path format before the request ever hits the KeyCDN API. If the model tries to pass a malformed string, the framework fails loudly. The same strictness applies to full zone wipes. Calling `purge_zone_cache_all` requires a valid zone ID. Your agent gets the exact schema. If the API returns unexpected confirmation data, you get a validation error instead of silent corruption.

Verified Zone Provisioning

Creating infrastructure requires exact parameters to avoid routing failures. Your agent uses `add_pull_zone` to spin up new endpoints. It immediately receives the immutable `.kxcdn.com` address, which Pydantic parses into a typed model for downstream tasks. Adding custom domains works the exact same way. The agent fires `add_zone_alias` to attach a vanity URL. If it needs to roll back, `delete_zone_alias` strips the domain. Every single response matches your predefined schemas perfectly.

Typed Traffic Auditing

Monitoring edge bandwidth shouldn't mean parsing loose JSON dictionaries. Your agent calls `list_traffic_reports` to extract bandwidth consumption metrics. Pydantic validates every integer and timestamp in that payload before your code touches it. To audit the actual infrastructure, the agent runs `list_zones` and `get_zone`. It cross-references the configuration states with the traffic data. You get perfectly structured objects representing your edge network, ready for insertion into your database.

Setup guide

Set up KeyCDN (Content Delivery Network) 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": {
        "keycdn-content-delivery-network-mcp": {
            "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
        }
    }
})

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

result = await agent.run("List recent KeyCDN (Content Delivery Network) 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 KeyCDN. 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 KeyCDN (Content Delivery Network) 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 KeyCDN (Content Delivery Network) MCP in Pydantic AI

Install `pydantic-ai-slim[mcp]`. Create an `MCPToolset` pointing to your HTTP endpoint and pass it to your Agent's `toolsets` array. Do not use the deprecated `MCPServerHTTP` class.

The framework throws a validation error immediately. If KeyCDN alters the response shape of `get_zone`, your agent fails loudly instead of operating on corrupted data.

Yes. The framework is model-agnostic. You can point it at a local Llama instance, and it will still enforce strict schemas on `list_zone_aliases` and other tool calls.

The MCP tool returns structured data after calling `add_pull_zone`. Pydantic automatically maps this response into your Python models, so you access the immutable endpoint as a typed attribute.

The server fetches raw bandwidth metrics and zone IDs. Vinkius handles authentication via single endpoint tokens, and the zero-trust architecture guarantees your traffic stats are destroyed the second the request completes.

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