# Household Member Share AI Agent Connect

> Household Member Share MCP handles the math for shared living expenses. Your AI client uses this MCP to figure out exactly what each person owes, checks if a bill qualifies for splitting based on your house rules, and summarizes how new costs affect your total budget.

## Overview
- **Category:** productivity
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_OzpkaZLtDJ0yHuplDtY4DNyYKcsGibn4YbqW6NQo/ai-agent-connect
- **Tags:** budget, expenses, sharing, household, math

## Description

Managing a shared household shouldn't feel like a math exam. This MCP gives your AI client the specific tools needed to handle group expenses without the manual headache. You can hand off a grocery receipt or a utility bill to your agent, and it will immediately determine the individual split for every person in the house. It doesn't just do the division; it checks if a specific expense actually meets your household's splitting criteria before you commit to a number. If you're worried about how a large one-time purchase will hit your monthly budget, your agent can pull a distribution summary to show the impact. It even acts as a double check, verifying that any manual math you've done matches the system's logic. It's a practical way to keep everyone on the same page regarding what's owed and what's been paid.

## Tools

### calculate_individual_share
This tool determines the exact amount each person owes for a specific bill or expense.

### get_cost_distribution_summary
Your agent uses this to see how a new cost changes the overall household budget distribution.

### validate_expense_eligibility
This tool checks if a cost is actually eligible to be split according to your house rules.

### verify_split_accuracy
Use this to confirm that a manual calculation matches the official split calculated by the MCP.

## Prompt Examples

**Prompt:** 
```
How much does each person owe if the total grocery bill is $150.50 and there are 3 members?
```

**Response:** 
```
Each person owes $50.17.
```

**Prompt:** 
```
Is a $50 utility bill eligible to be split if we only have 1 member?
```

**Response:** 
```
No, the expense is not eligible for splitting because the member count does not meet the minimum threshold.
```

**Prompt:** 
```
Give me a summary for a $200 rent payment split among 4 people.
```

**Response:** 
```
The total expense is $200.00 and the per-person impact is $50.00.
```

## Capabilities

### Individual Cost Splitting
The AI calculates specific amounts owed per person for any given expense.

### Rule-Based Validation
Your agent checks if an expense meets your specific household requirements for splitting.

### Budget Impact Analysis
The AI generates summaries showing how new costs affect the total household budget.

### Calculation Verification
Your agent compares manual math against system calculations to ensure accuracy.

## Use Cases

### Grocery Bill Splitting
Tell your agent the total grocery cost and the number of people to get an instant per-person breakdown.

### Rent and Utility Management
Use the AI to summarize how monthly rent or electricity bills impact the household budget.

### Rule Enforcement
Ask your agent if a specific bill can be split to ensure it follows your established household rules.

### Math Double-Checking
Verify that your own manual split calculations are correct by running them through the MCP.

## Benefits

- Removes manual math errors from shared bill splitting.
- Automates the check for expense eligibility based on house rules.
- Provides instant budget impact summaries for new costs.
- Verifies manual calculations to ensure everyone pays the correct amount.

## How It Works

Connect the MCP to your AI client and start delegating math and budget tasks.

1. Connect your preferred AI client to the Vinkius-hosted MCP.
2. Provide the expense amount and number of members to your agent.
3. The agent uses the tools to calculate or validate the cost.
4. Receive the exact split or budget summary directly in your chat interface.

## Frequently Asked Questions

**How do I use this MCP with my AI?**
You connect your AI client, such as Claude or Cursor, to Vinkius. Once connected, your agent can immediately use the tools provided by this MCP.

**Can the AI check if a bill is eligible to be split?**
Yes, the validate_expense_eligibility tool allows your agent to check if a cost meets your specific household rules for splitting.

**Does this MCP handle the actual money transfers?**
No, this MCP is for calculating, validating, and summarizing costs. It does not move money between bank accounts.

**Can I verify my own math?**
Yes, you can use the verify_split_accuracy tool to make sure your manual calculations match the system's results.

**What happens if I only have one person in the house?**
The tool will use the validate_expense_eligibility function to determine if the expense can be split, which may result in the expense being ineligible if your rules require multiple members.

**How do I calculate what each person owes?**
You can use the `calculate_individual_share` tool by providing the total cost and the number of members.

**Can I check if an expense is eligible to be split?**
Yes, use `validate_expense_eligibility` to check if the current member count meets your household's minimum requirements.

**How accurate are the calculations?**
The system ensures accuracy. You can use `verify_split_accuracy` to confirm that a manual calculation matches the system result within one cent.
