# FareHarbor MCP for AI Agents AI Agent Connect > FareHarbor lets you manage tour and activity bookings through your AI agent. You can check real-time availability, create new reservations, and manage operator data without switching tabs. It connects your affiliate or partner account directly to your workflow, making it easy to handle customer requests for travel experiences. ## Overview - **Category:** ecommerce - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_YqamNF4L2UT8zQNMrxa3DPPc6uG70HAdXcyPe85S/ai-agent-connect - **Tags:** booking-engine, tour-management, activity-reservations, inventory-availability, online-payments, travel-tech ## Description This Connector gives your AI agent direct access to your FareHarbor account to handle the heavy lifting of tour and activity management. Instead of jumping between different browser tabs to check if a specific excursion is full or to manually input customer details into a booking form, you can just ask your agent to do it. You can pull up a list of authorized operators, check specific dates for tours, and grab the exact pricing and capacity for various time slots. When a customer is ready to commit, your agent can create the booking for you using the correct ticket types and customer info. It also makes it easy to pull up recent reservation statuses or look into specific booking details using a UUID. By using this Connector through the Vinkius catalog, you turn your AI into a functional travel concierge that knows your inventory inside and out. You get to stop copy-pasting data between spreadsheets and booking engines and start answering customer questions with actual, real-time data. ## Tools ### get_availability Get the exact details for a specific time slot. Use this to see if a tour is actually open for a requested time. ### get_booking Retrieve full details for a specific booking using its UUID. This is how you check the status of an existing reservation. ### list_bookings List the most recent bookings for a company. This helps you keep an eye on the latest activity in your account. ### list_availabilities_by_date List all open slots for a specific tour on a single day. This is perfect for showing customers options for a specific date. ### list_availabilities_by_range List all open slots for a tour over a period of time. Use this when customers are flexible with their travel dates. ### create_booking Create a new reservation for a specific tour or activity. This handles the core task of securing a spot for a customer. ### get_item_details Get the specific information for a tour or activity. This helps your agent understand what a specific tour includes. ### get_me Get the identity of the current API user. This verifies your account credentials are active and correct. ### list_companies List all authorized tour companies in your network. This lets your agent know which operators you can book for. ### list_items List all tours or activities for a specific company. This shows your agent the full menu of options for an operator. ### list_lodgings List the lodging or pickup locations for a company. Use this to give customers clear instructions on where to meet. ## Prompt Examples **Prompt:** ``` Can you see if there are any spots left for the Sunset Cruise tomorrow? ``` **Response:** ``` I checked the availability for the Sunset Cruise tomorrow. * **Departure:** 6:00 PM * **Spots Remaining:** 4 Would you like me to book one of these for you? ``` **Prompt:** ``` What are the options for mountain tours next week? ``` **Response:** ``` Here are the available mountain tours for next week: | Tour Name | Dates Available | | :--- | :--- | | Peak Trek | Oct 12, Oct 14 | | Valley Hike | Oct 13, Oct 15 | Would you like more details on any of these? ``` **Prompt:** ``` Check the status of booking UUID 998877. ``` **Response:** ``` I've pulled up that reservation. * **Status:** Paid * **Tour:** Island Hop * **Scheduled:** Friday at 10:00 AM The guest is all set for their trip. ``` ## Capabilities ### Create tour reservations Book a new activity for a customer with specific ticket types. ### Check real-time availability See how many spots are left for a specific date or range. ### Retrieve booking statuses Look up the details and current status of a past or current reservation. ### List tour operators See every authorized company in your network. ### Fetch tour details Get specific information about a tour or activity item. ### Identify user credentials Verify your account identity and affiliate status. ## Use Cases ### Checking tour availability during a chat A travel agent is chatting with a client who wants a whale watching tour. The agent asks for availability tomorrow. The AI uses list_availabilities_by_date and shows the 9 AM and 2 PM slots. ### Building a custom travel concierge An OTA developer wants to build a concierge. The AI uses list_companies and list_items to show a menu of all available tours to a user on their website. ### Verifying a missing confirmation A customer calls about a missing confirmation. The agent uses get_booking with a UUID to check if the status is Paid and sends a follow-up. ### Monitoring operator capacity An operations lead needs to know if a specific tour is full. The AI uses get_availability to check the remaining capacity for a specific time. ## Benefits - Stop manual data entry by using create_booking to put reservation details into FareHarbor directly from a chat. - Provide instant answers to customers by using list_availabilities_by_range to show them open dates quickly. - Reduce booking errors by using get_item_details to ensure your agent has the correct tour information before confirming. - Monitor your business more easily by using list_bookings to see recent activity without logging into a dashboard. - Give customers clear directions by using list_lodgings to find specific pickup locations for their tours. ## How It Works The bottom line is you get a conversational interface for your entire FareHarbor booking engine. 1. Subscribe to the FareHarbor MCP on Vinkius. 2. Add your App Key and User Key from your FareHarbor support email. 3. Ask your AI client to check tour availability or book a spot. ## Frequently Asked Questions **Can the FareHarbor MCP book tours for my customers?** Yes, it lets your AI agent create new bookings directly in FareHarbor using customer details and ticket types. **How do I check tour availability with FareHarbor?** Your agent can look up specific dates or ranges to see exactly how many spots are left for any tour. **Can I use FareHarbor to manage my tour operator list?** This Connector lets you list all authorized companies and their specific tour items in your network. **Can I see the status of a specific reservation?** Yes, you can provide a booking UUID to your agent, and it will pull up the current status and details. **Does FareHarbor MCP work for travel affiliates?** It is designed specifically for affiliates and partners to manage bookings through a natural language interface. **Can I find pickup locations using FareHarbor?** The tool can list specific lodging or pickup locations for any company in your network. **How do I request FareHarbor API access?** API access is not public. You must email support@fareharbor.com with your business use case to receive your unique App Key and User Key. **Is there a sandbox environment for testing?** Yes, FareHarbor provides a demo environment at demo.fareharbor.com. You can use this host with your sandbox credentials to test bookings safely. **What is a 'shortname' in FareHarbor?** A shortname is a unique identifier for a specific tour operator or company on the FareHarbor platform. You can find it in the company metadata or dashboard.