MCP Tools — Social
Posts, reactions, comments, and connections.
13 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.comments.delete
Session
MCP Token
Delete a comment the caller authored. Marks the ledger row inactive (soft delete, reversible audit row remains).
Parameters
| Param | Type | Required | Description |
|---|---|---|---|
commentId | string | yes |
rivr.comments.list
Session
MCP Token
List comments on a resource (ordered oldest first).
Parameters
| Param | Type | Required | Description |
|---|---|---|---|
resourceId | string | yes |
rivr.comments.post
Session
MCP Token
Post a comment on a resource (post, event, offering, etc). Optionally reply to a parent comment.
Parameters
| Param | Type | Required | Description |
|---|---|---|---|
content | string | yes | |
resourceId | string | yes | |
parentCommentId | string | — |
rivr.follow.list_followers
Session
MCP Token
List agents who follow the actor.
Parameters
| Param | Type | Required | Description |
|---|---|---|---|
limit | number | — |
rivr.follow.list_following
Session
MCP Token
List agents the actor is currently following.
Parameters
| Param | Type | Required | Description |
|---|---|---|---|
limit | number | — |
rivr.follow.unfollow
Session
MCP Token
Unfollow an agent. No-op (returns success) if not currently following.
Parameters
| Param | Type | Required | Description |
|---|---|---|---|
agentId | string | yes |
rivr.follow.user
Session
MCP Token
Follow an agent. No-op (returns success) if already following.
Parameters
| Param | Type | Required | Description |
|---|---|---|---|
agentId | string | yes |
rivr.messages.list
Session
MCP Token
List direct messages for a thread (Matrix roomId) or between the actor and a specified counterpart agent.
Parameters
| Param | Type | Required | Description |
|---|---|---|---|
limit | number | — | |
threadId | string | — | |
withAgentId | string | — |
rivr.messages.send
Session
MCP Token
Send a direct message to another agent. The message is recorded as a ledger entry (verb='message'). Matrix delivery is attempted best-effort via the existing DM room provisioning path.
Parameters
| Param | Type | Required | Description |
|---|---|---|---|
content | string | yes | |
recipientId | string | yes | |
threadId | string | — | Optional existing thread/room id. |
rivr.messages.thread_get
Session
MCP Token
Fetch a message thread by id plus its counterpart metadata. Resolves Matrix room id when present.
Parameters
| Param | Type | Required | Description |
|---|---|---|---|
threadId | string | yes |
rivr.reactions.add
Session
MCP Token
Add (or toggle off) a reaction on a target post/comment/resource. Valid reaction types: like, love, laugh, wow, sad, angry.
Parameters
| Param | Type | Required | Description |
|---|---|---|---|
reactionType | enum(like \ | love \ | laugh \ |
targetId | string | yes | |
targetType | enum(post \ | comment \ | resource \ |
rivr.reactions.list
Session
MCP Token
List reaction summaries for one or more targets. Returns counts keyed by reaction type.
Parameters
| Param | Type | Required | Description |
|---|---|---|---|
targetIds | string[] | yes | |
targetType | enum(post \ | comment \ | resource \ |
rivr.reactions.remove
Session
MCP Token
Remove the current user's reaction on a target. Equivalent to calling reactions.add with the same reactionType (toggle).
Parameters
| Param | Type | Required | Description |
|---|---|---|---|
reactionType | enum(like \ | love \ | laugh \ |
targetId | string | yes | |
targetType | enum(post \ | comment \ | resource \ |