# GetYourGuide MCP for AI Agents AI Agent Connect > GetYourGuide MCP for AI agents. Search and book tours, activities, and travel experiences directly through your AI client. It lets you find local experiences, check real-time availability, and manage bookings in one place. This tool is built for travel pros who need to handle high volumes of requests without the hassle of manual data entry. ## Overview - **Category:** ecommerce - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_iNuAOqt9U9mJS92QG2FT43wrTQ0DDciHNL4dcSco/ai-agent-connect - **Tags:** tour-booking, travel-experiences, activity-discovery, marketplace-api, booking-management ## Description Imagine you're a travel agent trying to piece together a complex itinerary for a group of ten. Usually, that means opening twenty different tabs, checking availability on various websites, and manually copying booking codes into a spreadsheet. This Connector changes that. It connects your AI client to the GetYourGuide marketplace, letting you handle the heavy lifting through a simple conversation. Instead of hunting for skip-the-line tickets or guided tours in Paris, you just ask your agent to find the best options and check if they have spots left for a specific date. It handles the discovery, the availability checks, and the actual booking. You can even manage existing reservations or check your shopping cart without leaving your workspace. Because Vinkius hosts this Connector, you can plug it into your existing setup and start pulling real-time travel data instantly. It turns a manual research slog into a few quick prompts. ## Tools ### check_activity_availability See if a specific tour has open slots. Use this to confirm dates before you commit to a plan. ### search_travel_activities Find tours and experiences using keywords. It pulls detailed metadata for every result. ### search_by_destination Filter tours based on a specific city. This helps narrow down options for a specific trip. ### get_partner_details Retrieve your account identity. This confirms your credentials are working correctly. ### get_booking_status Check the details of a specific reservation. Use this to see if a booking is confirmed or pending. ### get_cart_details View the metadata for your current shopping cart. This lets you see what's ready for checkout. ### get_activity_details Fetch metadata for a single activity. It provides the specifics you need for a brochure or itinerary. ### list_active_carts See all your currently active shopping carts. Use this to track multiple pending bookings at once. ### list_travel_destinations See all the cities and regions supported by the marketplace. This helps you know where you can book. ### cancel_travel_booking Void a confirmed reservation using its unique hash. This is the fastest way to handle last-minute changes. ### verify_api_connection Test the link between your agent and the marketplace. Run this first to ensure everything is synced. ### create_travel_booking Book a new activity instantly. This creates the reservation and returns the confirmation details. ## Prompt Examples **Prompt:** ``` Find me some guided tours for the Eiffel Tower in Paris. ``` **Response:** ``` I found several options for the Eiffel Tower in Paris: | Tour Name | ID | Highlights | | :--- | :--- | :--- | | **Priority Access Tour** | 123 | Skip-the-line entry, 2-hour duration | | **Summit Guided Tour** | 456 | Full audio guide, panoramic views | Would you like me to check availability for one of these? ``` **Prompt:** ``` Is there any space left for a skip-the-line tour at the Louvre on October 12th? ``` **Response:** ``` Checking availability for the Louvre Museum Skip-the-Line Ticket on October 12th... **Yes, there are 12 slots available.** * **Morning Session:** 09:00 AM - 11:00 AM * **Afternoon Session:** 01:00 PM - 03:00 PM * **Starting Price:** $35.00 per person ``` **Prompt:** ``` What's the status of my booking GYG-998877? ``` **Response:** ``` Fetching booking details for **GYG-998877**... Your reservation for the **Venice Gondola Ride** is **Confirmed**. * **Meeting Point:** San Marco Square * **Time:** 10:30 AM tomorrow * **Status:** Confirmed ``` ## Capabilities ### Search for tours by location or keyword Find specific activities in any destination using simple text prompts. ### Check real-time slot availability See exactly what times and dates are open for a specific tour. ### Create new activity bookings Book a tour or experience directly through your agent's conversation. ### Fetch status of existing reservations Get current details for a booking using its unique hash. ### Cancel confirmed bookings Void a reservation instantly when plans change. ### List and view shopping cart items See what's currently in your cart and its associated metadata. ### Verify partner account connection Confirm your credentials are active and correctly linked. ## Use Cases ### Group tour booking for a specific city A travel agent wants to find a skip-the-line tour in Rome for a group of four on Friday. They use `search_travel_activities` to find options and `check_activity_availability` to confirm spots. ### VIP guest activity check A concierge needs to check if a specific gondola ride in Venice is still available for a VIP guest. They use `get_booking_status` to see if a previous request is still active. ### Last-minute itinerary changes A logistics coordinator needs to cancel a tour due to a flight delay. They use `cancel_travel_booking` to void the reservation instantly and get a new confirmation. ### Destination research A travel planner wants to see all available cities where they can book guided experiences. They use `list_travel_destinations` to map out a global itinerary. ## Benefits - Stop manual tab switching by using `search_travel_activities` to find tours in seconds. - Confirm dates instantly with `check_activity_availability` to avoid overbooking your clients. - Manage your entire itinerary from one spot by using `create_travel_booking` and `cancel_travel_booking`. - Keep your data organized by using `list_active_carts` to track multiple pending requests. - Verify your connection status quickly with `verify_api_connection` to ensure your agent is always ready. ## How It Works The bottom line is you get a direct line to global travel bookings without the manual tab-switching. 1. Subscribe to the GetYourGuide MCP on Vinkius and grab your Partner Access Token from the Integrator Portal. 2. Add your token to your AI client's configuration settings. 3. Ask your agent to find activities, check dates, or book tours in any city. ## Frequently Asked Questions **Can the GetYourGuide MCP book tours for me?** Yes, it can create new bookings and provide confirmation details immediately. You just need to tell your agent which activity and date you want to book. **How does the GetYourGuide MCP handle availability?** It checks real-time slots so you know exactly what's open before you try to book. This prevents overbooking and helps you plan more accurately. **Can I use the GetYourGuide MCP to cancel a reservation?** Yes, you can cancel confirmed bookings using their unique hash through your agent. It's the fastest way to handle last-minute plan changes. **Is the GetYourGuide MCP good for travel agencies?** It's built for them, helping manage client bookings and activity discovery without manual portal navigation. It lets you handle high volumes of requests in one place. **Can the GetYourGuide MCP see my shopping cart?** Yes, it can list active carts and show you the metadata for items you're about to book. This helps you keep track of pending requests. **How do I connect my GetYourGuide MCP to my AI client?** You just need a Partner Access Token from the GetYourGuide Integrator Portal to get started. Once you have that, you can plug it into your AI client configuration. **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.