How to Use the Flip MCP in Pydantic AI

Q: How do I register the Flip MCP Server with Pydantic AI?

Install pydantic-ai-slimmcp and initialize MCPToolset with your Vinkius HTTP endpoint. Pass this toolset inside the toolsets argument when setting up your Pydantic AI Agent.

Q: Does this toolset support SSE transport in Pydantic AI?

Yes, the unified MCPToolset supports both Streamable HTTP and SSE transports, allowing you to connect to your externally running Vinkius server seamlessly.

Q: How does this server protect my bank balance and disbursement records?

Every request to getbalance and createdisbursement is routed through Vinkius's secure, ephemeral V8 Isolate Sandbox. Your financial keys are handled securely at the proxy layer, meaning sensitive transaction logs are never cached or exposed to external entities.

Validate bank accounts and issue payouts with strict runtime schemas in Pydantic AI using this MCP Server.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Flip MCP to Pydantic AI

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Type-safe bank checks in Pydantic AI

The Flip MCP Server integrates with Pydantic AI to validate bank account structures at runtime using `validate_bank_account`. Any response from the bank network is immediately parsed against strict Pydantic schemas, blocking malformed data before it reaches your agent. By using `list_banks` alongside this validation, your agent ensures that the bank code matches expected formats. If the API returns unexpected fields, the framework fails loudly instead of letting your agent guess.

Error-free disbursements via this MCP Server

You can safely trigger payouts using `create_disbursement` because every transaction parameter is strictly typed. The agent checks your available funds via `get_balance` first, parsing the financial floats into exact Python decimals. To track these transfers without silent errors, the agent calls `get_disbursement` and `list_disbursements`. If a bank status changes, the model parses the updated state into structured models for immediate processing.

Structured billing pipelines

This MCP integration lets your agent generate payment links using `create_bill` with complete confidence in the schema. The agent can then monitor active bills using `list_bills` and `get_bill`, ensuring every field matches your database models. For recurring invoices, the agent queries `list_recurring_payments` and parses the schedule. This prevents data drift between your internal ledger and external payment processors.

Setup guide

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

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

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

Install `pydantic-ai-slim[mcp]` and initialize `MCPToolset` with your Vinkius HTTP endpoint. Pass this toolset inside the `toolsets` argument when setting up your Pydantic AI Agent.

The framework will immediately raise a validation error and fail loudly. This prevents your agent from making decisions based on corrupted or malformed payment data.

Yes, the integration is model-agnostic, meaning your agent can use OpenAI, Gemini, or Claude to execute tools like `validate_bank_account` and `create_disbursement` while keeping your validation logic intact.

Yes, the unified `MCPToolset` supports both Streamable HTTP and SSE transports, allowing you to connect to your externally running Vinkius server seamlessly.

Every request to `get_balance` and `create_disbursement` is routed through Vinkius's secure, ephemeral V8 Isolate Sandbox. Your financial keys are handled securely at the proxy layer, meaning sensitive transaction logs are never cached or exposed to external entities.

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