# Hotel Room Night Calculator AI Agent Connect

> Hotel Room Night Calculator MCP gives your AI agent the ability to process hotel inventory data. It handles the math for room nights, compares usage between different stays, and aggregates totals for large groups. You can also check if specific stay dates fall within your required booking windows.

## Overview
- **Category:** productivity
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_4uJOn7bWn6XPVXvgKeN1SfuB2kor0NpEcmuesJPq/ai-agent-connect
- **Tags:** hotel, room-nights, occupancy, revenue-management, analytics

## Description

Managing hotel inventory requires constant math on occupancy and stay durations. This MCP moves those calculations from your manual spreadsheets directly into your AI client. Instead of manually counting nights for every reservation, you can ask your agent to handle the heavy lifting. 

Whether you are looking at a single booking or trying to sum up totals for a massive group, this tool provides the exact numbers you need. You can use it to verify if a guest's requested dates fit within a specific block or compare how much room usage differs between two separate stays. It is built to take the friction out of revenue management and occupancy tracking by turning your AI into a specialized hospitality math engine.

## Tools

### aggregate_group_room_nights
This tool sums up the total room nights for a collection of multiple bookings.

### calculate_stay_room_nights
Use this to find the total number of room nights for a single reservation based on occupancy.

### compare_room_usage
This tool evaluates the difference in room consumption between two different stays.

### validate_stay_bounds
This tool checks if a set of stay dates falls within a specific time range.

## Prompt Examples

**Prompt:** 
```
Calculate the room nights for 3 rooms from 2024-05-01 to 2024-05-05.
```

**Response:** 
```
The total room nights for this stay is 12.
```

**Prompt:** 
```
Compare a stay with 10 room nights to a stay with 15 room nights.
```

**Response:** 
```
The second stay is larger by 5 room nights.
```

**Prompt:** 
```
Is a stay from 2024-06-01 to 2024-06-03 within the range 2024-05-01 to 2024-07-01?
```

**Response:** 
```
Yes, the stay is within the specified range.
```

## Capabilities

### Stay Math
Your agent calculates exact room night totals for individual or group bookings.

### Usage Comparison
The AI compares room consumption levels between different reservation sets.

### Date Validation
Your client verifies if requested stay dates fit inside a target window.

### Group Aggregation
The tool sums up room nights across many different bookings at once.

## Use Cases

### Group Booking Totals
Sum up the total room nights for an entire wedding block or corporate event.

### Occupancy Comparison
Compare how much room inventory a specific group is using versus another.

### Booking Window Checks
Confirm if a guest's requested dates are valid for a specific seasonal block.

### Single Reservation Math
Get the exact room night count for a single booking instantly.

## Benefits

- Removes manual math errors from occupancy calculations.
- Speeds up group booking totals via automated aggregation.
- Provides instant date validation for reservation requests.
- Enables direct comparison of room usage between stays.

## How It Works

You connect the MCP to your preferred client and start asking questions about hotel stays.

1. Connect the MCP to Claude, Cursor, or Windsurf via Vinkius.
2. Provide stay dates and room counts to your AI client.
3. The AI invokes the specific tool needed for the calculation.
4. Your agent receives the result and presents the final number.

## Frequently Asked Questions

**What can this MCP calculate?**
It calculates total room nights for single stays, aggregates totals for groups, and compares usage between stays.

**Can I use this with Claude?**
Yes, you can connect this MCP to any compatible client like Claude, Cursor, or Windsurf.

**How does it handle group bookings?**
It uses the aggregate_group_room_nights tool to sum up totals for multiple bookings.

**Does it check if dates are valid?**
Yes, the validate_stay_bounds tool checks if stay dates fall within a specific period.

**Do I need to host the MCP myself?**
No, Vinkius hosts and manages the MCP for you, so it is ready to use immediately.

**How do I calculate room nights for a single guest?**
You can use the `calculate_stay_room_nights` tool by providing the number of rooms occupied and the check-in and check-out dates.

**Can I sum up room nights for a whole group?**
Yes, the `aggregate_group_room_nights` tool allows you to sum the total room nights for a collection of different stays.

**How can I check if a stay is within a specific date range?**
Use the `validate_stay_bounds` tool to verify if the arrival and departure dates fall within your specified range.