Plug any LLM into Rheba.

Add a user to a group by userId, with a role (owner|admin|member|follower; default member). Caller must have manage-members permission in the group. Find a userId with rheba_search_users.

AUTO-BOOK — the write half of Auto-find. Re-runs the find, then HOLDS the best slot as a potential group event and invites every member (available ones flagged). Use after rheba_auto_find_time to commit the chosen slot in one step. slotIndex 0 = the chosen slot (default), 1+ = an alternative. Requires coordinator (create_bookings) authority. This creates a HOLD, not a confirmed event.

AUTO-FIND — the 'system decides' way to schedule. Given a group, a duration, and a date window, returns the SINGLE best time everyone (or the most people) is free, computed straight from the availability graph — no proposing, no voting. Returns { chosen, alternatives } for a one-tap confirm. mode 'all' (everyone free) | 'most' (with minMembers); policy 'soonest' (default) | 'max_attendance'. Use this instead of asking people 'when are you free?' — Rheba already knows.

Soft-delete the user's scheduling events in a date range. Capped at 90 days per call.

Cancel a Back Office job and remove its booking events. Caller must dispatch for the job's group.

Cancel (withdraw) a proposal you initiated while it's still in flight. Members are notified. Accepted / fully-declined / expired proposals can't be cancelled. Only the initiator may cancel.

Pre-flight: can a candidate booking fit at the city + time given existing bookings?

Claim an opening on a board. You must be a group member. Capacity is enforced atomically — the last spot cannot be double-claimed. Re-claiming a slot you hold is a no-op.

Close a claim board (no more claims). Creator or coordinator only.

Close a collection (no more share updates). Creator or coordinator only.

Close a preference round. Pass book=true to also HOLD the winning slot as a potential group event (inviting everyone) in one step. Only the round's creator or a group coordinator may close it.

Commit to (or out of) a quorum round — stance 'in' or 'out'. You must be a group member. When the 'in' count reaches the threshold the event auto-locks and is scheduled.

Mark a Back Office job complete. Caller must dispatch for the job's group.

Mark a task as completed. Irreversible via MCP — use delete if you want to remove it instead.

Convert an ACCEPTED booking-request lead into a dispatchable Job with unfilled role slots. Idempotent — re-converting the same lead returns the existing job. Caller must dispatch for the lead's group.

CLAIM — the 'who grabs it' way to coordinate. Post a set of limited openings (shifts, sub spots, volunteer slots, 'bring the drinks'); members claim them first-come. Each slot has an optional time and a capacity (default 1). Requires coordinator (create_bookings) authority.

COLLECT MONEY from a group — dues, a split cost, a tip jar ('collect $20 each for the trip'). TRACKING only: Rheba records who owes/paid, it never holds or moves funds (payment happens off-app via payTo). Split one of three ways: `shares` (explicit per-member amounts) | `perMember` (everyone pays the same) | `total` (split equally). memberIds defaults to all group members. Requires coordinator (manage_members).

Create a single non-recurring scheduling event. Default duration 1 hour. Use this for one-off events. For repeating series use rheba_create_recurring_events.

Create a new group owned by the user. Groups are the core container for members, a shared calendar, and coordination. Free-tier users are limited to one group (returns an upgrade error beyond that). Returns the created group incl. its groupId.

PREFERENCE — the 'members decide' way to schedule. Seeds candidate slots straight from the availability graph (only times that already work for the threshold), then members rank preference + confirm intent in one pass and the system picks the winner. NOT a blank poll, NOT a discussion — members only ever rank times everyone is already free for. Requires coordinator (create_bookings) authority. Returns the poll + its candidate slots (each with an index members vote by).

Create a group coordination proposal with 3–5 candidate slots. Initiator must be a member of the target group. Slot 0 goes out for confirmation immediately; on any decline the cycle advances to the next slot. Always propose 3+ slots — single-slot proposals leave the recipient no real choice.

