# Hotel Room Cost Splitter AI Agent Connect

> Hotel Room Cost Splitter handles the messy math of shared stays. It calculates proportional shares based on how many nights each person stays, accounts for taxes and cleaning fees, and generates clear payment instructions so your group can settle up quickly.

## Overview
- **Category:** finance
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_DbLPglfMCnsQTCXWvWPUzcSjtUZJd049mN8QcVEX/ai-agent-connect
- **Tags:** expense-splitting, travel-tools, accommodation, financial-math, group-travel

## Description

When you're traveling with a group, splitting a hotel bill is rarely as simple as dividing the total by the number of people. Different people stay for different lengths of time, and cleaning fees or local taxes can make the math feel unfair. This MCP solves that. You can give your AI client the raw numbers from a booking, and it will handle the heavy lifting. It looks at nights occupied, room types, and specific fees to ensure everyone pays their fair share. Instead of arguing over who owes what, you get a precise breakdown that accounts for every cent. It's built to handle the specific variables of vacation rentals and hotels, including discounts and tax impacts. Once the math is done, your agent can tell you exactly who needs to send money to whom, making the settlement process instant and transparent.

## Tools

### get_payment_schedule
Creates a clear list of transfers required to settle all debts between travelers.

### get_reconciliation_report
Provides a final summary of total costs and individual responsibilities, including adjustments for rounding.

### get_stay_summary
Generates a high-level overview of stay metrics like cost per night and the impact of taxes.

### get_cost_distribution
Calculates how much each person owes based on their specific stay duration and custom fairness weights.

## Prompt Examples

**Prompt:** 
```
Split a $500 room cost with a $50 cleaning fee and 10% tax between Alice (3 nights) and Bob (2 nights).
```

**Response:** 
```
Alice's share is $330.00 and Bob's share is $220.00.
```

**Prompt:** 
```
Generate a payment schedule for Alice who owes $100 and Bob who already paid $100.
```

**Response:** 
```
Alice should transfer $100.00 to Bob.
```

**Prompt:** 
```
What is the cost per night for a $1000 room with a 10% tax and $100 cleaning fee for 4 nights?
```

**Response:** 
```
The cost per night is $300.00.
```

## Capabilities

### Proportional Cost Calculation
Your agent uses stay duration to weight how much each person pays.

### Fee and Tax Accounting
The MCP factors in cleaning fees and taxes into the individual totals.

### Debt Settlement Planning
Your AI client generates specific transfer instructions to clear all balances.

### Rounding Error Correction
The tool handles residual cents to ensure the total matches the actual bill.

### Stay Metric Analysis
Your agent can pull a summary of nightly rates and tax impacts.

## Use Cases

### Multi-night Group Stays
Split a rental where some friends stay for the weekend and others stay for the whole week.

### Vacation Rental Splits
Calculate individual shares for an Airbnb that includes cleaning fees and service charges.

### Debt Settlement
Turn a list of who paid what into a simple list of who needs to pay whom.

### Budget Planning
Get a summary of nightly costs and tax impacts before the trip even starts.

## Benefits

- Eliminates manual math for complex hotel bills.
- Accounts for varying stay lengths per person.
- Includes cleaning fees and taxes in the final split.
- Provides clear transfer instructions for settling debts.

## How It Works

Connect your client to Vinkius and start splitting bills through your chat interface.

1. Connect your MCP-compatible client to the Vinkius catalog.
2. Provide the booking details like total cost, taxes, and fees to your AI client.
3. Tell the agent how many nights each person is staying.
4. The MCP calculates the proportional distribution.
5. Request a payment schedule to see the final transfers needed.

## Frequently Asked Questions

**How does the MCP handle different stay lengths?**
It uses the number of nights each person occupies the room to calculate a proportional share of the total cost.

**Does it include cleaning fees and taxes?**
Yes, the tool is designed to incorporate cleaning fees, taxes, and discounts into the final calculation.

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

**How do I settle the money once the math is done?**
You can use the payment schedule tool to generate a list of specific transfers needed to settle all debts.

**What happens with rounding errors?**
The reconciliation report tool handles rounding residuals to ensure the individual totals match the actual bill.

**How does the tool handle different stay lengths?**
The `get_cost_distribution` tool uses the number of nights stayed by each person to calculate their proportional share of the total cost.

**Can I make certain people pay more or less?**
Yes, you can use fairness weights in `get_cost_distribution` to adjust a person's share regardless of their stay duration.

**How are rounding errors handled?**
You can use `get_reconciliation_report` to identify the residual difference caused by currency rounding and assign it to a designated leader.
