How to Use the YouCanBook.me MCP in Pydantic AI

Q: What tools should I use to list all team members with YouCanBook.me and Pydantic AI?

Use listteammembers. This tool specifically lists all personnel assigned to a given booking page, ensuring the agent knows who is involved in the scheduling process.

Q: How can I get the current details of an account plan using YouCanBook.me and Pydantic AI?

The getaccount tool retrieves all structured data about your YouCanBook.me service plan, providing clear, typed information.

Q: What is the best way to query multiple scheduled meetings with YouCanBook.me and Pydantic AI?

You'll use listbookings. This tool lets you filter appointments by status (like 'tentative' or 'finished'), giving your agent a precise list of records.

Q: Does the MCP Server handle data privacy when listing profiles? (YouCanBook.me and Pydantic AI)

Yes. The listprofiles tool accesses booking page metadata, allowing controlled management of which scheduling pages are available to your agent.

Q: If I need to confirm a meeting time with YouCanBook.me and Pydantic AI?

Use confirmintent. This finalizes the booking intent by creating an official appointment record, which is then typed-checked against your defined models.

Type-safe scheduling automation with 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 YouCanBook.me MCP to Pydantic AI

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Creating and Validating Intent

Start the process by calling `create_intent` to generate a booking intent ID using your profile subdomain. This sets up the foundation for programmatic scheduling. The agent then calls `get_availability` with that new intent ID. The response gives precise, typed time slots, which your Pydantic model validates before moving forward.

Retrieving Account and Profile Data

`list_profiles` provides a list of all booking pages configured in the account; this data is validated against defined schemas. Similarly, `get_profile` retrieves detailed configuration settings for a specific page. You can also check your service status by using `get_account`, which returns structured details about the YouCanBook.me plan.

Managing Appointments and Cancellations

`list_bookings` lets your agent pull a list of appointments, filtering them by specific statuses like 'upcoming.' For full details on one meeting, use `get_booking`. This data is always validated against the expected schema. If an appointment needs to be removed, the `cancel_booking` tool handles it. It permanently removes the event and notifies the attendee.

Setup guide

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

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

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

Use `list_team_members`. This tool specifically lists all personnel assigned to a given booking page, ensuring the agent knows who is involved in the scheduling process.

The `get_account` tool retrieves all structured data about your YouCanBook.me service plan, providing clear, typed information.

You'll use `list_bookings`. This tool lets you filter appointments by status (like 'tentative' or 'finished'), giving your agent a precise list of records.

Yes. The `list_profiles` tool accesses booking page metadata, allowing controlled management of which scheduling pages are available to your agent.

Use `confirm_intent`. This finalizes the booking intent by creating an official appointment record, which is then typed-checked against your defined models.

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