How to Use the Calenso MCP in Vercel AI SDK

Feed live Calenso booking tools directly into your Vercel AI SDK interface for instant UI rendering without loading spinners.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Calenso MCP to Vercel AI SDK

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Render live branch options in Vercel AI SDK

Use `list_calenso_branches` to pull your physical locations and display them dynamically as your user types. This tool lets your React frontend render office choices immediately while the user chats with your agent. Instead of waiting for a full API roundtrip, this MCP integration pipes the branch list straight into `streamText`. Your user sees available spots pop up on their screen in real time, making the scheduling flow feel like a native app.

Book and update clients on the fly

Run `create_calenso_customer` to register new users and link them to upcoming meetings. This tool creates the profile instantly so you can chain it with scheduling actions inside a single user session. When you run this MCP tool, the Vercel AI SDK handles the customer creation payload without blocking the main thread. Your UI updates the moment the customer record is confirmed, keeping the booking pipeline moving.

Clean up calendars without UI lag

Call `cancel_calenso_appointment` to remove bookings and free up time slots instantly. This tool updates the calendar state behind the scenes so your interface can reflect the change immediately. By passing this tool to `generateText`, your agent handles cancellations in a single turn. You don't have to write custom state sync code because the SDK streams the cancellation status straight to the client.

Setup guide

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

Run npm install ai @ai-sdk/mcp in your terminal. From there, initialize the MCP client using createMCPClient with the Vinkius endpoint URL and pass the tools directly into streamText.

Yes, that is the main strength of this setup. When the agent calls list_calenso_branches, the Vercel AI SDK streams the raw JSON data directly to your frontend components so you can render custom cards instead of boring text.

Yes. Always run mcpClient.close() once your Vercel AI SDK execution finishes. This prevents connection leaks in your serverless or Edge environments.

Vinkius isolates each connection, meaning your Vercel AI SDK app can safely handle concurrent users. You can pass user-specific tokens using the authProvider option during client initialization.

Your customer contact details and meeting notes are never stored by Vinkius. The V8 sandbox processes the list_calenso_customers payload in an ephemeral session, transmitting it directly to your Vercel AI SDK application over an encrypted channel.

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