# Guesty MCP > Guesty MCP connects your AI agent directly into the Guesty property management platform. Manage every aspect of your vacation rentals—from checking availability and listing performance to retrieving owner revenue statements and guest chat history. Stop jumping between tabs; handle reservations, bookings, and operations all through natural conversation. ## Overview - **Category:** erp-operations - **Price:** Free - **Tags:** vacation-rentals, reservation-management, booking-engine, property-listings, calendar-sync ## Description Running a portfolio of rental properties means juggling dozens of screens: one for Airbnb, another for VRBO, and yet another for accounting. This MCP lets you talk to your entire operation instead. You can ask your agent things like, 'What are the net payouts for Q2?' or 'Is Listing 5520 available next month?' The system handles fetching booking details, checking current task lists, and pulling performance stats from all connected platforms. If you're already using Vinkius to manage other APIs, adding Guesty means your AI agent becomes a single source of truth for your entire rental business. You can get owner statements, review guest communication logs, and list out every active booking with a simple prompt. ## Tools ### get_accounting_stats Retrieves a summary of your business's financial accounting statistics. ### get_calendar Checks the availability and pricing calendar for any specific property listing. ### get_listing_stats Pulls performance metrics and statistics for a single, chosen property listing. ### get_listing Gathers all the core details about a specific property listing. ### get_owner_revenue Returns detailed owner statements, including gross revenue, expenses, commissions, and net payouts. ### get_reservation Gets comprehensive details for one specific booking or reservation ID. ### list_guests Finds guest profiles by searching using a name or email address. ### list_listings Generates a complete list of every property you manage through Guesty. ### list_messages Retrieves the full chat history between guests and management, optionally filtering by guest ID. ### list_reservations Lists all bookings, allowing you to filter results by status like 'confirmed' or 'cancelled'. ### list_tasks Provides an overview of required cleaning and operational tasks for your properties. ## Prompt Examples **Prompt:** ``` List all confirmed reservations for next week. ``` **Response:** ``` I've retrieved your reservations. You have 8 confirmed bookings for next week, including 'Beachfront Villa' (ID: 7701) and 'City Loft' (ID: 7705). Would you like to see the guest details for any of these? ``` **Prompt:** ``` Check availability for listing ID 5520 from April 10th to 15th. ``` **Response:** ``` Checking calendar... Listing 5520 is AVAILABLE from April 10th to 15th. The average nightly rate for this period is $185.00. Should I check the guest history for this property? ``` **Prompt:** ``` Show me the accounting stats for this month. ``` **Response:** ``` Accessing accounting data... For this month, your gross revenue is $12,450.00 across 15 properties. Total commissions are $1,867.50 and net payout is $10,582.50. Would you like a breakdown by property? ``` ## Capabilities ### Monitor property performance Get detailed statistics on any specific listing or check the overall accounting summary for your entire portfolio. ### Manage bookings and availability List all current reservations, find out which properties are free, and determine the average nightly rate for a date range. ### Handle guest communications Search for specific guests or view their entire communication history with the property managers. ### Oversee operations and tasks Check if cleaning, maintenance, or other operational tasks are completed across your properties. ### Analyze financial data Retrieve owner statements detailing gross revenue, commissions, expenses, and final net payouts for owners. ## Use Cases ### Preparing for a large group arrival A property manager needs to confirm if 10 units are available next month and whether any of those reservations have outstanding maintenance issues. They ask their agent, which runs `get_calendar` and then `list_tasks`, getting one consolidated report on availability and required prep work. ### Auditing owner payments An investor needs to reconcile last quarter's income against the expected commission rates. They instruct their agent to pull reports using `get_owner_revenue` and then cross-reference it with the full accounting picture via `get_accounting_stats`. ### Handling a guest complaint A manager gets a complaint about noise from a specific unit. They ask their agent to find the guest's profile using `list_guests`, review the chat history via `list_messages`, and confirm the unit details with `get_listing`. ### Checking operational status after an outage The operations team needs a full picture of all booked units. They prompt the agent to run `list_reservations` filtered by 'stayed' status, and then use `get_listing_stats` on each one to see its utilization rate. ## Benefits - Stop manual data aggregation. Instead of exporting booking lists and then pasting them into a spreadsheet to calculate occupancy rates, simply ask the agent to run `list_reservations` and get actionable data instantly. - Know your money trail immediately. You don't need to wait for month-end reports; asking for owner statements using `get_owner_revenue` gives you net payout figures on demand. - Never miss a maintenance item again. By listing tasks with `list_tasks`, the agent shows you exactly what needs cleaning or fixing, giving your team clear priorities right when they need it. - Instant property deep dives. Need to know if a specific unit is profitable? Use `get_listing_stats` for performance data, then use `get_calendar` to confirm availability and pricing simultaneously. - Customer service triage is faster. If a guest calls with an issue, asking the agent to check their details via `list_messages` lets you see the whole communication history without logging into the chat platform. ## How It Works The bottom line is that your AI agent acts like a dedicated operations coordinator, gathering complex data from Guesty without you ever needing to write code or navigate multiple dashboards. 1. Subscribe to this MCP on Vinkius and enter your Guesty Client ID and Client Secret. 2. Connect your preferred AI client (like Claude or Cursor) using the Vinkius connector. 3. Tell your agent what you need. For example, 'Show me all confirmed reservations next week,' and the system executes the necessary calls. ## Frequently Asked Questions **How do I check a property's availability using Guesty MCP?** You use the `get_calendar` tool. Just ask your agent for the calendar details of a specific listing ID, and it will return the available dates and pricing range for you. **Can I find out owner revenue using Guesty MCP?** Yes, use `get_owner_revenue`. This tool pulls detailed statements showing gross revenue, commissions, expenses, and your final net payout figures in one place. **What is the best way to check guest communication history with Guesty MCP?** Use `list_messages`. You can search for a specific guest's ID or name and retrieve their entire message log, helping you resolve issues quickly. **Does Guesty MCP help me manage maintenance tasks?** Yes. The `list_tasks` tool provides a clear overview of all necessary cleaning and operational jobs across your properties, ensuring nothing gets missed. **How do I get details on an entire property listing with Guesty MCP?** Use the `get_listing` tool. This call pulls every core detail about a specific unit, from its amenities list to its management history.