# Bookingmood MCP MCP

> Bookingmood manages your entire rental property portfolio through natural conversation. Check availability across multiple units, create new bookings for guests, update reservation details, and manage all contact information without ever logging into a separate dashboard.

## Overview
- **Category:** productivity
- **Price:** Free
- **Tags:** rental-management, availability-calendar, guest-communication, booking-automation, portfolio-management

## Description

Managing rentals used to mean jumping between three different dashboards: the calendar view, the product inventory list, and the guest directory. Now, you can keep it simple. Connect your account through Vinkius and let your AI agent handle the whole workflow just by talking to it. Need to know if a cabin is free next month? Just ask. Want to add John Doe's reservation and update his contact info at the same time? It happens in one go. The system reads all that data—inventory, availability, bookings, contacts—and gives you clean answers instantly.

## Tools

### create_booking
Creates a brand new reservation in the system.

### delete_booking
Permanently cancels or deletes an existing booking record.

### get_product
Fetches all specific details for a single rental unit.

### list_bookings
Retrieves a list of every current reservation on file.

### list_calendar_events
Shows raw data for all calendar blocks and scheduled events.

### list_contacts
Pulls up the directory of stored guest names and contact details.

### list_products
Lists all available rental units in the portfolio.

### query_availability
Checks if specific products are free on a defined list of dates.

### search_availability
Searches for all available units across a broad date range.

### update_booking
Modifies an existing booking, such as changing the dates or guest name.

## Prompt Examples

**Prompt:** 
```
List all my rental units in Bookingmood.
```

**Response:** 
```
I've retrieved your products. You have 3 rentals active: 'Beachfront Villa' (ID: unit_1), 'Mountain Cabin' (ID: unit_2), and 'City Apartment' (ID: unit_3).
```

**Prompt:** 
```
Check availability for 'Beachfront Villa' for the second week of July.
```

**Response:** 
```
Checking availability for 'Beachfront Villa'... It is currently available from July 8th to July 15th. Would you like to create a tentative booking?
```

**Prompt:** 
```
Show the last 5 bookings received.
```

**Response:** 
```
Retrieving your recent bookings... I found 5 entries, including a confirmed stay for John Doe at 'Beachfront Villa' starting tomorrow and a pending request for 'Mountain Cabin'.
```

## Capabilities

### Check Property Inventory
List every rental unit and get specific details about each product available for booking.

### Find Open Dates
Search across a range of dates to see which products are free, or check availability for units on specific days.

### Create and Manage Stays
Make new reservations, update existing bookings (like changing dates), or cancel them completely.

### Keep Guest Records Straight
Access and manage your directory of guest contacts linked to specific properties or stays.

## Use Cases

### Checking availability for a group event
A property owner needs to know if five different units are free for a corporate retreat next quarter. They ask their agent to `search_availability` across the date range, getting an immediate list of open options so they can book them all in one go.

### Onboarding a new guest
A Property Manager gets a walk-in inquiry. They use the agent to `list_products` to pick a suitable unit, then use `create_booking` and `list_contacts` to log both the stay and the guest info simultaneously.

### Correcting a booking error
A booking was made for the wrong dates. Instead of manually finding the reservation ID, they ask their agent to look up the record and use `update_booking` to change the stay from October 1st to October 5th.

### Auditing calendar conflicts
The owner suspects double-bookings. They run `list_calendar_events` to pull raw data, which helps them confirm exactly what's scheduled and spot any overlaps that need fixing.

## Benefits

- Instead of manually opening the dashboard to see what's open, you can use `search_availability` to check units across a whole month in seconds. You get instant visibility into your entire portfolio.
- Need to book a stay for a new client? Use `create_booking` and link it immediately to their contact information from the `list_contacts` tool—all without leaving your chat window.
- If a guest changes plans, you don't need to call them. Just run `update_booking` through your agent; they handle the modification of dates or details automatically.
- You can quickly see what's coming up by running `list_bookings`, giving you an immediate overview of every active reservation without digging into complex reports.
- The system lets you get detailed product specs using `get_product` and then use that info to guide your booking process, making sure the client knows exactly what they're getting.

## How It Works

The bottom line is, your AI client handles the complicated API calls; you just talk to it like normal.

1. First, subscribe this MCP using your Bookingmood API key in Vinkius.
2. Next, tell your AI agent what you need—for example, 'Check availability for the Beachfront Villa next Friday.'
3. The system retrieves and processes all necessary data, giving you a clear answer right back to your chat window.

## Frequently Asked Questions

**How do I check if a unit is available using query_availability?**
You provide your agent with the specific product ID and the exact date range. The system then confirms whether that particular unit is free during those days, helping you plan quickly.

**How do I list all my units in Bookingmood using list_products?**
Running `list_products` pulls up the full inventory of every rental unit you have. This lets you keep track of everything and know what's rentable.

**What if I need to change a reservation date? Do I use update_booking?**
Yes, that’s right. You use `update_booking` when a guest needs to shift their stay. Just tell the agent what to change and for whom.

**Can I find contact info before booking? Do I need list_contacts?**
Absolutely. If you have an existing client, running `list_contacts` retrieves all stored guest data first. You can then use that to make a seamless new reservation.

**What data inputs does the `create_booking` tool require when reserving a unit?**
You must provide the product ID, start date, end date, and guest details. This action logs the booking into your system and updates real-time availability for that specific rental period.

**If I need to permanently cancel an existing stay, is `delete_booking` the correct tool?**
Yes, use `delete_booking`. This function immediately cancels and removes the reservation record from your entire portfolio. Since this action is permanent, confirm you want to delete it via your AI agent.

**How do I get a comprehensive list of all reservations using `list_bookings`?**
The `list_bookings` tool fetches every reservation record currently held in the system. It’s the best way to audit or review your entire portfolio's occupancy history at once.

**If I need detailed specs on one unit, is it better to use `get_product` than listing all products?**
Using `get_product` is much more efficient. It pulls the full profile and specifications for one specific rental ID. This gives you deep metadata without sifting through every single item.

**Can I check if a rental is available for a specific weekend?**
Yes! Use the `query_availability` tool with the Product IDs. Your agent will check the real-time calendar status in Bookingmood to confirm if the unit is free or booked.

**How do I see the contact details for a guest with a confirmed booking?**
Simply ask the agent to `list_contacts`. You can filter for specific guests linked to bookings to retrieve their names, emails, and phone numbers directly from the directory.

**Does the integration allow updating the price of a rental?**
The current toolset focuses on availability, booking management, and contact oversight. Updating core pricing calendars or complex rate seasons should be done through the Bookingmood dashboard.