# Shared Building Expense Settlement AI Agent Connect > Shared Building Expense Settlement MCP handles the math behind communal building costs. It lets your AI agent calculate specific unit obligations, determine net balances for every participant, and find the most efficient way to move money to settle all debts. It turns messy shared expenses into clear, actionable payment instructions. ## Overview - **Category:** finance - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_9HZq3sCqhpHGrPttzezClD33bZ1B6ByqWRnzxE6x/ai-agent-connect - **Tags:** settlement, expense, building, accounting, finance ## Description Managing shared building expenses usually means a lot of manual math and back-and-forth communication. This MCP changes that by giving your AI client the logic needed to handle communal financial distributions. You can hand off a total expense and a list of unit shares, and your agent will figure out exactly what everyone owes. Once the costs are distributed, the MCP calculates the net position for every unit, showing who is owed money and who needs to pay. It doesn't just stop at the totals; it can also figure out the shortest path of transfers to clear all balances. This prevents unnecessary back-and-forth payments between neighbors. You can also run quick health checks on specific units to see their standing regarding a particular expense. It's a complete settlement engine that moves the heavy lifting from your spreadsheet to your AI agent. ## Tools ### calculate_expense_distribution This tool calculates how much each beneficiary owes based on the total cost and their specific shares. ### get_unit_status_summary Use this to get a high-level financial health report for a specific unit regarding a single expense. ### calculate_settlement_balances This tool determines the net financial position, or the difference between what was paid and what is owed, for every unit. ### optimize_minimum_transfers This tool generates a list of the fewest possible payments needed to settle all outstanding debts. ## Prompt Examples **Prompt:** ``` Calculate the distribution for a $1000 expense where Unit A has a share of 600 and Unit B has a share of 400. ``` **Response:** ``` Unit A owes $600 and Unit B owes $400. ``` **Prompt:** ``` What is the status of Unit 101 if they have a net balance of -50? ``` **Response:** ``` Unit 101 is a Debtor with a total debt of $50. ``` **Prompt:** ``` Generate the minimum transfers for Unit A (balance +100) and Unit B (balance -100). ``` **Response:** ``` Unit B should pay Unit A $100. ``` ## Capabilities ### Cost Distribution Your agent uses this to split a single bill among multiple units based on assigned shares. ### Net Position Tracking The AI calculates exactly who is in the black and who is in the red after an expense. ### Payment Optimization Your agent identifies the most efficient way to move funds to settle all accounts. ### Unit Health Audits The AI checks the financial standing of a specific unit for any given expense. ## Use Cases ### Monthly HOA Dues Distribute monthly maintenance fees across different units based on their square footage or ownership share. ### Emergency Repairs Split a sudden, large repair bill among all building residents quickly and accurately. ### Shared Utility Billing Calculate how much each unit owes for a communal water or electricity bill. ### Debt Settlement Find the most direct way for residents to pay each other back after a shared expense is paid upfront. ## Benefits - Reduces the number of individual transfers needed to settle debts. - Eliminates manual calculation errors in expense distribution. - Provides instant visibility into unit debt or credit status. - Automates the logic for complex multi-party settlements. ## How It Works Connecting this MCP to your AI client gives your agent immediate access to a financial settlement engine. 1. Connect the MCP to your preferred client like Claude or Cursor via Vinkius. 2. Provide the total expense amount and the unit shares to your agent. 3. The agent uses the distribution tool to assign costs to each unit. 4. The agent calculates net balances to see who owes what. 5. The agent generates a minimized list of transfers to settle all accounts. ## Frequently Asked Questions **How does this MCP handle multiple people paying for one expense?** The MCP uses the calculate_settlement_balances tool to determine the net position of every unit, showing who has overpaid and who still owes money. **Can I use this with Claude or Cursor?** Yes, you can connect this MCP to any MCP-compatible client including Claude, Cursor, and Windsurf. **Does it help reduce the number of bank transfers needed?** Yes, the optimize_minimum_transfers tool specifically finds the most efficient payment paths to settle all debts with the fewest possible transactions. **How are expenses split between units?** The calculate_expense_distribution tool splits the total cost based on the specific shares you provide for each beneficiary. **Is there a way to check if a specific unit is behind on payments?** You can use the get_unit_status_summary tool to get a clear overview of a unit's financial health regarding a specific expense. **How does the tool calculate what each unit owes?** The `calculate_expense_distribution` tool takes the total expense and a list of unit shares to determine the exact amount owed by each beneficiary. **Can I minimize the number of bank transfers needed?** Yes, use `optimize_minimum_transfers` to generate a list of the fewest possible payments required to clear all debts. **How do I check if a specific unit has already paid?** You can use `calculate_settlement_balances` to see the `amountPaid` for each unit, or `get_unit_status_summary` for a high-level status.