How to Use the Click2Mail MCP in Pydantic AI

Q: What happens if the Click2Mail API returns unexpected data to my Pydantic AI agent?

Your code will fail loudly with a ValidationError. Pydantic AI doesn't let your agent work with corrupted or incorrect data, which prevents silent bugs and ensures your application's logic is sound.

Q: How do I add the Click2Mail tools to my Pydantic AI agent?

After installing pydantic-ai-slimmcp, you create an MCPToolset instance with your Vinkius server URL. Then you just pass it into the toolsets list when you initialize your Agent.

Add type-safe physical mail automation to your Python app. Pydantic AI validates every Click2Mail API call so your data is always correct.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Click2Mail MCP to Pydantic AI

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Send Mail with Guaranteed-Correct Responses

Stop worrying about API drift or silent data corruption. When your agent calls `submit_mail_job`, the response is parsed into a Pydantic model. If the API returns a field with the wrong type or a missing key, your code raises a `ValidationError` immediately. You know exactly what went wrong and where. The same goes for checking on a mailing's progress with `get_mail_job_details`. Your agent gets structured, predictable objects, not a dictionary you have to defensively check.

Reliably Check Balances and Job Costs

Mistakes with money are the worst. Pydantic AI helps you avoid them. The `get_mail_credit_balance` and `get_mail_job_cost` tools return responses that are validated as proper numeric types. No more parsing strings that might be formatted differently than you expect. This means the financial logic in your agent is built on a solid foundation. You can trust the numbers you're getting from the Click2Mail API because Pydantic is checking them for you on every single call.

A Model-Agnostic MCP Server for Your Stack

It doesn't matter if you're using OpenAI, Gemini, or a Llama model running on your own machine. Pydantic AI is model-agnostic, and this MCP Server works with all of them. The `MCPToolset` provides a consistent, type-safe way to interact with Click2Mail's services. Your agent can get structured lists of your assets with `list_mail_address_lists` and `list_mail_documents`, and the output will be a validated Pydantic model every time. You write your agent logic once, and it just works, regardless of the LLM backend.

Setup guide

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

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

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

Pydantic AI automatically wraps the MCP Server's tools. Every JSON response from Click2Mail is parsed and validated against a corresponding Pydantic model at runtime, guaranteeing the data structure matches what your code expects.

Your code will fail loudly with a `ValidationError`. Pydantic AI doesn't let your agent work with corrupted or incorrect data, which prevents silent bugs and ensures your application's logic is sound.

Yes. Pydantic AI is model-agnostic, so you can connect the Click2Mail `MCPToolset` to an agent powered by any supported LLM, including local models like Llama or Mistral.

After installing `pydantic-ai-slim[mcp]`, you create an `MCPToolset` instance with your Vinkius server URL. Then you just pass it into the `toolsets` list when you initialize your `Agent`.

The server accesses your Click2Mail data, including address lists, documents for mailing, and job history. Your Vinkius endpoint encrypts all traffic, and the server itself runs in a secure, single-tenant environment to protect your information.

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