MCP Tools — Events
Event creation, updates, RSVP, and ticketing.
9 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.events.cancel
Session
MCP Token
Cancel an event. Soft-deletes the resource and notifies attendees via the existing cancelEventAction flow.
Parameters
| Param | Type | Required | Description |
|---|---|---|---|
eventId | string | yes |
rivr.events.create
Session
MCP Token
Create an event. eventType must be exactly 'in-person' or 'online' (no other values are accepted). For private events, pass scopedUserIds with the invited agents; that also flips visibility to 'private'. Provide endDate and endTime to give the event a real end; otherwise the UI defaults to start + 2h. The creator is recorded as the lead host automatically when no hosts are supplied.
Parameters
| Param | Type | Required | Description |
|---|---|---|---|
date | string | yes | ISO date (YYYY-MM-DD). |
description | string | yes | |
eventType | enum(in-person \ | online) | yes |
location | string | yes | |
time | string | yes | Local time, e.g. '18:30'. |
title | string | yes | |
endDate | string | — | Optional ISO end date (YYYY-MM-DD). Defaults to the start date when only endTime is supplied. |
endTime | string | — | Optional local end time (HH:MM), e.g. '20:30'. |
groupId | string | — | |
imageUrl | string | — | |
isGlobal | boolean | — | |
localeId | string | — | |
price | number | — | |
projectId | string | — | |
scopedGroupIds | string[] | — | |
scopedLocaleIds | string[] | — | |
scopedUserIds | string[] | — | Invitee agent ids for a private event. Presence of scoped ids flips visibility away from 'public'. |
ticketTypes | object[] | — | Optional explicit ticket tier override. If any tier carries a positive price, the event is treated as paid and no free fallback tier is auto-added. Caller-supplied tickets take precedence over the legacy 'price' field. |
rivr.events.decline
Session
MCP Token
Decline an event invitation. Shorthand for events.rsvp with status='none' (clears any prior RSVP).
Parameters
| Param | Type | Required | Description |
|---|---|---|---|
eventId | string | yes |
rivr.events.get
Session
MCP Token
Fetch an event resource plus its active attendees.
Parameters
| Param | Type | Required | Description |
|---|---|---|---|
eventId | string | yes |
rivr.events.invite
Session
MCP Token
Add attendees to a private event by appending their agent ids to metadata.scopedUserIds and granting view access in the ledger.
Parameters
| Param | Type | Required | Description |
|---|---|---|---|
eventId | string | yes | |
userIds | string[] | yes |
rivr.events.list
Session
MCP Token
List events visible to the actor: events the actor owns, events the actor RSVP'd / was invited to / is attending, events owned by a group the actor belongs to, and public events. Pass 'ownerId' or 'groupId' to scope strictly to that owner. Future events appear first; past events are included unless 'onlyUpcoming' is true.
Parameters
| Param | Type | Required | Description |
|---|---|---|---|
groupId | string | — | Filter strictly by owning group (skips visibility expansion). |
limit | number | — | |
onlyUpcoming | boolean | — | |
ownerId | string | — | Filter strictly by owner agent id (skips visibility expansion). |
rivr.events.rsvp
Session
MCP Token
Set RSVP status for an event.
Parameters
| Param | Type | Required | Description |
|---|---|---|---|
eventId | string | yes | |
status | enum(going \ | interested \ | none) |
rivr.events.rsvp
Session
MCP Token
Set RSVP status for an event: going, interested, or none (clear RSVP).
Parameters
| Param | Type | Required | Description |
|---|---|---|---|
eventId | string | yes | |
status | enum(going \ | interested \ | none) |
rivr.events.update
Session
MCP Token
Update an event's title/name, description, tags, schedule (date/time, endDate/endTime), location, eventType, price, imageUrl, or arbitrary metadata patch (ticketTypes, etc). Top-level event fields are merged into the resource's metadata.
Parameters
| Param | Type | Required | Description |
|---|---|---|---|
eventId | string | yes | |
date | string | — | ISO date (YYYY-MM-DD). |
description | string | — | |
endDate | string | — | Optional ISO end date (YYYY-MM-DD). |
endTime | string | — | Optional local end time (HH:MM), e.g. '20:30'. |
eventType | enum(in-person \ | online) | — |
imageUrl | string | — | |
location | string | — | |
metadataPatch | object | — | |
name | string | — | Alias for title. |
price | number | — | |
tags | string[] | — | |
time | string | — | Local time, e.g. '18:30'. |
title | string | — | New event title (also updates the resource name). |