well_create_expense_settlement

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

Record one repayment in a shared-expense group: a member paid another member back. It records what already happened: it moves no money, writes only inside Well and sends nothing. `from_person_id` paid `to_person_id` the `amount` (a plain decimal in the group's `currency`) on `settled_on` (YYYY-MM-DD), by `method_code`. Both must be members of the group. Call it only after the person said yes to recording this repayment, in this conversation. Read `outcome`: `written` with `expense_group_settlement_id`, or `refused` means nothing was written. `reason` names why: `group_not_found` (no such group in this workspace), `person_not_found` (a person id names no person of this workspace), `not_a_member`, `payer_not_a_member`, `from_not_a_member` or `to_not_a_member` (that person is not a member of the group: add them first), `currency_mismatch` (the group holds one other currency), `invalid_amount`, `invalid_weight`, `no_shares`, `duplicate_share`, `same_person`, `already_a_member`, `caller_not_a_member` or `caller_not_a_person_here` (the call names no person of this workspace). 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.