well_list_invite_suggestions

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

List the teammates Well suggests inviting into this workspace: the people it found on the workspace owner's email domain who hold no membership, each as an open invite suggestion. Only a workspace owner or admin can read them; any other caller is refused with `refusal_reason: "not_admin"`. Use it for two things only. (1) Before you offer a teammate without being asked, at most once in a session opening: offer only when `offer_allowed` is true and `suggestions` is not empty, then record the offer with well_record_invite_answer (`outcome: "offered"`) BEFORE you write the offer line, and write it only when that call returns `recorded: true`. (2) When the person answers an earlier offer ("later", "no"), to find the suggestion's `task_id`. To invite someone the person asked for, use well_list_member_candidates instead: a request is never limited by this cap. Returns `suggestions` (every open suggestion, oldest first, at most the workspace's open cap; the order is not a preference, so pick from each row's `last_offered_at`; each with `task_id`, `person_id`, `name`, `email`, `refusal_count` and `last_offered_at`), `offer_allowed` (true when no unprompted offer went out in the last 7 days on any surface: web, extension, Claude, ChatGPT or WhatsApp) and `next_offer_at`. A suggestion the person put off or declined is not listed until it comes back 30 days later, and a second no removes it for good. 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.