MCP Tools — Wallet
Balances, transactions, and wallet operations.
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.payments.backfill_connect_accounts
Session
MCP Token
Ensure every SUBSCRIBING member has a Stripe Connect payment account: local agents holding an active/trialing membership subscription (federated projections are excluded — their accounts belong to their home instance). New activations are provisioned automatically by the Stripe webhook — this backfills members who subscribed before that wiring, and retries activation-time failures. Idempotent and re-run safe — agents that already have an account are counted as existing, and one agent failing does not abort the batch (per-agent failures are returned). Requires platform admin authority (siteRole).
Parameters
No parameters.
rivr.receipts.request_refund
Session
MCP Token
Request a refund for a receipt the actor owns. Issues a Stripe refund against the original payment intent and marks the receipt refund_requested.
Parameters
| Param | Type | Required | Description |
|---|---|---|---|
receiptId | string | yes |
rivr.wallet.deposit_intent
Session
MCP Token
Create a Stripe PaymentIntent to deposit funds into the actor's personal wallet. Returns a clientSecret the caller must confirm client-side; the agent cannot complete card entry itself.
Parameters
| Param | Type | Required | Description |
|---|---|---|---|
amountCents | number | yes |
rivr.wallet.family_withdraw
Session
MCP Token
Request a withdrawal from a family treasury wallet. amountCents is in cents; purpose is a required free-text reason.
Parameters
| Param | Type | Required | Description |
|---|---|---|---|
amountCents | number | yes | |
familyId | string | yes | |
purpose | string | yes |
rivr.wallet.group_deposit
Session
MCP Token
Move funds from the actor's personal wallet into a group's wallet. amountCents is in cents.
Parameters
| Param | Type | Required | Description |
|---|---|---|---|
amountCents | number | yes | |
groupId | string | yes |
rivr.wallet.purchase
Session
MCP Token
Purchase a marketplace listing paid from the actor's wallet balance. subtotalCents is in cents. Optional bookingDate/bookingSlot for slot-based listings.
Parameters
| Param | Type | Required | Description |
|---|---|---|---|
listingId | string | yes | |
subtotalCents | number | yes | |
bookingDate | string | — | |
bookingSlot | string | — | |
dealPostId | string | — |
rivr.wallet.purchase_tickets
Session
MCP Token
Buy event tickets paid from the actor's wallet balance. selections is a list of { ticketProductId, quantity }.
Parameters
| Param | Type | Required | Description |
|---|---|---|---|
eventId | string | yes | |
selections | object[] | yes |
rivr.wallet.request_payout
Session
MCP Token
Request a seller payout of available Stripe-Connect balance. amountCents is in cents. speed is 'standard' or 'instant'. ownerId targets a group payout the actor administers (default: actor).
Parameters
| Param | Type | Required | Description |
|---|---|---|---|
amountCents | number | yes | |
ownerId | string | — | |
speed | enum(standard \ | instant) | — |
rivr.wallet.transfer
Session
MCP Token
Send money (P2P) from the actor's personal wallet to another agent's wallet. amountCents is in cents.
Parameters
| Param | Type | Required | Description |
|---|---|---|---|
amountCents | number | yes | |
recipientAgentId | string | yes | |
message | string | — | Optional note stored with the transaction. |