How to Use the MessageFlow MCP in Pydantic AI

Q: How do I integrate MessageFlow with Pydantic AI?

Use the MCPToolset class with your Vinkius HTTP endpoint URL. Pass this MCP Server toolset instance inside the toolsets argument when initializing your Pydantic AI Agent. Do not use the deprecated MCPServerHTTP class.

Q: How does Pydantic AI handle invalid data returned from MessageFlow?

If an API response from tools like getdeliverystatus or listmessages violates the expected schema, the framework raises a validation error. This ensures your agent never processes corrupt tracking data.

Q: What is the best way to manage WhatsApp templates safely?

The agent calls gettemplate to fetch the template structure. Pydantic AI validates the variable placeholders, ensuring your agent provides the exact parameters required by sendwhatsapp.

Send type-safe SMS, email, and WhatsApp messages using MessageFlow with strict Pydantic AI validation.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect MessageFlow MCP to Pydantic AI

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Enforce type-safe message dispatches

The `send_email` tool transmits structured email messages with runtime schema validation. Pydantic AI checks every recipient address, subject line, and body payload against strict Python models before the request leaves your application. This prevents formatting errors from reaching the gateway. If the model attempts to pass an invalid email format, the SDK triggers a validation error immediately. You catch bugs during development rather than dealing with silent delivery failures in production.

Validate messaging channels using this MCP Server

The `list_channels` tool fetches all active communication routes supported by your account. The agent validates this list against your internal routing models using this MCP tool. This prevents agents from attempting to use unconfigured networks. When routing a message, the agent can fall back to `send_generic_message` while validating that the payload conforms to the destination channel's specific schema constraints. Your code remains clean because validation happens automatically before any HTTP request occurs.

Safely parse templates and account balances

The `get_account_balance` tool returns your current credit balance as a validated float value. Pydantic AI ensures this number maps correctly to your internal billing objects. Your agent can safely run conditional logic based on this balance without risking type mismatches. Similarly, `get_template` and `list_templates` return structured template objects. The agent parses these templates, extracts the required variables, and uses `send_whatsapp` or `send_sms` with complete runtime safety.

Setup guide

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

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

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

Use the `MCPToolset` class with your Vinkius HTTP endpoint URL. Pass this MCP Server toolset instance inside the `toolsets` argument when initializing your Pydantic AI `Agent`. Do not use the deprecated `MCPServerHTTP` class.

If an API response from tools like `get_delivery_status` or `list_messages` violates the expected schema, the framework raises a validation error. This ensures your agent never processes corrupt tracking data.

Yes, Pydantic AI is model-agnostic. You can connect this MCP Server to local models or commercial APIs, and the framework will still enforce type safety for all ten messaging tools.

The agent calls `get_template` to fetch the template structure. Pydantic AI validates the variable placeholders, ensuring your agent provides the exact parameters required by `send_whatsapp`.

Your account tokens and message payloads are handled exclusively in RAM within isolated V8 sandboxes. No message bodies, balances, or contact logs are ever cached or stored on the Vinkius hosting infrastructure, keeping your MCP integration completely secure.

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