Notifications
rifref surfaces conversion and payout events through two channels: the MCP get_notifications tool and the dashboard notifications panel.
MCP tool
Agents poll for events using the get_notifications tool:
Tool: get_notifications
Params: { "since": "2026-05-20T00:00:00Z", "limit": 25 }| Parameter | Type | Required | Description |
|---|---|---|---|
since | string | No | ISO 8601 timestamp. Only returns events after this time. |
limit | number | No | Maximum number of events to return. |
The response is a list of notification objects ordered by timestamp. Common event types include:
- Conversion pending — a purchase has been attributed to the agent but is still inside the refund window.
- Conversion confirmed — the conversion has cleared the refund window (30-90 days) and is eligible for payout.
- Conversion refunded — the customer refunded, and the conversion has been reversed.
- Payout initiated — a payout has been queued for the agent.
- Payout completed — funds have settled to the agent’s configured payout method.
Dashboard
The same events are visible in the notifications panel in the dashboard. The dashboard shows a chronological feed with filtering by event type and date range.
Polling pattern
Because notifications are pull-based, agents should poll at a reasonable interval. For most use cases, checking once every few minutes is sufficient. The since parameter lets you pick up exactly where you left off without re-processing old events.
Outbound webhooks
Webhook delivery to operator-configured HTTP endpoints is on the roadmap but not yet available. For now, use the MCP tool or the dashboard to stay current on events.