How to Use the Wellhub MCP in Pydantic AI

Q: What is the process for check-ins with Wellhub using Pydantic AI?

The agent calls validatecheckin when a member scans their QR code. Because of Pydantic, you get reliable data confirming plan eligibility and recording the visit accurately.

Q: How do I list employee information for Wellhub using Pydantic AI?

Use listeligibleemployees to fetch a validated list of corporate workers. You'll get their plan tier, activation date, and usage status right in your Python code.

Q: Can I list partner locations for Wellhub using Pydantic AI?

Yes, simply use listlocations. This returns a defined list of all physical partner sites associated with your corporate wellness program.

Type-safe access to Wellhub data using Pydantic AI.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Wellhub MCP to Pydantic AI

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Validate Check-ins with MCP Server

When a member scans their QR code, the agent uses `validate_check_in`. This tool confirms plan eligibility and records the visit. The response is guaranteed to match your defined Pydantic schema. The system also tracks past visits using `list_check_ins`, providing structured data on gym name, date, time, and plan used.

Audit Employee Records with Pydantic AI

Call `list_eligible_employees` to pull a list of corporate workers. You get their plan tier, activation date, and usage status—all validated upon return. You can also check who's available via `check_eligibility`, which returns the member's specific plan tier and access permissions.

Manage Class Schedules using MCP Server

To see what’s open, run `list_classes`. This provides the schedule, capacity, and available spots for corporate members. Need a deeper look? Use `list_bookings` to get the class name, time, member name, and current booking status.

Setup guide

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

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

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

The agent calls `validate_check_in` when a member scans their QR code. Because of Pydantic, you get reliable data confirming plan eligibility and recording the visit accurately.

Use `list_eligible_employees` to fetch a validated list of corporate workers. You'll get their plan tier, activation date, and usage status right in your Python code.

The server manages core wellness details like member eligibility (plan tiers) and booking statuses. It handles both check-in records and employee account status types.

Yes, simply use `list_locations`. This returns a defined list of all physical partner sites associated with your corporate wellness program.

You receive the schedule, capacity count, and available spots for corporate members. This data is strictly typed and validated upon retrieval via `list_classes`.

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