Bring Tour Booking
to Pydantic AI
Learn how to connect GetYourGuide to Pydantic AI and start using 12 AI agent tools in minutes. Fully managed, enterprise secure, and ready to use without writing a single line of code.
GDPR Free for SubscribersCompatible with every major AI agent and IDE
Gemini
What is the GetYourGuide MCP Server?
Connect your AI agent to the GetYourGuide global marketplace to automate travel activity discovery and booking through the Model Context Protocol (MCP). GetYourGuide is the leading platform for finding and booking unforgettable travel experiences, from guided tours to skip-the-line tickets. This MCP server enables you to search for activities in any destination, check real-time availability, and manage travel bookings directly through natural conversation.
Key Features
- Activity Discovery — Search for tours and experiences by keyword, location, or coordinates, and fetch detailed metadata for each activity.
- Real-time Availability — Check open time slots and vacancies for specific tours to find the perfect time for your trip.
- Travel Booking — Programmatically create new bookings for activities and retrieve confirmation details instantly.
- Booking Management — Fetch the status of existing reservations or cancel confirmed bookings using their unique hash.
- Shopping Cart Tracking — List and retrieve detailed information for active or pending shopping carts.
- Global Destinations — List supported cities and destinations to discover the best activities GetYourGuide has to offer globally.
- Partner Insights — Access metadata for the authenticated partner account to verify connectivity and settings.
- Real-time Synchronization — Keep your travel operations accessible to your AI assistant without leaving your primary workspace.
How it works
- Subscribe to this server through the Vinkius Marketplace
- Enter your GetYourGuide Partner Access Token (found in the Integrator Portal)
- Start managing your travel activities from Claude, Cursor, or any MCP client
Who is this for?
- Travel Agencies & Distributors — quickly check activity availability or manage client bookings without manual portal navigation.
- Travel Concierges — get a real-time overview of the best activities in any destination via simple AI commands.
- Logistics Ops — automate the retrieval of tour details and booking statuses for travel itineraries.
Built-in capabilities (12)
Cancel a booking
Check open slots
Book an activity
Get tour metadata
Check booking details
Get cart metadata
Get account identity
List shopping carts
List supported cities
Filter by city
Search tours/activities
Check connection
Why Pydantic AI?
Pydantic AI validates every GetYourGuide tool response against typed schemas, catching data inconsistencies at build time. Connect 12 tools through Vinkius and switch between OpenAI, Anthropic, or Gemini without changing your integration code. full type safety, structured output guarantees, and dependency injection for testable agents.
- —
Full type safety: every MCP tool response is validated against Pydantic models, catching data inconsistencies before they reach your application
- —
Model-agnostic architecture. switch between OpenAI, Anthropic, or Gemini without changing your GetYourGuide integration code
- —
Structured output guarantee: Pydantic AI ensures tool results conform to defined schemas, eliminating runtime type errors
- —
Dependency injection system cleanly separates your GetYourGuide connection logic from agent behavior for testable, maintainable code
GetYourGuide in Pydantic AI
GetYourGuide and 4,000+ other MCP servers. One platform. One governance layer.
Teams that connect GetYourGuide to Pydantic AI through Vinkius don't need to source, host, or maintain individual MCP servers. Every tool call runs inside a hardened runtime with credential isolation, DLP, and a signed audit chain.
Raw MCP | Vinkius | |
|---|---|---|
| Server catalog | Find and host yourself | 4,000+ managed |
| Infrastructure | Self-hosted | Sandboxed V8 isolates |
| Credential handling | Plaintext in config | Vault + runtime injection |
| Data loss prevention | None | Configurable DLP policies |
| Kill switch | None | Global instant shutdown |
| Financial circuit breakers | None | Per-server limits + alerts |
| Audit trail | None | Ed25519 signed logs |
| SIEM log streaming | None | Splunk, Datadog, Webhook |
| Honeytokens | None | Canary alerts on leak |
| Custom domains | Not applicable | DNS challenge verified |
| GDPR compliance | Manual effort | Automated purge + export |
Why teams choose Vinkius for GetYourGuide in Pydantic AI
The GetYourGuide MCP Server runs on Vinkius-managed infrastructure inside AWS — a purpose-built runtime with per-request V8 isolates, Ed25519 signed audit chains, and sub-40ms cold starts. All 12 tools execute in hardened sandboxes optimized for native MCP execution.
Your AI agents in Pydantic AI only access the data you authorize, with DLP that blocks sensitive information from ever reaching the model, kill switch for instant shutdown, and up to 60% token savings. Enterprise-grade infrastructure, zero maintenance.
* Every MCP server runs on Vinkius-managed infrastructure inside AWS - a purpose-built runtime with per-request V8 isolates, Ed25519 signed audit chains, and sub-40ms cold starts optimized for native MCP execution. See our infrastructure
How Vinkius secures
GetYourGuide for Pydantic AI
Every tool call from Pydantic AI to the GetYourGuide MCP Server is protected by DLP redaction, cryptographic audit chains, V8 sandbox isolation, kill switch, and financial circuit breakers.
Frequently asked questions
How do I get an Access Token for GetYourGuide?
You must register as a Partner or Distributor. Once approved, you can find your Access Token in the GetYourGuide Integrator Portal.
Can I search for activities using coordinates?
Yes! The 'search_travel_activities' tool accepts location strings which can include latitude/longitude coordinates to find tours near a specific point.
How do I check if a tour is available on a specific date?
Use the 'check_activity_availability' tool. Provide the Tour ID and an ISO date (YYYY-MM-DD) to see all open slots and vacancies for that day.
What is a 'Booking Hash'?
The Booking Hash is a unique alphanumeric identifier for a reservation. You need it to retrieve booking details or to cancel a reservation via the agent.
How does Pydantic AI discover MCP tools?
Create an MCPServerHTTP instance with the server URL. Pydantic AI connects, discovers all tools, and generates typed Python interfaces automatically.
Does Pydantic AI validate MCP tool responses?
Yes. When you define result types as Pydantic models, every tool response is validated against the schema. Invalid data raises a clear error instead of silently corrupting your pipeline.
Can I switch LLM providers without changing MCP code?
Absolutely. Pydantic AI abstracts the model layer. your GetYourGuide MCP integration works identically with OpenAI, Anthropic, Google, or any supported provider.
MCPServerHTTP not found
Update: pip install --upgrade pydantic-ai
Explore More MCP Servers
View all →
Salespanel
11 toolsAutomate lead tracking and visitor intelligence via Salespanel — manage contacts, website visitors, and engagement directly from any AI agent.
Postscript
12 toolsDrive Shopify revenue with SMS and MMS marketing that feels personal, converts browsers into buyers, and builds lasting loyalty.
Bizzabo
10 toolsOrchestrate your event experience via Bizzabo — manage events, registrations, and attendees directly from any AI agent.
GetFeedback
12 toolsManage online surveys, track real-time responses, and oversee feedback data via AI agents with GetFeedback.