How to Use the Maileroo MCP in Pydantic AI

Run type-safe email workflows with Pydantic AI validating every Maileroo tool response 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 Maileroo MCP to Pydantic AI

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Type-Safe Delivery via Pydantic AI

`send_transactional_email` sends your system notifications while the Pydantic AI framework validates the API response against strict Python models. This MCP integration ensures that if the Maileroo API returns an unexpected payload, your Pydantic AI agent raises a validation error immediately. This prevents corrupt or malformed Maileroo data from silently breaking your Pydantic AI notification pipeline. You write clean, typed code, and the Pydantic AI toolset guarantees that the Maileroo email status matches your internal schemas.

Rigorous Domain Status Verification

`get_domain_details` fetches DNS and verification records for your Maileroo sending domains with absolute runtime safety inside Pydantic AI. The Pydantic AI agent parses the returned Maileroo SPF and DKIM records directly into structured Python models. If a Maileroo domain is missing a critical TXT record, the Pydantic AI validation fails loudly before your application attempts to send emails. You catch Maileroo setup issues programmatically in your Pydantic AI workflows instead of waiting for bounces.

Structured Template Auditing

`list_email_templates` gets your active Maileroo layouts and parses them into typed Pydantic AI models. Your Pydantic AI agent inspects the available Maileroo template variables to ensure they match your application's data. This setup prevents runtime errors in Pydantic AI caused by missing Maileroo template keys. The Pydantic AI agent checks that the Maileroo template structure is correct before passing any data to the sending tools.

Setup guide

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

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

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

The framework automatically wraps the Maileroo MCP Server tools in Pydantic models. When the agent calls list_sending_activity, the JSON response is validated at runtime to ensure it matches the expected schema.

Yes, you can define custom Pydantic schemas for your email payloads before passing them to send_transactional_email. This ensures that recipient addresses and template variables are validated before the tool is invoked.

The framework catches the error and raises a validation or execution exception. This prevents your agent from hallucinating a successful send when send_transactional_email actually failed.

You run the server externally and connect using the MCPToolset class via streamable HTTP. This allows your agent to discover all six email tools dynamically.

All domain records, webhook configurations, and email payloads are processed within an isolated V8 sandbox. Vinkius handles the transport securely using TLS, and no transactional data is logged or stored on our servers.

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