well_create_expense_line

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

Add one expense to a shared-expense group: who paid, how much, and how it splits between members. It writes only inside Well and sends nothing. `payer_person_id` paid `amount` (a plain decimal in the group's `currency`). `shares` lists every member who owes a part, each with a whole `weight`: equal weights split equally, a weight of 2 owes twice a weight of 1. The payer is in `shares` when they owe a part too. The line and its shares are written together, or not at all. Well splits the amount exactly by weight: never compute the parts yourself. Call it only after the person said yes to this expense and its split, in this conversation. Read `outcome`: `written` with `expense_line_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.