How to Use the KlickTipp MCP in Pydantic AI

Q: How do I configure KlickTipp in Pydantic AI?

Install via pip install pydantic-ai-slimmcp. Initialize it using MCPToolset with your endpoint URL and pass it to your Agent's toolsets parameter.

Q: Can Pydantic AI validate KlickTipp custom fields?

Yes. When the agent runs listfields, Pydantic intercepts the JSON response and checks it against your defined Python types before proceeding.

Build type-safe KlickTipp MCP agents in Pydantic AI that validate every tag and subscription request at runtime.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect KlickTipp MCP to Pydantic AI

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Type-check KlickTipp MCP Server data

Marketing APIs often return messy payloads. Pydantic AI forces every response from the KlickTipp MCP Server through strict validation models. When your agent calls `get_contact`, the framework verifies the email string and custom field types before the model even sees the data. If KlickTipp returns an unexpected format, the agent fails loudly with a clear validation error. You never have to worry about silent corruption or hallucinated variables ruining your campaigns.

Execute precise tag operations

Tagging is the core of KlickTipp's logic. Your agent queries `list_tags` to pull the active taxonomy, mapping the raw IDs to expected states. When applying updates, it fires `tag_contact` or `untag_contact` exactly as defined in your schema. Because Pydantic AI is model-agnostic, this precision holds up whether you run the agent on Claude, OpenAI, or a local Llama instance.

Manage subscriptions safely

Adding users to the wrong funnel breaks compliance. The agent checks available workflows via `list_subscription_processes` and maps them to your internal Pydantic models. It then triggers `subscribe_contact` with guaranteed valid parameters. If a user opts out, the agent calls `unsubscribe_contact` and the framework confirms the exact execution state without guessing.

Setup guide

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

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

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

Install via pip install pydantic-ai-slim[mcp]. Initialize it using MCPToolset with your endpoint URL and pass it to your Agent's toolsets parameter.

The framework moved to a unified MCPToolset class for simpler configuration. You just pass the endpoint URL directly into the new wrapper.

Yes. When the agent runs list_fields, Pydantic intercepts the JSON response and checks it against your defined Python types before proceeding.

It does. Since Pydantic AI handles the tool routing, you can point the framework at a local model and it will still execute tag_contact perfectly.

The server handles email addresses and subscription states. Pydantic AI keeps this data in local memory during validation, meaning your sensitive contact details only travel between your server and your chosen LLM provider.

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