Split the bill without the awkward math.
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
Use this when a group (trip, vacation, roommates, couple, event) has several shared expenses paid by different people and wants to know who owes who and how to settle up. Each expense can be split equally, by exact amounts, by percentages, or by shares. Returns each person's balance (paid minus share, summing to exactly zero) and the fewest payments that settle every balance to the cent, plus a CSV of payments, balances, and expenses. One currency per call: mixed currencies are rejected and nothing is converted. Does not send payment requests, move money, or remember the group; for one restaurant bill use split_bill.
Every shared expense. Example: [{"description": "Airbnb", "amount": 360, "paid_by": "Ana"}, {"description": "Gas", "amount": 90, "paid_by": "Ben", "split_among": ["Ben", "Chloe"]}]. Record a repayment already made as an expense paid_by the person who paid it back, with split_among set to the person who received it.
Optional label, e.g. "Lisbon trip".
Everyone in the group, e.g. ["Ana", "Ben", "Chloe", "Dev"]. Needed when "everyone" should include someone who never paid. Optional otherwise.
ISO 4217 code for every expense, e.g. USD, EUR, GBP. Defaults to USD. Mixed currencies are rejected; nothing is converted.
Use this when a group (trip, vacation, roommates, couple, event) has several shared expenses paid by different people and wants to know who owes who and how to settle up. Each expense can be split equally, by exact amounts, by percentages, or by shares. Returns each person's balance (paid minus share, summing to exactly zero) and the fewest payments that settle every balance to the cent, plus a CSV of payments, balances, and expenses. One currency per call: mixed currencies are rejected and nothing is converted. Does not send payment requests, move money, or remember the group; for one restaurant bill use split_bill.
| Argument | Type | Description |
|---|---|---|
| title | string | Optional label, e.g. "Lisbon trip". |
| people | array | Everyone in the group, e.g. ["Ana", "Ben", "Chloe", "Dev"]. Needed when "everyone" should include someone who never paid. Optional otherwise. |
| currency | string | ISO 4217 code for every expense, e.g. USD, EUR, GBP. Defaults to USD. Mixed currencies are rejected; nothing is converted. |
| expenses* | array | Every shared expense. Example: [{"description": "Airbnb", "amount": 360, "paid_by": "Ana"}, {"description": "Gas", "amount": 90, "paid_by": "Ben", "split_among": ["Ben", "Chloe"]}]. Record a repayment already made as an expense paid_by the person who paid it back, with split_among set to the person who received it. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"expenses"
],
"properties": {
"title": {
"type": "string",
"maxLength": 80,
"description": "Optional label, e.g. \"Lisbon trip\"."
},
"people": {
"type": "array",
"items": {
"type": "string",
"maxLength": 40
},
"maxItems": 50,
"description": "Everyone in the group, e.g. [\"Ana\", \"Ben\", \"Chloe\", \"Dev\"]. Needed when \"everyone\" should include someone who never paid. Optional otherwise."
},
"currency": {
"type": "string",
"maxLength": 8,
"description": "ISO 4217 code for every expense, e.g. USD, EUR, GBP. Defaults to USD. Mixed currencies are rejected; nothing is converted."
},
"expenses": {
"type": "array",
"items": {
"type": "object",
"required": [
"paid_by"
],
"properties": {
"split": {
"enum": [
"equal",
"exact",
"percent",
"shares"
],
"type": "string",
"description": "How to divide it: equal (default), exact (money amounts per person), percent (must add up to 100), or shares (weights such as 2 nights vs 1 night)."
},
"amount": {
"type": "number",
"description": "Total paid, e.g. 360. Optional only for split exact, where it defaults to the sum of the amounts."
},
"paid_by": {
"type": "string",
"maxLength": 40,
"description": "The one person who paid, e.g. \"Ana\"."
},
"currency": {
"type": "string",
"maxLength": 8,
"description": "ISO 4217 code if different from the top-level currency. All expenses in one call must share one currency."
},
"description": {
"type": "string",
"maxLength": 80,
"description": "What it was for, e.g. \"Airbnb\" or \"Groceries\"."
},
"split_among": {
"type": "array",
"items": {
"type": "string",
"maxLength": 40
},
"maxItems": 50,
"description": "Who shares this cost, e.g. [\"Ana\", \"Ben\", \"Chloe\"]. Omit or use [\"everyone\"] for the whole group. The payer is included only if listed."
},
"split_values": {
"type": "object",
"description": "Per-person values for exact, percent, or shares, keyed by name, e.g. {\"Ana\": 2, \"Ben\": 1} for shares or {\"Ana\": 45.5, \"Ben\": 14.5} for exact.",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"type": "number"
}
}
}
},
"maxItems": 300,
"description": "Every shared expense. Example: [{\"description\": \"Airbnb\", \"amount\": 360, \"paid_by\": \"Ana\"}, {\"description\": \"Gas\", \"amount\": 90, \"paid_by\": \"Ben\", \"split_among\": [\"Ben\", \"Chloe\"]}]. Record a repayment already made as an expense paid_by the person who paid it back, with split_among set to the person who received it."
}
}
}Use this when the user wants to split a restaurant bill, check, receipt, takeout order, or any single bill between people: evenly or item by item (who had what), with tax, tip, service charge, coupons, delivery fees, or rounding up. Tax, tip, and service charge are shared in proportion to each person's pre-tax subtotal; every share is exact to the cent and the shares add up exactly to the total (largest-remainder rounding). Optional paid_by lists who owes the payer. Does not read receipt photos (pass the items as text), handle several payers or many bills (use settle_group_expenses), or convert currencies.
| Argument | Type | Description |
|---|---|---|
| items | array | Line items from the receipt with who shared each one. Example: [{"description": "Pizza", "price": 24, "shared_by": ["Ana", "Ben"]}, {"description": "Salad", "price": 12, "shared_by": ["Chloe"]}]. Omit and use bill_amount to split one total evenly. |
| title | string | Optional label, e.g. "Dinner at Luigi's". |
| people | array | Everyone splitting the bill, e.g. ["Ana", "Ben", "Chloe"]. Needed when some items are shared by everyone or when someone had nothing. Optional if every item lists shared_by. |
| paid_by | string | Who paid the whole bill, e.g. "Ana". Adds a list of who owes them how much. |
| currency | string | ISO 4217 code, e.g. USD, EUR, GBP, JPY. Defaults to USD. JPY has no decimals, KWD has three. |
| tip_base |
Use this when roommates or housemates want to split rent fairly: by bedroom size (square feet or metres) with a shared-space portion split per occupant, by income, or equally, with optional per-room adjustments (private bathroom, no window), couples sharing a room, and utilities split per occupant. Every amount is exact to the cent and the parts add up exactly to the rent. Does not give legal or tenancy advice, collect rent, or handle one-off shared expenses (use settle_group_expenses for those).
| Argument | Type | Description |
|---|---|---|
| basis | string | How to split: room_size (default when every room has a size), income (in proportion to income), or equal (per occupant). |
| rooms* | array | Each bedroom or person. Example: [{"name": "Ana", "size": 160}, {"name": "Ben", "size": 120}, {"name": "Chloe", "size": 100}]. |
| currency | string | ISO 4217 code, e.g. USD, EUR, GBP. Defaults to USD. |
| total_rent* | number | Total monthly rent for the home, e.g. 3200. |
| extra_costs | number | Other monthly costs split equally per occupant, e.g. 180 for utilities and internet. |
| shared_area | number | Area of shared space (kitchen, living room, shared bathroom) in the same unit as the room sizes, e.g. 400. Its share of the total area is split equally per occupant. |
| string |
| What tip_percent applies to: pre_tax (default, subtotal after discounts) or post_tax (subtotal plus service charge plus tax). |
| tax_amount | number | Tax in money exactly as printed on the receipt, e.g. 7.38. Shared in proportion to each person's subtotal. |
| tip_amount | number | Tip in money, e.g. 25. Shared in proportion to each person's subtotal. |
| bill_amount | number | Use instead of items to split one amount evenly, e.g. 120. It is the amount before any tax_percent or tip_percent you add here; if the bill already includes tax, leave tax out. |
| round_up_to | number | Round each person's share up to a multiple of this amount, e.g. 1 for whole dollars or 5. The extra is shown separately. |
| tax_percent | number | Sales tax or VAT rate added on top of the item subtotal (after any discount), e.g. 8.875. Use tax_amount instead when the receipt shows the tax in money. |
| tip_percent | number | Tip rate, e.g. 18 or 20. Calculated on the pre-tax subtotal unless tip_base is post_tax. |
| people_count | integer | Number of people when names are not given, e.g. 5. They are labelled Person 1 to Person 5. |
| discount_amount | number | Coupon or deal on the whole bill in money, applied before tax, e.g. 15. |
| discount_percent | number | Coupon or deal on the whole bill in percent, applied before tax, e.g. 10. |
| equal_fee_amount | number | A flat fee split equally rather than by what people ordered, e.g. a 6.99 delivery fee or a cover charge. |
| service_charge_amount | number | Service charge in money, e.g. 9.75. |
| service_charge_percent | number | Service charge rate added by the restaurant, e.g. 12.5. Shared in proportion to each person's subtotal. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"items": {
"type": "array",
"items": {
"type": "object",
"required": [
"price"
],
"properties": {
"price": {
"type": "number",
"description": "Price of one unit before tax and tip, in the bill currency, e.g. 18.50."
},
"weights": {
"type": "array",
"items": {
"type": "number"
},
"maxItems": 50,
"description": "Optional unequal portions in the same order as shared_by, e.g. [2, 1] when Ana ate twice as much as Ben."
},
"quantity": {
"type": "number",
"description": "How many units, e.g. 2 for two beers at the same price. Defaults to 1."
},
"shared_by": {
"type": "array",
"items": {
"type": "string",
"maxLength": 40
},
"maxItems": 50,
"description": "Names of the people who shared this item, e.g. [\"Ana\", \"Ben\"]. Omit (or use [\"everyone\"]) for an item everyone shared. Repeating a name gives that person an extra share."
},
"description": {
"type": "string",
"maxLength": 80,
"description": "What it was, e.g. \"Margherita pizza\" or \"Bottle of wine\"."
}
}
},
"maxItems": 200,
"description": "Line items from the receipt with who shared each one. Example: [{\"description\": \"Pizza\", \"price\": 24, \"shared_by\": [\"Ana\", \"Ben\"]}, {\"description\": \"Salad\", \"price\": 12, \"shared_by\": [\"Chloe\"]}]. Omit and use bill_amount to split one total evenly."
},
"title": {
"type": "string",
"maxLength": 80,
"description": "Optional label, e.g. \"Dinner at Luigi's\"."
},
"people": {
"type": "array",
"items": {
"type": "string",
"maxLength": 40
},
"maxItems": 50,
"description": "Everyone splitting the bill, e.g. [\"Ana\", \"Ben\", \"Chloe\"]. Needed when some items are shared by everyone or when someone had nothing. Optional if every item lists shared_by."
},
"paid_by": {
"type": "string",
"maxLength": 40,
"description": "Who paid the whole bill, e.g. \"Ana\". Adds a list of who owes them how much."
},
"currency": {
"type": "string",
"maxLength": 8,
"description": "ISO 4217 code, e.g. USD, EUR, GBP, JPY. Defaults to USD. JPY has no decimals, KWD has three."
},
"tip_base": {
"enum": [
"pre_tax",
"post_tax"
],
"type": "string",
"description": "What tip_percent applies to: pre_tax (default, subtotal after discounts) or post_tax (subtotal plus service charge plus tax)."
},
"tax_amount": {
"type": "number",
"description": "Tax in money exactly as printed on the receipt, e.g. 7.38. Shared in proportion to each person's subtotal."
},
"tip_amount": {
"type": "number",
"description": "Tip in money, e.g. 25. Shared in proportion to each person's subtotal."
},
"bill_amount": {
"type": "number",
"description": "Use instead of items to split one amount evenly, e.g. 120. It is the amount before any tax_percent or tip_percent you add here; if the bill already includes tax, leave tax out."
},
"round_up_to": {
"type": "number",
"description": "Round each person's share up to a multiple of this amount, e.g. 1 for whole dollars or 5. The extra is shown separately."
},
"tax_percent": {
"type": "number",
"description": "Sales tax or VAT rate added on top of the item subtotal (after any discount), e.g. 8.875. Use tax_amount instead when the receipt shows the tax in money."
},
"tip_percent": {
"type": "number",
"description": "Tip rate, e.g. 18 or 20. Calculated on the pre-tax subtotal unless tip_base is post_tax."
},
"people_count": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Number of people when names are not given, e.g. 5. They are labelled Person 1 to Person 5."
},
"discount_amount": {
"type": "number",
"description": "Coupon or deal on the whole bill in money, applied before tax, e.g. 15."
},
"discount_percent": {
"type": "number",
"description": "Coupon or deal on the whole bill in percent, applied before tax, e.g. 10."
},
"equal_fee_amount": {
"type": "number",
"description": "A flat fee split equally rather than by what people ordered, e.g. a 6.99 delivery fee or a cover charge."
},
"service_charge_amount": {
"type": "number",
"description": "Service charge in money, e.g. 9.75."
},
"service_charge_percent": {
"type": "number",
"description": "Service charge rate added by the restaurant, e.g. 12.5. Shared in proportion to each person's subtotal."
}
}
}| shared_percent | number | Alternative to shared_area: percent of the rent treated as shared space and split equally per occupant, e.g. 40. Defaults to 50 for room_size when shared_area is not given. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"total_rent",
"rooms"
],
"properties": {
"basis": {
"enum": [
"room_size",
"income",
"equal"
],
"type": "string",
"description": "How to split: room_size (default when every room has a size), income (in proportion to income), or equal (per occupant)."
},
"rooms": {
"type": "array",
"items": {
"type": "object",
"required": [
"name"
],
"properties": {
"name": {
"type": "string",
"maxLength": 40,
"description": "Who lives there or the room label, e.g. \"Ana\" or \"Big room (Ana & Ben)\"."
},
"size": {
"type": "number",
"description": "Bedroom floor area in any one unit used for all rooms (square feet or square metres), e.g. 140."
},
"income": {
"type": "number",
"description": "Monthly or yearly income (same period for everyone) when splitting by income, e.g. 5200."
},
"occupants": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "People sharing this room, e.g. 2 for a couple. Shared space and extra costs are split per occupant. Defaults to 1."
},
"adjustment_percent": {
"type": "number",
"description": "Optional premium or reduction on the room's size-based part, e.g. 10 for a private bathroom or -10 for no window."
}
}
},
"maxItems": 20,
"description": "Each bedroom or person. Example: [{\"name\": \"Ana\", \"size\": 160}, {\"name\": \"Ben\", \"size\": 120}, {\"name\": \"Chloe\", \"size\": 100}]."
},
"currency": {
"type": "string",
"maxLength": 8,
"description": "ISO 4217 code, e.g. USD, EUR, GBP. Defaults to USD."
},
"total_rent": {
"type": "number",
"description": "Total monthly rent for the home, e.g. 3200."
},
"extra_costs": {
"type": "number",
"description": "Other monthly costs split equally per occupant, e.g. 180 for utilities and internet."
},
"shared_area": {
"type": "number",
"description": "Area of shared space (kitchen, living room, shared bathroom) in the same unit as the room sizes, e.g. 400. Its share of the total area is split equally per occupant."
},
"shared_percent": {
"type": "number",
"description": "Alternative to shared_area: percent of the rent treated as shared space and split equally per occupant, e.g. 40. Defaults to 50 for room_size when shared_area is not given."
}
}
}