# GetYourGuide MCP > GetYourGuide lets your AI agent search for, check availability on, and book global tours and activities directly within conversation. It handles everything from finding skip-the-line tickets in Paris to managing multi-day travel itineraries across dozens of destinations. ## Overview - **Category:** ecommerce - **Price:** Free - **Tags:** tour-booking, travel-experiences, activity-discovery, marketplace-api, booking-management ## Description Stop jumping between the GetYourGuide website, booking portals, and spreadsheets just to plan a trip. This MCP lets your AI client manage complex travel logistics instantly, letting you talk through an entire itinerary as if you were speaking to a human concierge. Need to find the best local food tours in Rome? Your agent can search for activities by keyword or location. Want to know if that tour is free on October 15th? It checks real-time availability. Found the perfect day, but need to secure it? The MCP creates the booking and pulls back confirmation details immediately. You also manage your shopping cart status and check existing reservations. Because this entire system runs through Vinkius, you keep managing all these travel operations without ever leaving your primary workspace. ## Tools ### get_booking_status Checks a specific reservation to confirm if it's active or what its current status is. ### get_cart_details Retrieves detailed metadata about the items currently saved in a shopping cart. ### check_activity_availability Checks specific tour times to see which ones are open and available for booking on a given date. ### get_activity_details Fetches all the descriptive information, like length or meeting points, for a single tour activity. ### list_active_carts Pulls a list of all shopping carts that are currently open or pending checkout. ### list_travel_destinations Shows a full list of cities and regions supported by the platform for travel planning. ### search_by_destination Narrows down search results to only show activities located within a specific city or region. ### search_travel_activities Searches broadly for tours and experiences based on keywords, like 'historical' or 'culinary'. ### cancel_travel_booking Processes the cancellation of an existing booking using its unique identifier. ### verify_api_connection Checks that your access token is valid and that the connection to GetYourGuide works properly. ### create_travel_booking Finalizes a transaction by creating a new reservation for an activity or tour. ### get_partner_details Retrieves key information about your connected partner account identity and settings. ## Prompt Examples **Prompt:** ``` Search for guided tours of the Eiffel Tower in Paris. ``` **Response:** ``` Searching activities... I found several options for the Eiffel Tower, including 'Priority Access Tour' (ID: 123) and 'Summit Guided Tour'. Which one would you like to check availability for? ``` **Prompt:** ``` Is the 'Louvre Museum Skip-the-Line Ticket' available for October 10th? ``` **Response:** ``` Checking availability... Yes, there are 15 slots available for October 10th at various times starting from 09:00 AM. Prices start at $22.00. ``` **Prompt:** ``` Show me the status of my booking 'GYG-ABC-123-XYZ'. ``` **Response:** ``` Fetching booking... Your reservation for the 'Venice Gondola Ride' is 'Confirmed'. The meeting point is San Marco Square at 10:30 AM tomorrow. Would you like the meeting point coordinates? ``` ## Capabilities ### Discover Activities Search for tours or experiences using keywords, specific locations, or map coordinates to find available options. ### Verify Open Slots Check if a specific tour is running on your desired date and time, seeing exactly how many spots are open. ### Book & Confirm Trips Create new reservations for activities or tours using the agent, instantly getting confirmation details back. ### Manage Bookings Retrieve the current status of an existing reservation or cancel a booking entirely using its unique ID. ### Track Shopping Carts List and get details on any active or saved shopping cart items for later review. ## Use Cases ### Building a Multi-City Itinerary A travel coordinator needs to build an itinerary for five days in Italy. Instead of manually checking availability, they ask their agent to find tours using `search_travel_activities` and then use `check_activity_availability` for the top three options, getting real-time results back instantly. ### Last-Minute Booking Changes A client's flight changed, forcing a booking change. The agent first uses `get_booking_status` to confirm the original reservation details, and then uses `cancel_travel_booking` before initiating a new search. ### Checking Corporate Accounts A corporate planner needs to verify if their API connection is working correctly. They call `verify_api_connection` first, confirming the system's operational status before attempting any bookings or data retrieval. ### Handling Pending Sales Leads An agency representative has several clients whose tours are partially booked. The agent can use `list_active_carts` to review all pending shopping cart details, letting them follow up with the client on specific items. ## Benefits - Instead of navigating multiple tabs to find a tour, you simply ask your agent. Use `search_travel_activities` to pull up all options—from guided walks to museum passes—in one conversational turn. - Don't guess if a tour is available; check for sure. You can use `check_activity_availability` to instantly confirm open time slots, knowing exactly when your group can go. - Booking shouldn't be stressful. Use `create_travel_booking` with a simple command and get the final confirmation details without ever hitting 'Submit' yourself. - Need to change plans? You don't have to manually cancel through a web portal. The agent handles it by calling `cancel_travel_booking`, keeping your workflow moving fast. - Manage pending trips easily. If you need to see what items are saved for later, the MCP lets you list active carts using `list_active_carts` and review them instantly. ## How It Works The bottom line is that your AI client becomes an automated travel agent that handles every step from searching to confirmation. 1. First, subscribe to this MCP through the Vinkius Marketplace and provide your GetYourGuide Partner Access Token. 2. Next, tell your AI client what you want to do—like 'Find me a tour in Barcelona next month' or 'Check the status of booking XYZ'. 3. The agent executes the necessary tools, retrieves the live data, and presents actionable results back to you. ## Frequently Asked Questions **How do I search for tours using the GetYourGuide MCP?** You use the `search_travel_activities` tool. This allows you to query broad categories of experiences or specific keywords to find options across global destinations. **Can I check if a tour is available for a different date with GetYourGuide MCP?** Yes, that's exactly what `check_activity_availability` does. You tell it the specific activity ID and the target dates, and it returns real-time vacancy information. **What is the difference between listing carts and booking a tour with GetYourGuide MCP?** Listing active carts (`list_active_carts`) just shows you what's saved for later. Booking a tour requires `create_travel_booking`, which completes the transaction using that cart data. **Does the GetYourGuide MCP help me update my account details?** No, this MCP focuses purely on travel activities and reservations. You can check your partner credentials with `get_partner_details` to ensure connectivity, but it doesn't manage user profiles. **What if I need to find out which cities the GetYourGuide MCP supports?** You simply run the `list_travel_destinations` tool. This provides a comprehensive list of all supported geographic locations you can plan trips for.