MCP Tools — Core
Instance context, places, personas, profile, posts, KG, and audit — the tools defined directly on the aggregate.
17 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.audit.recent
Session
MCP Token
Return recent MCP provenance log entries. Useful for reviewing autobot activity and debugging.
Parameters
| Param | Type | Required | Description |
|---|---|---|---|
actorType | enum(human \ | persona \ | autobot) |
limit | number | — | Max entries to return (default 50, max 200) |
resultStatus | enum(success \ | error) | — |
toolName | string | — | Filter by tool name |
rivr.events.append_transcript
Session
MCP Token
Append a transcript segment into the linked meeting transcript document for an event.
Parameters
| Param | Type | Required | Description |
|---|---|---|---|
eventId | string | yes | |
text | string | yes | |
source | enum(manual \ | whisper \ | whisper-gateway) |
speakerLabel | string | — |
rivr.groups.join
Session
MCP Token
Join or leave a group or ring.
Parameters
| Param | Type | Required | Description |
|---|---|---|---|
groupId | string | yes | |
type | enum(group \ | ring) | — |
rivr.instance.get_context
Session
MCP Token
Return the local Rivr instance identity and the authenticated actor context.
Parameters
No parameters.
rivr.kg.chat
Session
MCP Token
Chat with knowledge graph context. Fetches relevant KG facts for the scope and uses them to inform the response.
Parameters
| Param | Type | Required | Description |
|---|---|---|---|
message | string | yes | The user's message/question |
max_context_chars | number | — | Max chars of KG context to inject. Default: 3000 |
scope_id | string | — | Scope ID. Default: current actor ID |
scope_type | string | — | Scope type. Default: inferred from actor type |
rivr.kg.list_docs
Session
MCP Token
List knowledge graph documents for a scope. Defaults to the actor's scope (persona scope when acting as a persona).
Parameters
| Param | Type | Required | Description |
|---|---|---|---|
scope_id | string | — | Scope ID. Default: current actor ID |
scope_type | string | — | Scope type (person, persona, group, event, project). Default: inferred from actor type |
status | string | — | Filter by doc status (pending, ingesting, complete, failed) |
rivr.kg.push_doc
Session
MCP Token
Push a Rivr resource into the knowledge graph for extraction. Creates a doc record and ingests its content.
Parameters
| Param | Type | Required | Description |
|---|---|---|---|
resourceId | string | yes | ID of the Rivr resource to push |
doc_type | string | — | Doc type classification |
scope_id | string | — | Scope ID. Default: current actor ID |
scope_type | string | — | Scope type. Default: inferred from actor type |
title | string | — | Override title for the doc |
rivr.kg.query
Session
MCP Token
Query the scoped knowledge graph subgraph. Returns triples (subject-predicate-object facts) from the KG.
Parameters
| Param | Type | Required | Description |
|---|---|---|---|
entity | string | — | Filter triples by entity name |
max_results | number | — | Maximum number of triples to return |
predicate | string | — | Filter triples by predicate type |
scope_id | string | — | Scope ID. Default: current actor ID |
scope_type | string | — | Scope type. Default: inferred from actor type |
rivr.personas.list
Session
MCP Token
List personas owned by the current controller and return the active persona.
Parameters
No parameters.
rivr.places.list
Session
MCP Token
List the places (locales/chapters and regions/bioregions) that posts, events, and offerings can be scoped to. Call this to resolve a place NAME (e.g. "Boulder") to the canonical id you pass as localeId/regionId (or scopedLocaleIds/scopedRegionIds) on the create tools. This instance is the canonical federation directory, so the list is read directly from its own place registry. Optionally filter by name substring (query) and/or restrict to a kind (placeType: "locale" or "region").
Parameters
| Param | Type | Required | Description |
|---|---|---|---|
limit | number | — | Max places per kind. Defaults to 50. |
placeType | enum(locale \ | region \ | all) |
query | string | — | Optional case-insensitive substring to match against place name. |
rivr.points.balance
Session
MCP Token
Return the authenticated actor's points balance. Sums active 'earn' ledger rows credited to the actor and returns balance, lifetime total, and the most recent earns. With no spend surface yet, balance equals lifetime.
Parameters
No parameters.
rivr.posts.create
Session
MCP Token
Create a post as the active actor or into a group where the actor has write access. Pass postAsGroupId (or its federation alias ownerId) to author the post AS a group the actor administers (the group becomes the owner; the actor is recorded as provenance). Scope the post to a place by passing localeId (a locale/chapter) and/or regionId (a region/bioregion); use rivr.places.list to resolve a place name to its id.
Parameters
| Param | Type | Required | Description |
|---|---|---|---|
content | string | yes | |
groupId | string | — | |
imageUrl | string | — | |
isGlobal | boolean | — | |
localeId | string | — | Scope the post to this locale/chapter (a place-typed agent id). Resolve names to ids with rivr.places.list. May be combined with regionId. |
ownerId | string | — | Federation alias for postAsGroupId. Post AS this group (the actor must administer it). |
postAsGroupId | string | — | |
postType | string | — | |
regionId | string | — | Scope the post to this region/bioregion (a place-typed agent id). Resolve names to ids with rivr.places.list. May be combined with localeId. |
scopedLocaleIds | string[] | — | Additional locale/chapter ids to scope the post to. Resolve names to ids with rivr.places.list. |
scopedRegionIds | string[] | — | Additional region/bioregion ids to scope the post to. Resolve names to ids with rivr.places.list. |
title | string | — |
rivr.posts.create_live_invite
Session
MCP Token
Create a live invite post. For group-scoped invites, this also creates the linked meeting event and transcript document.
Parameters
| Param | Type | Required | Description |
|---|---|---|---|
content | string | yes | |
groupId | string | yes | |
liveLocation | object | yes | |
isGlobal | boolean | — | |
localeId | string | — | Scope the live invite to this locale/chapter (a place-typed agent id). Resolve names to ids with rivr.places.list. May be combined with regionId. |
regionId | string | — | Scope the live invite to this region/bioregion (a place-typed agent id). Resolve names to ids with rivr.places.list. May be combined with localeId. |
scopedGroupIds | string[] | — | |
scopedLocaleIds | string[] | — | |
scopedRegionIds | string[] | — | Additional region/bioregion ids to scope the live invite to. Resolve names to ids with rivr.places.list. |
scopedUserIds | string[] | — | |
title | string | — |
rivr.posts.list
Session
MCP Token
Read posts back. Pass groupId to read a group's activity feed (the same posts the group page shows), or authorId to read a specific agent's posts. With neither, returns the acting actor's own posts. Results are permission-filtered for the actor and capped by limit (default 30, max 100).
Parameters
| Param | Type | Required | Description |
|---|---|---|---|
authorId | string | — | Read posts owned/authored by this agent id. |
groupId | string | — | Read this group's post feed. |
limit | number | — | Max posts to return (default 30, max 100). |
rivr.profile.get_my_profile
Session
MCP Token
Return the authenticated actor's myprofile bundle plus the bespoke module manifest.
Parameters
No parameters.
rivr.profile.update_basic
Session
MCP Token
Update the active actor's basic profile fields. Sparse: only fields included in args are touched. Pass JSON null to clear a field; omit a field to leave it untouched (Bug B72 fix).
Parameters
| Param | Type | Required | Description |
|---|---|---|---|
bio | string \ | null | — |
location | string \ | null | — |
name | string | — | |
skills | string[] \ | null | — |
rivr.thanks.send
Session
MCP Token
Send one or more thanks tokens to another agent, optionally attaching a message or resource context.
Parameters
| Param | Type | Required | Description |
|---|---|---|---|
count | number | yes | |
recipientId | string | yes | |
contextId | string | — | Optional resource or post the thanks relates to. |
message | string | — |