QUORUM — the 'whether, not when' way to schedule. Propose a specific time and a threshold N; the event LOCKS IN only when ≥N members commit 'in' (else it doesn't happen). Pickup games, optional gigs, min-enrollment classes. Reaching the threshold auto-holds the time as a group event. Requires coordinator (create_bookings) authority.

Create a recurring scheduling or task series.

Create a private subgroup under a parent group (e.g. a committee or team). Caller must have manage-members permission in the parent. Returns the new subgroup incl. its groupId.

Create a personal task. Tasks can be flexible (floating, no time anchor) or pinned to a time slot. Use rheba_list_tasks to verify after creation.

Delete a single scheduling event by id. For recurring series use rheba_delete_event_series with scope 'one' | 'following' | 'all'.

Delete one occurrence, this and following, or the whole series.

Delete (soft-delete) a personal task. Deleted tasks are not restorable via MCP. Prefer rheba_complete_task for tasks that are done.

Mutual free times across all members of a group on a date range.

Mutual free times across a group over a date range. Wider than find_group_availability (which is single-day). Use for 'when can the family meet next week?' patterns.

When the user asks 'when can X and I meet?' — pass the person's first name. Returns mutual free times for the smallest group both share. Permission-gated: only finds people the user already shares at least one group with — if there's no match, the user is not connected to anyone by that name.

User's availability buckets for a date.

Detailed availability breakdown for a date: avail (marked available), scheduled (booked by an event), other (unmarked free gaps), and a combined times array. Optionally filter by flavor.

Return events the user CREATED in a date range. Does NOT return events the user was invited to or is attending — those are app-only and not exposed via MCP for privacy. Dates are ISO YYYY-MM-DD.

Get a claim board: its slots, who claimed each, and remaining capacity.

Get a collection: per-member shares (owed/paid/waived) + totals (total/collected/outstanding).

The user's Rheba credit balance (cents + a formatted dollar string), lifetime earned, and recent credit history.

User's own bookings on a date with cities, ordered by start.

User's recently soft-deleted events.

Owner-facing group analytics: membership + COORDINATION THROUGHPUT (events, preference/quorum/claim rounds, collections, jobs — total + last 30 days), money coordinated, and last activity. Shows how much real coordination the group drives. Aggregate + read-only; coordinator (manage_members) only.

Full detail of a Back Office job — role assignments + status. Caller must dispatch for the job's group.

Get the recorded invoice for a job (number, status, online URL) if one has been created.

List the per-assignee payout amounts recorded on a Back Office job.

Get a preference round with its live tally — the candidate slots, each one’s score and preferred/ok/cant breakdown, and the current winner. Use to show members where the round stands.

Full state of a coordination proposal: current slot, all proposed slots, per-member responses, and cycle history. Caller must be initiator or member.

Get a quorum round: commitments, in/out counts, and whether the threshold is met.

List the claim boards for a group (optionally only open ones).

List a group’s money collections (optionally only open ones).

Members of a group the caller belongs to.

List the user's groups.

List Back Office jobs across the groups you dispatch for (Business tier), newest first. Each carries a rolled-up status: filled | partially_filled | pending | at_risk.

List the user's own notifications, newest first. Set unreadOnly to show just the unread ones. Each has a title, body, type, read flag, and optional actionUrl.

List inbound booking-request leads across the groups you dispatch for, optionally filtered by status (pending|accepted|declined|cancelled). Convert an ACCEPTED lead into a job with rheba_convert_pipeline_lead.

List the preference rounds for a group (optionally only open ones).

Group coordination proposals where the user is the initiator or an invited member. Includes status, current slot, and members' responses.

List the quorum rounds for a group (optionally only open ones).

List the user's personal tasks. Filter by status ('pending'|'completed'|'all'), flexibility, and date range. Returns tasks the user created or was assigned. Personal tasks only — group / job tasks are a separate surface.

Mark the user's notification(s) read — one by notificationId, or all unread with all=true.

Mark a member's share status in a collection. status 'paid' | 'owed' | 'waived' (default 'paid'). You may update your OWN share; a coordinator (manage_members) may update anyone's or 'waived'. userId defaults to you.

Give up an opening you claimed, freeing it for someone else.

Remove a user from a group. Removing YOURSELF (leaving) needs no special permission; removing anyone else requires manage-members permission.

Finalize a quorum round now (deadline/manual). If the threshold is met it locks in and books the time; otherwise it's marked 'nogo'. Creator or coordinator only.

Confirm or decline the current slot of a proposal. Caller must be a member of the proposal. A reason is required when declining.

Restore soft-deleted events by id list.

Create a Back Office job (a gig) directly, assigning team members to role slots. Auto-confirms the assignees (owner direct-assign) and creates one booking event per assignee. For invite-based staffing use the pipeline/dispatch flow instead. Business tier + dispatch capability required.

Search cities by name (supports 'City, ST' format). Returns cityId, city, state, and stateName. Use cityId when creating events with a specific city. Results are sorted by population descending.

Search the user's network by name or email. Scoped to people who share a group with the caller — not a global directory. Use to resolve names like 'Brad' to userIds before calling availability tools.

Send a notification to a Rheba user (e.g. a reminder or update). It's sent FROM the current user's account. Find a recipient userId with rheba_search_users. Not for bulk/marketing sends.

Set the billing client on a job — either a Rheba user/group on the network (kind='network' with clientType + clientId) or an off-network contact (kind='inline' with name + optional email/phone). This is who the job's invoice bills.

Set (upsert) one assignee's payout amount on a job. amount is a non-negative number in the given currency (default USD). Records the intended payout; pushing it to accounting is a separate Xero-connected step.

Change a member's role in a group (admin|member|follower). Caller needs manage-members permission. The owner's role can only be changed by the owner. 'owner' cannot be assigned here.

Cast (or update) your ballot in a preference round. prefs maps a candidate index to a rating: 'preferred' (this is my pick), 'ok' (I can do it), or 'cant' (free but won't). Omitted candidates default to 'ok'. You must be a member of the round's group. Returns the updated tally.

Today's date in ISO + RDate.

Update a group's name, description, and/or public visibility. Caller must have edit-settings permission (owner/admin). Send only the fields you want to change.

Edit a proposal you initiated while it's still in flight: title, message, expiry, and/or the candidate slots. Slots can only be changed BEFORE any member has responded (afterwards, cancel and create a fresh one). Only the initiator may edit; provide only the fields you want to change.

Update editable fields on a task — title, description, times, deadline, priority, flexibility. Pass only the fields you want to change; omitted fields are preserved.