MCP Tools — Offerings & Marketplace
Marketplace listings, offerings, and purchase flows.
5 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.offerings.accept
Session
MCP Token
Accept / book an offering. Creates a booking entry via the standard createBookingAction flow. slotDate/slotTime are required only for slot-based offerings; subscription / non-slot offerings (no 'metadata.bookingDates') accept a booking without a slot.
Parameters
| Param | Type | Required | Description |
|---|---|---|---|
offeringId | string | yes | |
notes | string | — | |
slotDate | string | — | ISO date for the booking slot. Optional for non-slot offerings. |
slotTime | string | — | Slot time value, format offering-dependent. Optional for non-slot offerings. |
rivr.offerings.cancel
Session
MCP Token
Cancel/archive an offering. Sets metadata.status='archived' and flips visibility to private.
Parameters
| Param | Type | Required | Description |
|---|---|---|---|
offeringId | string | yes | |
reason | string | — |
rivr.offerings.complete
Session
MCP Token
Mark an offering as fulfilled/completed via metadata.status='completed'.
Parameters
| Param | Type | Required | Description |
|---|---|---|---|
offeringId | string | yes |
rivr.offerings.create
Session
MCP Token
Create an offering (marketplace listing, service, bounty, ticket, skill, product, grant-round, etc). Minimum required fields: title + either items[] or offeringType.
Parameters
| Param | Type | Required | Description |
|---|---|---|---|
targetAgentTypes | string[] | yes | |
title | string | yes | |
acceptedCurrencies | string[] | — | |
availability | string | — | |
basePrice | number | — | |
category | string | — | |
currency | string | — | |
description | string | — | |
grantAllocationEndDate | string | — | |
grantAllocationStartDate | string | — | |
grantAllocationStrategy | string | — | For grant-round offerings: direct-grants, quadratic-funding, badge-gated, retroactive, milestone, or hybrid. |
grantAlloChainId | string | — | |
grantAlloRegistryProfileId | string | — | |
grantAlloStrategyAddress | string | — | |
grantAllowDonations | boolean | — | |
grantAllowProjectApplications | boolean | — | |
grantAllowPublicUpdates | boolean | — | |
grantApplicationCloseDate | string | — | |
grantApplicationOpenDate | string | — | |
grantCurrency | string | — | |
grantFundingGoal | number | — | |
grantPayoutDate | string | — | |
grantRequireMilestones | boolean | — | |
grantRequiresApproval | boolean | — | |
grantSafeAddress | string | — | |
grantUseQuadraticMatching | boolean | — | |
grantWhoCanAllocate | string | — | |
grantWhoCanApply | string | — | |
grantWhoCanFinalize | string | — | |
grantWhoCanReview | string | — | |
hourlyRate | number | — | |
imageUrl | string | — | |
items | object[] | — | |
location | string | — | Free-text location for the offering (e.g. pickup address, neighborhood, city). Optional. |
offeringType | string | — | E.g. service, product, bounty, ticket, skill, voucher, trip, data, grant-round. |
ownerId | string | — | Agent/group that should own the offering (default: actor). |
postToFeed | boolean | — | Also emit a feed post embed for this offering. |
quantityAvailable | number | — | |
scopedGroupIds | string[] | — | |
scopedLocaleIds | string[] | — | |
scopedUserIds | string[] | — | |
tags | string[] | — |
rivr.offerings.list
Session
MCP Token
List offerings owned by the actor (or a specified owner/group).
Parameters
| Param | Type | Required | Description |
|---|---|---|---|
limit | number | — | |
offeringType | string | — | Filter by offering type. |
ownerId | string | — | Owner/group id. Default: actor. |