MCP Tools — Settings
User and instance settings.
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.personas.activate
Session
MCP Token
Switch the active persona. Pass personaId=null to revert to the main account.
Parameters
| Param | Type | Required | Description |
|---|---|---|---|
personaId | string | — | Persona id to activate. Omit or pass empty string to revert to main account. |
rivr.personas.active
Session
MCP Token
Return information about the currently active persona (if any).
Parameters
No parameters.
rivr.personas.create
Session
MCP Token
Create a new persona under the controller account.
Parameters
| Param | Type | Required | Description |
|---|---|---|---|
name | string | yes | |
bio | string | — | |
username | string | — |
rivr.personas.delete
Session
MCP Token
Soft-delete a persona owned by the controller.
Parameters
| Param | Type | Required | Description |
|---|---|---|---|
personaId | string | yes |
rivr.personas.list_all
Session
MCP Token
List all personas owned by the controller (alias for rivr.personas.list — exposed under this name to avoid duplicating the existing tool registration).
Parameters
No parameters.
rivr.personas.update
Session
MCP Token
Update a persona's name, username, bio, or image.
Parameters
| Param | Type | Required | Description |
|---|---|---|---|
personaId | string | yes | |
bio | string | — | |
image | string | — | |
name | string | — | |
username | string | — |
rivr.settings.get
Session
MCP Token
Return the current user's profile + settings bundle (name, username, email, bio, tagline, skills, phone, privacy, notification, social-link, publication preferences).
Parameters
No parameters.
rivr.settings.update
Session
MCP Token
Update non-auth settings (profile fields, skills, privacy, notifications, social links, publication). EMAIL CHANGES AND PASSWORD CHANGES ARE EXCLUDED — use the web UI for those.
Parameters
| Param | Type | Required | Description |
|---|---|---|---|
bio | string | — | |
homeLocale | string | — | |
murmurationsPublishing | boolean | — | |
name | string | — | |
notificationSettings | object | — | |
phone | string | — | |
privacySettings | object | — | |
skills | string[] | — | |
socialLinks | object | — | |
tagline | string | — | |
username | string | — |