# Bill Splitter MCP for precise math. AI Agent Connect

> Bill Splitter MCP handles the messy math of dividing checks among groups. It calculates individual shares, manages tips, and identifies rounding remainders so you don't have to. Your AI client can check if a split is mathematically clean or if someone will end up paying an extra cent.

## Overview
- **Category:** finance
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_FqxyR1Y0emVjvXGKvqZGlK545nRarONOIgdzSWPx/ai-agent-connect
- **Tags:** bill-splitting, calculator, finance-tools, math-utilities, currency

## Description

Dividing a bill among a group is usually simple until you add a tip or try to split an uneven total. This MCP gives your agent the mathematical precision needed to handle currency division without the rounding errors that plague standard calculators. You can use it to figure out exactly what each person owes, including gratuity, or to see if a specific number of people can split a total perfectly. It also tracks the tiny remainders that occur when a bill doesn't divide evenly, ensuring the math always adds up to the cent. Whether you are managing a group dinner or a shared expense, your AI client can now provide clear, actionable breakdowns of what everyone owes.

## Tools

### get_split_details
This tool calculates the specific amount each person owes and identifies any leftover cents from rounding.

### get_split_summary
This tool provides a high level overview of the total cost and the total amount that will be collected from the group.

### get_tip_adjusted_split
This tool calculates individual shares after adding a tip or gratuity to the base bill amount.

### validate_split_feasibility
This tool checks if a bill can be divided perfectly or if it will result in a rounding discrepancy.

## Prompt Examples

**Prompt:** 
```
Split a $50.00 bill among 3 people.
```

**Response:** 
```
Each person owes $16.66, with a rounding remainder of $0.02.
```

**Prompt:** 
```
How much should 4 people pay for a $100 bill including a 20% tip?
```

**Response:** 
```
The total with tip is $120.00, so each person owes $30.00.
```

**Prompt:** 
```
Can I split $20.00 perfectly between 3 people?
```

**Response:** 
```
No, a perfect split is not possible; there will be a remainder of $0.02.
```

## Capabilities

### Tip Calculation
Your agent adds gratuity to the total before dividing the cost.

### Remainder Tracking
The AI identifies the exact cents left over when a bill doesn't divide evenly.

### Feasibility Checks
Your client determines if a split will be mathematically clean.

### Summary Generation
The agent produces a high level overview of total costs and collections.

## Use Cases

### Group Dining
Your agent calculates what each person owes at a restaurant including the tip.

### Shared Travel Expenses
The AI divides the cost of a hotel or rental among multiple travelers.

### Expense Auditing
You use the tool to check if a group split matches the total invoice.

### Budget Planning
The agent uses split summaries to project total collection amounts.

## Benefits

- Eliminates rounding errors in currency division.
- Handles tip and gratuity math automatically.
- Identifies leftover cents in uneven splits.
- Provides instant verification of split feasibility.

## How It Works

Connect the MCP to your client and start asking for math breakdowns.

1. Connect the MCP to your preferred client like Claude or Cursor.
2. Provide the total bill amount and the number of people.
3. Specify if a tip should be included in the calculation.
4. Your agent uses the tools to calculate the exact split and remainders.

## Frequently Asked Questions

**How does this MCP handle rounding?**
It calculates the individual share and identifies the specific rounding remainder left over.

**Can I include tips in the split?**
Yes, the tool specifically calculates splits when a tip or gratuity is added to the bill.

**Will it tell me if a split is uneven?**
Yes, you can use the feasibility tool to check if a split is mathematically clean or will have a remainder.

**What clients can use this MCP?**
Any MCP-compatible client like Claude, Cursor, Windsurf, or VS Code can use these tools.

**Does it work with any currency?**
The tool is designed for currency division and handles the math for decimal-based currency.

**How does the tool handle rounding?**
The tool calculates the per-person amount by rounding down to the nearest cent and provides the `roundingRemainder` as the leftover amount that does not fit into a clean division.

**Can I include a tip in the split?**
Yes, you can use the `get_tip_adjusted_split` tool to calculate the total amount including a tip percentage before splitting the bill.

**What happens if the bill cannot be split perfectly?**
If a perfect split is not possible, the tool identifies the `roundingRemainder`. You can use `validate_split_feasibility` to check if a split will result in a discrepancy.