well_compare_quotes

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

Compare the supplier quotes of one comparison group, read from the quote documents the workspace received. It writes nothing. A comparison group is set by a person, never guessed: `well_group_quotes` puts quotes in one. Call this with `quote_request_id` to compare that group, or with no argument to list the groups (`requests`, each with its `quote_count`, the 20 newest) and the quotes no group holds yet (`ungrouped_quotes`). With a group, each quote carries its supplier, its source `document_id`, `valid_until`, `currency`, `items_total`, `tax_total`, `grand_total` (decimal strings in major units of that currency) and its `lines` in printed order (label, quantity, unit price, line total), every amount as the quote prints it. `expired` is true when `valid_until` is before today. Ranking is per currency only (`currency_groups`): `rank_in_currency` 1 is the lowest total among the quotes of that currency still on offer. Equal totals share a rank, and `lowest_supplier_quote_id` is null when several quotes share the lowest total: name each of them. An expired quote, a quote with no total and a quote with no currency are not ranked (`rank_exclusion`). When `mixed_currencies` is true, never add, convert or rank totals across currencies: say the quotes are in different currencies and show each in its own. Quote every figure as returned, with its supplier; never compute a total or a unit price the quote does not state. The comparison is computed on each call from the stored quotes, as of `as_of`. `url` is the link to share it: a signed-in page that only the workspace's members (never a guest) can open, and that recomputes the comparison each time it opens. The link carries no data and no session of its own, so it is not a snapshot: give it as the way to see the comparison stay current, and never call it public. `refusal_reason`: "request_not_found" (no such group in this workspace), "no_workspace", "read_failed". 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.