How to Use the GetYourGuide MCP in Vercel AI SDK

Q: How do I get started with GetYourGuide and the Vercel AI SDK?

Install ai and @ai-sdk/mcp, then use createMCPClient with your Vinkius endpoint URL. You pass the tools from mcpClient.tools() into the generateText or streamText functions. It's designed to fit right into your existing Next.js or React app.

Q: Can I check if the GetYourGuide connection is working before making calls?

Yes. The server includes a verifyapiconnection tool. You can call this first to make sure your agent can reach the GetYourGuide API through the MCP server before you try to search or book anything.

Q: What's the best way to handle multiple shopping carts for a user with GetYourGuide and the Vercel AI SDK?

Your agent can call listactivecarts to get all of a user's current carts. Then, using getcartdetails, it can fetch the specifics for each one and stream the data to your UI. This lets you build a dashboard where users can see and manage all their planned trips.

Q: How does my agent find available cities with GetYourGuide in the Vercel AI SDK?

It's a single tool call: listtraveldestinations. Your agent can run this to get a full list of supported cities. You can use this to populate a dropdown or to validate a user's typed input in real time.

Connect GetYourGuide to your frontend with the Vercel AI SDK and stream travel activities directly into your React components.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect GetYourGuide MCP to Vercel AI SDK

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Stream Search Results, Not Spinners

Stop making users wait. When your agent calls `search_travel_activities`, you can use the Vercel AI SDK to stream the results directly into your UI. Each tour or activity appears on the screen the moment it's found, not after the whole list is finished. This makes your app feel alive. The user asks for 'tours in Paris' and watches the options pop into view one by one. You just wire the `streamText` output to your components and let the data flow. It's a better experience, plain and simple.

Build a Live Booking Interface

Booking a trip involves a few steps. With this MCP Server, your UI can reflect each one in real time. First, you hit `check_activity_availability` and the button immediately shows if there are slots. When the user clicks book, you fire `create_travel_booking`. Then, the best part. You can immediately call `get_booking_status` and stream the confirmation details right back to the user's screen. No page reloads. Just a clean, fast confirmation that their trip is booked.

Get Instant Details on Demand

Users always want more information. Instead of pre-loading everything and slowing down your page, let the user's agent pull details as needed. A click can trigger a call to `get_activity_details` for a specific tour. The Vercel AI SDK streams the response, so you can populate a modal or sidebar with the tour's metadata instantly. This keeps your initial load light and provides a responsive interface that fetches data only when it's actually requested.

Setup guide

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

Install `ai` and `@ai-sdk/mcp`, then use `createMCPClient` with your Vinkius endpoint URL. You pass the tools from `mcpClient.tools()` into the `generateText` or `streamText` functions. It's designed to fit right into your existing Next.js or React app.

Yes. The server includes a `verify_api_connection` tool. You can call this first to make sure your agent can reach the GetYourGuide API through the MCP server before you try to search or book anything.

Your agent can call `list_active_carts` to get all of a user's current carts. Then, using `get_cart_details`, it can fetch the specifics for each one and stream the data to your UI. This lets you build a dashboard where users can see and manage all their planned trips.

It's a single tool call: `list_travel_destinations`. Your agent can run this to get a full list of supported cities. You can use this to populate a dropdown or to validate a user's typed input in real time.

Your agent only handles booking data like travel dates, activity IDs, and cart contents. Vinkius processes each request in an ephemeral, zero-trust sandbox. Your Vercel AI SDK client communicates directly with that secure endpoint, so your data isn't sitting on an intermediate server.

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