MCP Tools — Mutual Economy
Thanks tokens, points, gifting, and mutual-aid flows.
6 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.assets.book
Session
MCP Token
Book a shared/mutual asset for a date range. startDate/endDate are ISO dates; purpose is required.
Parameters
| Param | Type | Required | Description |
|---|---|---|---|
assetId | string | yes | |
endDate | string | yes | |
purpose | string | yes | |
startDate | string | yes | |
notes | string | — |
rivr.assets.create
Session
MCP Token
Add a shared/mutual asset into a ring so members can book it. Owner is the ring.
Parameters
| Param | Type | Required | Description |
|---|---|---|---|
description | string | yes | |
name | string | yes | |
ringId | string | yes | |
bookingRequired | boolean | — | |
category | string | — | |
location | string | — | |
restrictions | string[] | — | |
tags | string[] | — | |
usageInstructions | string | — | |
value | number | — |
rivr.vouchers.claim
Session
MCP Token
Claim an available voucher for the actor.
Parameters
| Param | Type | Required | Description |
|---|---|---|---|
voucherId | string | yes |
rivr.vouchers.create
Session
MCP Token
Create a voucher offered into a ring. Owner defaults to the actor; pass ownerId to create on behalf of a group the actor can write to.
Parameters
| Param | Type | Required | Description |
|---|---|---|---|
category | string | yes | |
description | string | yes | |
ringId | string | yes | |
title | string | yes | |
estimatedValue | number | — | |
location | string | — | |
maxClaims | number | — | |
ownerId | string | — | |
postToFeed | boolean | — | |
scopedLocaleIds | string[] | — | |
timeCommitment | string | — |
rivr.vouchers.redeem
Session
MCP Token
Redeem a voucher the actor holds, marking it fulfilled.
Parameters
| Param | Type | Required | Description |
|---|---|---|---|
voucherId | string | yes |
rivr.vouchers.send
Session
MCP Token
Gift an existing voucher the actor owns to another agent, with an optional message and resource context.
Parameters
| Param | Type | Required | Description |
|---|---|---|---|
recipientId | string | yes | |
voucherId | string | yes | |
contextId | string | — | Optional resource/post the gift relates to. |
message | string | — |