# Amenitiz MCP

> Amenitiz MCP connects any AI agent directly to your Property Management System data. It lets you manage hotel reservations, check room availability, modify rates, and track guest profiles through natural conversation. You get a complete view of property status—from checking individual rooms to listing entire reservation histories.

## Overview
- **Category:** ecommerce
- **Price:** Free
- **Tags:** pms, hotel-booking, reservation-management, channel-manager, guest-profiles, availability-tracking

## Description

This connector makes managing a hotel's operations conversational. Forget navigating multiple tabs in the PMS interface just to find out if there’s an open room or what the rate is for next month; your agent handles that, period. You can ask about availability across different room types, check seasonal rates, and pull up specific guest histories by name. The system gathers everything—current reservations, property details, and even individual room statuses (clean, dirty, occupied)—and presents it to you instantly. If you’re using Vinkius for your catalog of external tools, Amenitiz provides the core operational data needed for any modern booking engine. It gives your agent access to the full guest database so staff can handle everything from simple inquiries to complex reservation modifications without ever leaving their chat interface.

## Tools

### list_reservations
Retrieves a list of multiple hotel reservations within a date range or for a property.

### get_reservation
Retrieves the full details for a single, specific reservation ID.

### list_room_types
Provides an inventory listing of all defined room categories and their base amenities.

### list_rooms
Lists the current status (clean, dirty, occupied) for every individual physical room in the hotel.

### get_availability
Calculates room availability for specific date ranges across the property.

### get_rates
Fetches current or historical room rates based on criteria like dates or promotions.

### list_guests
Lists all saved guest profiles and historical visit data.

### get_property
Retrieves general information and details about the hotel property.

## Prompt Examples

**Prompt:** 
```
What rooms are available for next weekend and at what rates?
```

**Response:** 
```
🏨 **Availability — Oct 19-21**

1. 🛏️ **Deluxe Double** — 3/5 available | €149/night
2. 🛏️ **Superior Suite** — 1/2 available | €229/night
3. 🛏️ **Standard Single** — 4/6 available | €89/night

💡 Most popular: Deluxe Double (60% occupancy)
```

## Capabilities

### Check room availability
It tells you which rooms are free for specific dates and how many spots are open by category.

### Get pricing information
You can retrieve current, seasonal, or promotional rates for any given time period.

### Review booking details
The MCP pulls up all reservation records, including guest names, dates of stay, and payment status.

### List property information
It provides general data about the hotel itself, useful for setting context or validating details.

### Manage guest records
You can list and view detailed profiles of past and current guests within the system's database.

## Use Cases

### The Reservation Inquiry
A client asks, 'Do you have a suite available for four people next month?' Your agent uses `list_room_types` to confirm the category exists, then calls `get_availability` and `get_rates` to return three concrete options with pricing. The booking is confirmed in minutes.

### The Housekeeping Report
A manager needs a quick status check for all rooms today. They ask the agent, and it immediately runs `list_rooms`, returning a real-time count of how many units are currently marked 'dirty' or 'occupied'.

### The VIP Welcome
A front desk employee needs to process an upgrade for a repeat guest. The agent uses `list_guests` to pull up the history, then calls `get_property` and `get_rates` to confirm the best available room type and its associated cost.

### The Data Sync Check
A developer building a booking widget needs to validate all current rates. They use `list_room_types` followed by `get_rates` to pull a comprehensive, structured data set of every active room type and its pricing tiers.

## Benefits

- Instantly check availability: Instead of checking a grid calendar, your agent runs `get_availability` and tells you exactly which room types have open capacity for the next quarter. You don't waste time cross-referencing sheets.
- Understand pricing complexity: Use `get_rates` to compare seasonal changes or promotional packages instantly. This helps revenue teams adjust pricing without logging into the rate management module.
- Review guest history on demand: Pulling up a guest profile using `list_guests` means staff can see past stays and preferences right in the chat, improving service immediately.
- Track physical room status: The MCP lets you run `list_rooms`, giving you an accurate count of which specific rooms are dirty or occupied—essential for housekeeping coordination.
- Handle booking changes efficiently: If a client needs to modify dates, your agent can first check the existing details with `get_reservation` and then confirm new availability using `get_availability` in one go.

## How It Works

The bottom line is that your agent executes a defined sequence of API calls behind the scenes until it has all the necessary data for a complete answer.

1. Your AI agent first calls `get_property` to establish basic context about the hotel or location.
2. Next, it runs `list_room_types` and then uses `get_availability` to check open dates and room counts.
3. Finally, you can call `get_reservation` or `list_reservations` to pull concrete booking data using the gathered context.

## Frequently Asked Questions

**How do I check room availability using get_availability?**
You provide the desired dates and criteria (like number of guests or room type). The tool returns a specific count of available rooms, making sure you don't overbook.

**Can I find out what rates are for different seasons with get_rates?**
Yes. You just need to tell the agent the date range or season. It pulls all applicable pricing and promotions, helping revenue managers plan ahead.

**What is the difference between list_rooms and get_availability?**
`list_rooms` shows the physical status of every room right now (clean/dirty). `get_availability` checks if a category of rooms will be open over a future date range.

**How do I retrieve reservation details using get_reservation?**
You give the agent a booking ID or guest name. It then runs `get_reservation` and hands you every detail about that specific stay, including payment status.

**When I run list_room_types, what details about the capacity and amenities will I get?**
It returns a defined catalog of all available room categories. You'll see core data like base rates, maximum occupancy, and specific amenity lists for each type.

**How can I use list_guests to manage guest profiles or check historical visit details?**
You retrieve a comprehensive database of all associated guests. This includes their contact info, billing preferences, and records of previous stays at the hotel property.

**What scope of information does get_property provide about the overall hotel location or setup?**
It pulls foundational details specific to the establishment itself. You can use this tool to verify basic operational data like address, property name, and general service parameters.

**If I need to list many bookings, how does list_reservations handle large volumes of data?**
The MCP uses pagination controls. If the initial request exceeds a set limit, you simply provide the next page token in your follow-up call to continue fetching all records.

**What is Amenitiz?**
Amenitiz is an all-in-one PMS for independent hotels — website builder, booking engine, channel manager, and operations management. Popular across Europe with 10,000+ hotels.