well_get_expense_group_balances

io.github.WellApp-ai/well-mcp · Verify this server

Get who owes whom in one shared-expense group: each member's balance and the fewest transfers that settle the group. It writes nothing. `balances` gives each member's `balance` as a signed decimal string in the group's currency: above zero the group owes the member, below zero the member owes the group. The balances sum to zero. `transfers` lists the fewest payments that bring every balance to zero, each with `from_person_id`, `to_person_id`, their names and `amount`. An empty `transfers` means the group is settled. Well computes these figures from every expense and repayment of the group: state them as returned. Read `outcome`: `read`, or `refused` with `reason` `group_not_found` (no such group in this workspace) or `too_many_rows` (the group is too large to compute in one read). When the token authorizes one workspace, call this directly — no workspace call is needed first. When it authorizes several, this read will not guess which one you mean: pass `workspace_id` on the call.