# Household Bill Splitter AI Agent Connect

> Household Bill Splitter MCP handles the math and tracking for shared living expenses. Your AI client uses this to identify residents, calculate individual shares for specific bills, log payments, and monitor who owes what. It removes the friction of manual expense tracking by letting your agent manage the ledger directly.

## Overview
- **Category:** finance
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_Pnj2Y2PRmLdCTXbyPgG9SzItwzT6GUUhbLBHBIO1/ai-agent-connect
- **Tags:** bills, expenses, residents, splitting, accounting

## Description

Managing a shared household shouldn't feel like a part-time accounting job. This MCP gives your AI client the ability to act as a household bookkeeper. Instead of manually calculating splits or chasing roommates for money, you just tell your agent what was spent. 

You can use this to pull a list of everyone living in the house, figure out exactly what each person owes for a new utility bill, and record payments as they happen. The MCP keeps a running tally of everyone's financial standing, so you always know if someone is in the red or has a credit. It's a direct way to turn your AI agent into a tool that manages the actual math of shared living, ensuring everyone pays their fair share without the constant back-and-forth.

## Tools

### get_resident_list
This tool pulls the current list of people registered in your household.

### calculate_equal_split
Use this to find out the exact amount each resident owes for a specific bill.

### get_resident_balances
This tool provides a summary of the current financial standing for every person in the house.

### record_bill_payment
This tool logs a processed bill and assigns the corresponding debt to the residents.

## Prompt Examples

**Prompt:** 
```
Who are the residents in household ID 123?
```

**Response:** 
```
The residents in household 123 are Alice and Bob.
```

**Prompt:** 
```
How much should each person pay for a $150.50 electricity bill in household 123?
```

**Response:** 
```
Each resident owes $75.25.
```

**Prompt:** 
```
Record a rent payment of $2000 for household 123.
```

**Response:** 
```
The rent payment of $2000 has been successfully recorded for household 123.
```

## Capabilities

### Resident Management
Your agent identifies who is part of the household to ensure accurate splits.

### Automated Math
The MCP calculates equal shares for any bill amount you provide.

### Debt Tracking
Your agent monitors resident balances to see who owes money or has credits.

### Expense Logging
The tool records bill payments and updates the household ledger immediately.

## Use Cases

### Monthly Utility Splitting
Tell your agent the total for the water bill, and it will calculate the equal share for every resident.

### Rent Tracking
Record monthly rent payments to keep an accurate history of what has been paid.

### Debt Monitoring
Check the current financial standing of all residents to see who needs to settle up.

### New Resident Onboarding
Use the resident list to ensure all current occupants are accounted for in the next bill cycle.

## Benefits

- Eliminates manual math errors during bill splitting.
- Maintains a real-time ledger of resident debts and credits.
- Centralizes household expense tracking within your AI chat interface.

## How It Works

Get up and running by connecting your client to the Vinkius hosted MCP.

1. Connect your MCP-compatible client to Vinkius.
2. Identify your household and residents using the provided tools.
3. Input bill amounts to calculate equal splits.
4. Record payments to update the ledger and resident balances.

## Frequently Asked Questions

**How do I split a bill with this MCP?**
You can ask your AI client to use the calculate_equal_split tool after providing the bill amount.

**Can I see who owes money?**
Yes, use the get_resident_balances tool to see the financial standing of every resident.

**Which AI clients can I use?**
You can use any MCP-compatible client like Claude, Cursor, or Windsurf.

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

**How are debts assigned?**
When you use the record_bill_payment tool, the debt is automatically assigned to the residents.

**How are the bills divided?**
The total bill amount is divided equally among all registered residents in the household.

**How can I see who owes money?**
You can use the `get_resident_balances` tool to see the current financial standing and outstanding debts for every resident.

**Can I record different types of bills?**
Yes, you can use `record_bill_payment` to log any expense, such as rent, electricity, or one-time repairs, by providing a description.