How to Use the myClub MCP in Pydantic AI

Q: Can I use Pydantic AI to create a type-safe agent for myClub member management?

Yes. When your agent uses getmember, Pydantic AI validates the response. This guarantees you're always working with a properly formed member object in your Python code.

Q: How do I give my Pydantic AI agent access to the myClub tools?

It's straightforward. You create an MCPToolset instance with your server URL and pass it in the toolsets list when you initialize your Agent. Pydantic AI handles the rest.

Build type-safe myClub agents with Pydantic AI. Get validated, predictable data for every roster, event, and invoice query.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect myClub MCP to Pydantic AI

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Prevent Bad Data, Automatically

This MCP server gives your agent access to your club's core data. Pydantic AI makes sure that data is correct every single time. When your agent calls `list_members`, the response is validated against a Pydantic model. If the myClub API ever returns an extra field or a wrong data type, your agent won't just guess. It will raise a `ValidationError` immediately. This means no silent data corruption in your automations.

Build Bulletproof Financial Bots

When you're dealing with money, correctness is everything. Build an agent that uses `list_invoices` to pull financial records from myClub. Pydantic AI ensures every invoice record matches the expected structure. You can trust your agent's output. If it generates a report of members with outstanding balances using `get_invoice`, you know the data is sound because it passed Pydantic's validation checks first.

Use Any LLM with This MCP Server

Pydantic AI doesn't lock you into a specific model provider. You can use this myClub MCP Server with OpenAI, Anthropic, Gemini, or a local model. The tools work the same everywhere. Just point your Pydantic AI `Agent` to the `MCPToolset`. It handles the function-calling logic, so you can focus on the task, like building an agent that checks `list_cards` for upcoming expirations, regardless of the LLM you're using.

Setup guide

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

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

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

Pydantic AI automatically creates and enforces schemas for the data returned by myClub tools. If a call to `list_events` returns data that doesn't match the expected format, it raises an error instead of letting your agent use bad data.

Yes. When your agent uses `get_member`, Pydantic AI validates the response. This guarantees you're always working with a properly formed member object in your Python code.

It's straightforward. You create an `MCPToolset` instance with your server URL and pass it in the `toolsets` list when you initialize your `Agent`. Pydantic AI handles the rest.

Your Pydantic AI agent will fail loudly with a validation error on the first call. This is a feature, not a bug. It prevents your system from processing incorrect data and alerts you that the API contract has changed.

All data queries for invoice history or member directories pass through Vinkius's ephemeral infrastructure. Pydantic AI's role is to ensure data integrity; it will reject any response that doesn't strictly match the schema, preventing malformed or unexpected data from ever reaching your agent's logic.

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