well_get_computed_figures

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

Call this for any sum, difference, product, ratio, comparison, ranking or count of days over money, quantities or dates: never compute one yourself, because Well computes with exact decimals and your own arithmetic drifts. Every operand is an input or earlier-step name. Every amount is a quoted decimal string, never a JSON number. Example: {"inputs":[{"name":"a","label":"A","amount":"1","currency":"GBP"},{"name":"b","label":"B","amount":"2","currency":"GBP"}],"steps":[{"id":"total","op":"sum","args":["a","b"]}]}. Label constants (0, 1, rates) as inputs. `take_until_total_reaches`: `args: [target]`, `order` (`latest_due_first`/`largest_first`), `items` naming amount and date inputs. `sum_picked`: `per_item` for every pick item exactly once, keyed by amount input name; sums picked items only. `div` and `round` require `places` (0-12) and `rounding`: `half_up`, `half_even` or `down`. `compare` requires `relation`. A total that Well measures (spend, invoices, receivables, payslips) comes from its `well_sum_*` tool. This tool only combines figures already read, and it never reads data. `sum`/`sub`/`min`/`max`/`compare`/`take_until_total_reaches`: one currency throughout or none. `sum_picked`: the `per_item` values share one currency, or none. `mul`: at most one currency. `div`: currency over untagged amount keeps currency; equal currencies give an untagged ratio. `invalid_program`: bad program. `duplicate_name`. `unknown_reference`: missing/forward. `wrong_type`. `mixed_currency`: mismatch. `division_by_zero`: zero divisor. `out_of_range`: too large. `invalid_date`: bad day. Quote each returned figure as given.