MCP Tools — Groups
Group reads, membership, and group-scoped actions.
8 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.create
Session
MCP Token
Create a group agent (community, ring, guild, family, org). Caller becomes the founding admin.
Parameters
| Param | Type | Required | Description |
|---|---|---|---|
chapter | string | yes | Canonical locale id ('all' if not locale-scoped). |
description | string | yes | |
groupType | string | yes | One of: community, ring, family, guild, org, etc. |
name | string | yes | |
isGlobal | boolean | — | |
legalWrapper | string | — | |
parentGroupId | string | — | |
scopedGroupIds | string[] | — | |
scopedLocaleIds | string[] | — | |
scopedUserIds | string[] | — |
rivr.groups.get
Session
MCP Token
Fetch a group's detail record (agent row + metadata).
Parameters
| Param | Type | Required | Description |
|---|---|---|---|
groupId | string | yes |
rivr.groups.list
Session
MCP Token
List groups. Optionally filter by membership of the actor.
Parameters
| Param | Type | Required | Description |
|---|---|---|---|
limit | number | — | |
onlyMine | boolean | — | If true, return only groups where the actor has an active join ledger entry. |
rivr.groups.members.add
Session
MCP Token
Add the acting agent to a group. Uses the public requestGroupMembership flow; may return 'requested' if approval is required.
Parameters
| Param | Type | Required | Description |
|---|---|---|---|
groupId | string | yes | |
inviteToken | string | — | |
password | string | — |
rivr.groups.members.list
Session
MCP Token
List members of a group.
Parameters
| Param | Type | Required | Description |
|---|---|---|---|
groupId | string | yes | |
limit | number | — |
rivr.groups.members.remove
Session
MCP Token
Revoke a member from a group. The caller must be the member themselves or an admin of the group.
Parameters
| Param | Type | Required | Description |
|---|---|---|---|
groupId | string | yes | |
memberId | string | yes |
rivr.groups.members.role
Session
MCP Token
Set a member's role. Writes an append-only role-grant ledger entry that group-admin queries recognize.
Parameters
| Param | Type | Required | Description |
|---|---|---|---|
groupId | string | yes | |
memberId | string | yes | |
role | string | yes | E.g. admin, moderator, steward, member. |
rivr.groups.update
Session
MCP Token
Update a group agent's name, description, or metadata patch.
Parameters
| Param | Type | Required | Description |
|---|---|---|---|
groupId | string | yes | |
description | string | — | |
metadataPatch | object | — | |
name | string | — |