MCP Tools — Group Lifecycle
Group creation, subgroups, and lifecycle transitions.
7 tools in this registry. Every tool is callable over the MCP endpoint (
/api/mcp); the badge on each shows which auth modes may invoke it. See Auth models and the MCP overview.
rivr.groups.renew_membership
Session
MCP Token
Renew the actor's own membership window in a group, reusing prior password-grant proof when present.
Parameters
| Param | Type | Required | Description |
|---|---|---|---|
groupId | string | yes |
rivr.groups.request_membership
Session
MCP Token
Request membership in a group as the actor. Supports application answers, a join password, or an invite token depending on the group's join settings.
Parameters
| Param | Type | Required | Description |
|---|---|---|---|
groupId | string | yes | |
answers | object[] | — | |
inviteToken | string | — | |
password | string | — |
rivr.groups.review_join_request
Session
MCP Token
Approve or reject a pending group join request. The actor must be an admin of the group.
Parameters
| Param | Type | Required | Description |
|---|---|---|---|
decision | enum(approved \ | rejected) | yes |
groupId | string | yes | |
requestId | string | yes | |
adminNotes | string | — |
rivr.groups.revoke_membership
Session
MCP Token
Revoke a member's group membership. The actor must be a group admin, or the member revoking their own membership.
Parameters
| Param | Type | Required | Description |
|---|---|---|---|
groupId | string | yes | |
memberId | string | yes |
rivr.groups.update_join_settings
Session
MCP Token
Update a group's join workflow (joinType, discovery visibility, application questions, password/approval requirements). The actor must be a group admin. Sparse: only provided fields change.
Parameters
| Param | Type | Required | Description |
|---|---|---|---|
groupId | string | yes | |
joinType | enum(public \ | approval_required \ | invite_only \ |
applicationInstructions | string | — | |
approvalRequired | boolean | — | |
inviteLink | string | — | |
passwordRequired | boolean | — | |
questions | object[] | — | |
visibility | enum(public \ | hidden) | — |
rivr.groups.update_membership_plans
Session
MCP Token
Replace a group's paid membership plans. The actor must be a group admin. plans is the FULL list of plans (send every plan to keep, not just the changed one). Prices are whole US cents per cadence: amountMonthlyCents 1000 is $10.00 a month, amountYearlyCents 10000 is $100.00 a year; null on a cadence means no price on it. Every plan states its price in those fields, and a plan whose name or description mentions a price must carry it there. A plan's grantsGroupId names a subgroup its subscribers also join. Stripe prices are not created here: checkout prices each subscription when a member subscribes.
Parameters
| Param | Type | Required | Description |
|---|---|---|---|
groupId | string | yes | |
plans | object[] | yes |
rivr.groups.update_tab_visibility
Session
MCP Token
Update per-tab visibility for a group's pages. The actor must be a group admin. tabVisibility maps tab keys to a visibility level (public | members | admin | hidden).
Parameters
| Param | Type | Required | Description |
|---|---|---|---|
groupId | string | yes | |
tabVisibility | object | yes |