# Hostaway MCP

> Hostaway connects your AI client directly to leading vacation rental data across all major booking platforms. Manage property listings, check availability calendars, track reservations from Airbnb, Booking.com, VRBO, and direct channels. Review guest conversations and financial records—all in one conversation.

## Overview
- **Category:** ecommerce
- **Price:** Free
- **Tags:** channel-manager, vacation-rentals, reservation-management, booking-sync, guest-communication

## Description

Running a portfolio of rental properties means juggling dozens of dashboards, each showing different bookings, rates, and messages. You shouldn't have to log into five different systems just to answer a basic question about availability or revenue. This MCP pulls all that data together. Your agent uses this connection to read property listings, check reservations across every channel, monitor the live calendar for accurate pricing, and even review guest conversations from any platform. Need to know how much money came in last month? It tracks financials automatically. Everything you need—from checking sync status on connected channels to getting a full revenue breakdown—comes back instantly through your AI client. This integration makes managing complex properties manageable right from the Vinkius catalog.

## Tools

### list_listings
Retrieves a list containing details for all your managed vacation rental properties.

### get_listing
Fetches detailed information and specific data points about one particular property unit.

### list_reservations
Lists all upcoming or past bookings across your connected platforms.

### get_reservation
Retrieves specific details for one particular booking, including dates and guest names.

### get_calendar
Provides a full availability calendar view for revenue management, showing daily rates and min stay rules.

### list_channels
Checks the sync status across all connected booking channels like Airbnb, VRBO, and your direct site.

### list_conversations
Gathers a single feed of recent guest messages from every platform into one list.

### get_financials
Calculates and reports the financial data, including payouts and commission breakdowns for reservations.

## Prompt Examples

**Prompt:** 
```
Show me all reservations arriving this week and their revenue
```

**Response:** 
```
🏠 **This Week's Arrivals**

1. 📍 **Beach Villa** — Oct 18-22
   👤 John Smith | 💰 $1,200 | 📱 Airbnb

2. 📍 **Downtown Loft** — Oct 19-21
   👤 Maria García | 💰 $480 | 🌐 Direct

💰 **Total Revenue**: $1,680
```

**Prompt:** 
```
List the upcoming check-outs for tomorrow.
```

**Response:** 
```
You have 3 check-outs scheduled for tomorrow: Room 101 (Airbnb), Beach House (Booking.com), and City Apartment (VRBO). I've notified the cleaning staff for turnover.
```

**Prompt:** 
```
Update the base price for the Beach Villa to $350 for next month.
```

**Response:** 
```
I have updated the base nightly price for the Beach Villa to $350 for the entire next month across all connected channels (Airbnb, VRBO, Booking.com).
```

## Capabilities

### Get detailed property listings
You retrieve comprehensive data points for every rental unit, including photos and amenities.

### View all bookings and reservation details
The system lists upcoming reservations or fetches the specifics of a single booking across platforms.

### Check real-time availability calendars
You pull up a day-by-day calendar showing accurate occupancy, pricing adjustments, and minimum stay requirements.

### Review connected channel status
You check if all your booking platforms are properly synced with each other and the central system.

### Monitor guest conversations
The agent retrieves a unified feed of messages, allowing you to track every conversation from any source.

### Calculate revenue and financials
You get a breakdown of total revenue, commissions, and payout data for specific periods.

## Use Cases

### Checking availability for an upcoming corporate group booking
The agent needs to confirm if three properties are available next quarter. It uses get_calendar on all relevant units and then cross-references list_listings to ensure the correct amenities are highlighted in the final report.

### Handling a pricing dispute with an existing guest
A guest asks about their last stay's total cost. The agent runs get_financials and pulls up the relevant payment details, providing the exact breakdown to resolve the issue immediately.

### Catching up on missed guest messages after a vacation
You just got back in town and need to know what guests asked over the last week. The agent uses list_conversations, gathering every message from Airbnb, Booking.com, etc., into one actionable summary.

### Auditing a property's setup for consistency
The owner wants to know if all properties are correctly listed and synced. The agent runs list_listings followed by list_channels to confirm that every unit has up-to-date details across the board.

## Benefits

- Centralized Guest Communication: Instead of logging into multiple platforms to check messages, the agent uses list_conversations to give you every guest message in a single view. You never miss an inquiry again.
- Total Financial Clarity: Stop guessing about revenue. The get_financials tool gives you a precise breakdown of total income, commissions, and payouts for any given period.
- Immediate Availability Checks: Need to know if a property is open next month? get_calendar provides a day-by-day view instantly, helping you manage pricing and minimum stay rules without manual checks.
- Accurate Booking Tracking: You can list_reservations or use get_reservation to pull up specific booking details quickly. This saves time compared to navigating through multiple platform dashboards.
- System Sync Status: The list_channels tool confirms your connectivity. Before you trust the data, confirm that all channels are reporting accurate sync status.
- Comprehensive Property View: Combining list_listings and get_listing lets you pull up a full profile of any property—amenities, photos, and basic details—without leaving the chat interface.

## How It Works

The bottom line is that your AI agent handles the complex data fetching across dozens of platforms, so you just get a simple answer in the chat window.

1. Connect your AI client to Vinkius and authorize Hostaway access credentials.
2. Tell your agent exactly what you need—for example, 'Show me the bookings for Beach Villa next week.'
3. The MCP executes multiple tool calls (like listing reservations or checking availability) and synthesizes all the necessary data into one clear response.

## Frequently Asked Questions

**Can Hostaway MCP list_listings all my properties?**
Yes, calling list_listings retrieves details for every property unit under your management portfolio. This is how your agent gets a complete overview of everything you own.

**Does the Hostaway MCP handle rate changes across platforms?**
The MCP primarily reads data; it uses get_calendar to retrieve current pricing and availability rules. You must use your native booking platform tools to update rates, but the MCP can read those updates for you.

**How do I check if my channels are synced using Hostaway?**
You run list_channels. This tool reports on the sync status across all connected platforms (Airbnb, VRBO, etc.), telling you exactly where data might be inconsistent.

**Can I get reservation financials with Hostaway MCP?**
Yes, calling get_financials pulls together comprehensive revenue reports. You can track breakdowns of commissions and payouts for specific booking periods.

**What is the difference between list_reservations and get_reservation?**
list_reservations gives you a summary view of many bookings (like a roster). get_reservation lets you drill down into one single booking to see all its specific details.