How to Use the Mindbody MCP in Vercel AI SDK

Render live Mindbody studio schedules and booking status straight into your Next.js app with Vercel AI SDK.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Mindbody MCP to Vercel AI SDK

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Build real-time scheduling components with Vercel AI SDK

Your users hate loading spinners. With this MCP Server, your Next.js app streams live class schedules directly to the client UI as the model processes the query. The client gets instant feedback while the model calls `list_classes` and updates the available slots on the fly. You can bind the stream directly to interactive React components. When a client wants to check their upcoming sessions, the agent calls `get_client_history` and populates the history component block by block, keeping the interface snappy and responsive.

Instant membership lookups on Edge Functions

Keep your serverless costs down and your speeds high. Running this setup on Vercel Edge Functions means you can fetch active passes instantly. Your agent queries `get_client_memberships` and renders the remaining visits directly in the user's profile card without hitting cold-start delays. Because this MCP Server integrates natively with your runtime, the interface doesn't freeze while checking account status. If a client is short on passes, the agent pulls options via `list_services_pricing` and displays checkout links in the chat window immediately.

Stream instructor availability directly to React

Stop building complex custom backend endpoints to map trainer calendars. Your AI client can query `list_staff_schedule` and `list_staff` in a single run, streaming the combined instructor profiles and open slots directly into your frontend layout. This approach removes the need for middleman API controllers. The agent handles the data mapping and feeds the raw JSON straight into your custom UI components, saving you hours of boilerplate layout code.

Setup guide

Set up Mindbody 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 Mindbody 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 Mindbody 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 Mindbody. 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 Mindbody 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 Mindbody MCP in Vercel AI SDK

Use the authProvider configuration during client initialization to manage your OAuth tokens. The SDK automatically passes the active session credentials to the server for every tool execution.

Yes, you can call createMCPClient inside your Server Actions. This lets you execute tools like list_appointments on the server side and pass the clean data directly back to your React components.

Absolutely. The MCP client uses standard HTTP transports, making it fully compatible with Vercel Edge Functions. This ensures your agent can query search_clients with minimal latency from any global edge location.

Use the streamText function and map the tool call results to React components. When the model invokes list_class_schedules, you can capture the JSON payload and render a custom calendar card directly in the chat interface.

Yes, your client data never passes through third-party servers. When the agent requests get_client_history or list_sales, the credentials and payload run through Vercel's secure environment variables directly to the sandbox, keeping financial transactions and personal records isolated.

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