How to Use the AdsWizz MCP in Pydantic AI

Q: How do I register the AdsWizz MCP Server in Pydantic AI?

Install pydantic-ai-slimmcp and use the unified MCPToolset class with your Vinkius AdsWizz server URL. Pass this toolset to your Pydantic AI Agent constructor to automatically discover tools like listcampaigns.

Get type-safe audio ad tracking by connecting AdsWizz to 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 AdsWizz MCP to Pydantic AI

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Type-safe campaign parsing with Pydantic AI

The `get_campaign` and `list_campaigns` tools fetch campaign details that Pydantic AI validates against strict Python types at runtime. If the AdsWizz API returns an unexpected null value or an altered date format, Pydantic AI raises a validation error instantly. You prevent corrupted AdsWizz campaign data from sliding into your production database.

Validate audio performance metrics using this MCP Server

The `get_audio_performance` tool ensures that when your Pydantic AI agent pulls performance stats, they parse into clean, typed Python objects. This MCP Server ensures that when your agent calls get_audio_performance, the AdsWizz metrics are parsed with absolute type safety. Your Pydantic AI agent uses these validated AdsWizz metrics to make decisions. Because the AdsWizz data is guaranteed to match your schema, you can write downstream Pydantic AI code without worrying about missing fields or type mismatches.

Fail-fast inventory mapping for podcasts and streams

The `list_zones` tool maps target AdsWizz inventory so Pydantic AI can validate the podcast and stream data the moment it arrives. This model-agnostic approach means you can swap LLMs behind your Pydantic AI agent while keeping your AdsWizz validation logic intact. Your agent safely maps AdsWizz audio zones knowing the underlying data structure is perfectly sound.

Setup guide

Set up AdsWizz 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": {
        "adswizz-mcp": {
            "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
        }
    }
})

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

result = await agent.run("List recent AdsWizz 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 AdsWizz. 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 AdsWizz 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 AdsWizz MCP in Pydantic AI

Install pydantic-ai-slim[mcp] and use the unified MCPToolset class with your Vinkius AdsWizz server URL. Pass this toolset to your Pydantic AI Agent constructor to automatically discover tools like list_campaigns.

The Pydantic AI framework fails loudly and raises a validation error. Instead of your agent hallucinating based on bad AdsWizz campaign details, your Pydantic AI code catches the error immediately so you can handle it safely.

Yes. Pydantic AI is model-agnostic, meaning you can run your AdsWizz campaign management tools using OpenAI, Anthropic, or local models while maintaining strict type safety.

Pydantic AI supports both Streamable HTTP and SSE transports for the AdsWizz server. For Vinkius, you will configure the toolset to communicate over our secure, managed HTTP endpoints.

Every request to this MCP Server to fetch AdsWizz performance metrics or campaign details is run through an isolated, zero-trust V8 sandbox. Your AdsWizz credentials and advertising data are never exposed to external networks or used for training models by Pydantic AI.

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