How to Use the Bookeo MCP in Vercel AI SDK

Q: How do I connect Bookeo to my Vercel AI SDK project?

Install the required packages using npm install ai @ai-sdk/mcp. Initialize the connection using createMCPClient with your Vinkius MCP Server URL, then pass the tools directly into your streamText function. Remember to call mcpClient.close() once the execution finishes to prevent memory leaks.

Stream Bookeo booking availability and customer profiles directly to your React components with the Vercel AI SDK and our 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 Bookeo MCP to Vercel AI SDK

Create your Vinkius account to connect Bookeo to Vercel AI SDK 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 Bookeo with Vercel AI SDK

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Live Bookeo Slots in Vercel AI SDK UI

The `check_availability` tool queries your Bookeo calendar to grab open slots for fitness classes or activities instantly using this MCP Server. When your user asks for open times, the Vercel AI SDK streams these slots straight to the frontend, bypassing the usual loading spinners. This direct connection means your AI client renders live schedules as the data arrives. You feed the tools from `mcpClient.tools()` into `streamText` to keep the UI updated without making the customer wait.

On-the-Fly Customer Profile Retrieval

The `search_customers` tool pulls customer profiles, booking history, and specific preferences directly into your chat interface. Your agent uses this data to answer personalized questions about past sessions or reschedule requests immediately. By combining this with `get_customer`, your Edge Functions fetch the necessary context in milliseconds. The user gets a tailored conversation while the SDK manages the active stream behind the scenes.

Instant Revenue and Booking Audits

The `list_payments` tool pulls payment histories across specific date ranges to generate quick financial summaries inside your application. Your agent queries this along with `list_bookings` to calculate pricing, participant counts, and outstanding balances. Developers expose these tools to the client to let users run natural language reports on their business performance. The app processes the data on the edge, ensuring rapid response times for busy gym owners.

Setup guide

Set up Bookeo MCP in Vercel AI SDK

Prerequisites

Node.js 18+ and a TypeScript project
ai + @modelcontextprotocol/sdk packages
Active Vinkius subscription with a valid endpoint token

1

Install dependencies

Run npm install ai @modelcontextprotocol/sdk plus your preferred model provider (e.g. @ai-sdk/openai).
2

Create the Streamable HTTP transport

Use StreamableHTTPClientTransport with your Vinkius endpoint URL. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com.
3

Discover and use tools

Call mcpClient.tools() to auto-discover all Bookeo tools. Pass them directly to generateText() or streamText() — no manual schema definitions needed.
4

Works with any model provider

Swap openai("gpt-4o") for any AI SDK provider — Anthropic, Google, Mistral. The MCP tools work identically across all supported models.

index.ts

import { experimental_createMCPClient as createMCPClient } from "ai";
import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp";
import { generateText } from "ai";
import { openai } from "@ai-sdk/openai";

const transport = new StreamableHTTPClientTransport(
  new URL("https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp")
);

const mcpClient = await createMCPClient({ transport });
const tools = await mcpClient.tools();

const { text } = await generateText({
  model: openai("gpt-4o"),
  tools,
  prompt: "List recent Bookeo transactions",
});

console.log(text);
await mcpClient.close();

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 Bookeo. 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 Bookeo 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 Bookeo MCP in Vercel AI SDK

Install the required packages using `npm install ai @ai-sdk/mcp`. Initialize the connection using `createMCPClient` with your Vinkius MCP Server URL, then pass the tools directly into your `streamText` function. Remember to call `mcpClient.close()` once the execution finishes to prevent memory leaks.

Yes, you control this during initialization. Filter the array returned by `mcpClient.tools()` before passing them to your model. This keeps sensitive operations like billing tools hidden from public-facing chatbots.

Vinkius manages the core authentication layer so you only need a single endpoint token. For user-specific actions, the SDK supports `authProvider` to handle OAuth flow securely without exposing credentials to the client.

It runs flawlessly there. The client footprint is lightweight and runs within Edge runtime limits. It fetches booking details via `get_booking` and streams the JSON response back to the browser without hitting cold start delays.

Your customer profiles, booking history, and payment statuses remain protected inside isolated V8 sandboxes. Vinkius processes these transactions ephemerally, meaning no customer records are stored on our servers after the stream ends.

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