# Beds24 MCP

> Beds24 MCP connects your AI client directly to Beds24, an European channel manager. You use natural conversation to manage all property details: check room availability, list bookings across channels, update pricing, and view entire properties. It puts complex PMS operations right into your chat window.

## Overview
- **Category:** erp-operations
- **Price:** Free
- **Tags:** channel-manager, property-management, booking-engine, availability-tracking, reservation-management

## Description

Need to know what's available or adjust a rate? This MCP connects your agent to Beds24, handling the core functions of a hotel channel manager. Instead of jumping between multiple tabs—checking property details, then looking up room types, and finally verifying pricing rules—you just ask. Your AI client handles the complexity. You can pull up every property you manage or check specific rooms for real-time open/closed status. Want to see all guest reservations from last month? Just ask to list them. If you need a detailed calendar view, it's here. This gives your agent the full operational picture, making sure you never miss an important booking detail. Because we host this MCP on Vinkius, your client connects once and gets access to this powerful set of tools.

## Tools

### list_properties
Provides an overview listing all properties managed within the system.

### get_property
Gets comprehensive details on one specific property location.

### list_bookings
Generates a list of reservations, useful for reporting and checking recent guest arrivals.

### get_booking
Pulls all detailed information about one single reservation.

### list_rooms
Lists every room type available for a specified property.

### get_calendar
Retrieves the full rate calendar, showing pricing and restrictions for a property by day.

### get_availability
Checks the real-time open or closed status for specific rooms and dates.

### get_account
Retrieves high-level account information related to your Beds24 setup.

## Prompt Examples

**Prompt:** 
```
Show me all bookings arriving this week
```

**Response:** 
```
🛏️ **This Week's Arrivals**

1. **Ocean View Room** — Oct 18-22 | 👤 Hans Mueller | 💰 €420 | Booking.com
2. **Garden Suite** — Oct 19-21 | 👤 Sophie Dupont | 💰 €280 | Airbnb
```

**Prompt:** 
```
Adjust the price for the Ocean View Room to Euro 150 for next weekend.
```

**Response:** 
```
Price adjusted successfully: €150.00 assigned to Ocean View Room covering Friday through Sunday channels.
```

**Prompt:** 
```
Generate a brief occupancy report for yesterday.
```

**Response:** 
```
Yesterday closed with 85% occupancy. 6 out of 7 suites were actively checked in, producing a solid €1400 total revenue.
```

## Capabilities

### Check Property Status
Get detailed information about any property, from its general details down to a list of all rooms it contains.

### Verify Room Availability
Determine the real-time open or closed status for specific room types and check if dates are available for booking.

### Review Reservations
Fetch deep details on a single guest's reservation, or list out all current bookings across your entire portfolio.

### View Pricing and Calendar
Access the room calendar to see rate restrictions, pricing changes, and overall availability by day for specific properties.

## Use Cases

### Handling Last-Minute Rate Adjustments
A revenue director needs to adjust the price for a specific room type. They use their agent to call `get_calendar` first, verify the rate restrictions, and then ask the MCP to update rates for next month across all channels.

### Auditing Guest Reservations
A manager needs to check if a specific guest's booking is correct. They use `get_booking` with the reservation ID, instantly pulling up confirmation details and associated room types without logging into the dedicated portal.

### Checking Portfolio Capacity
The ops team needs to quickly assess capacity across three different locations. They run `list_properties`, then for each one, they call `get_property` and `list_rooms` to generate a master inventory list.

### Identifying Outdated Listings
A marketing person realizes some rooms are listed incorrectly. They use the MCP's capability to check room availability (`get_availability`) against the intended date range to flag any discrepancies immediately.

## Benefits

- Check availability in real-time. Need to know if a room is open? Use `get_availability` to get instant status checks without opening the PMS.
- Quickly view all your assets. Instead of manual searches, use `list_properties` and then `list_rooms` to map out every available room type across your entire portfolio.
- Handle guest inquiries instantly. If a guest asks about their stay, call `get_booking` to retrieve full details right in the chat interface.
- Manage rates easily. Use `get_calendar` to pull up pricing and availability restrictions for any date range before confirming a quote.
- Track all activity. Need an overview? Run `list_bookings` or check `list_properties` to get a broad view of current reservations and managed locations.

## How It Works

The bottom line is you talk to your AI client; it talks to Beds24 MCP, and you get an answer.

1. Start by telling your agent what you need—for example, 'Check availability at Property X'.
2. The MCP calls the necessary tool to pull property data and checks real-time inventory using available tools.
3. Your agent delivers a plain language summary of the results: confirmed rates, open dates, or specific booking details.

## Frequently Asked Questions

**How do I find out if a property exists using `list_properties`?**
You call `list_properties` to get an overview of all managed locations. This returns names and IDs, allowing you to pick the specific Property ID needed for deeper lookups.

**`get_availability` and `get_booking`: Are they related?**
Yes. You should check availability first using `get_availability`. This verifies that a room is open on those dates, which is crucial before you try to confirm or view an existing reservation via `get_booking`.

**Can I see all my rooms with `list_rooms`?**
No. You must first use `get_property` to identify the specific property, and then call `list_rooms` while passing that property's ID as a required parameter.

**What is the best way to check pricing changes? Use `get_calendar` or something else?**
Use `get_calendar`. This tool gives you the full rate calendar, showing restrictions and pricing for every day. It's better than general availability checks when dealing with rates.

**What kind of metadata can I retrieve about my account or connection using `get_account`?**
This tool provides high-level information necessary for system validation. You use it to confirm your active credentials, check the associated property ID, and verify overall account status without needing specific booking data.

**If I need to find all reservations matching a specific date range or guest name, how should I use `list_bookings`?**
`list_bookings` allows you to filter reservation groups based on parameters like dates and names. You pass the required criteria to narrow down thousands of records into manageable lists.

**Beyond just naming a property, what specific details can I pull using `get_property`?**
`get_property` retrieves core metadata about a location. This includes physical addresses, unique identifiers, and general property descriptions that aren't tied to daily bookings or room availability.

**If I first use `list_rooms` to identify a specific room type, how do I then check its real-time status with `get_availability`?**
You take the room ID from the output of `list_rooms` and pass it directly into `get_availability`. This two-step process confirms if that exact room type is open or closed for a given period.

**What is Beds24?**
Beds24 is a versatile channel manager and PMS popular in Europe. Swagger V2 API, competitive pricing from €15.50/month, connects to all major OTAs.

**Can I automatically adjust nightly availability mapping via chat?**
Yes! The system exposes the availability calendar directly to your AI. Just instruct it to close out specific room types or open dates based on channel rules.

**How quick are the price syncing updates to platforms like Booking.com?**
Changes command via MCP execute instantly against Beds24 API v2. From there, Beds24 dispatches the payload to integrated OTAs (Booking, Airbnb) usually within moments.