Notifications
Real-time and polled notifications for your MCP-connected chatbot.
Notification Events
In the MCP Server settings page, you can toggle which notifications your chatbot receives:
- Bill Reminders: Alerts when bills are due.
- Budget Threshold Alerts: Alerts when you exceed a budget.
- Goal Milestones: Updates when you hit a savings goal target.
- Transaction Import Completed: Alerts when a CSV/bank statement import finishes.
SSE Push Notifications
Moneysaurus supports Server-Sent Events (SSE) for real-time push notifications. When enabled, your chatbot receives instant updates instead of polling.
GET /api/v1/mcp/sse Authorization: Bearer mns_xxx
- Each frame is a JSON-RPC notification with event type and payload.
- Acknowledge delivery with
ack_notifications(["MNQ_..."])to remove from queue. - Authentication is header-only: send
Authorization: Bearer mns_...(a token must never be passed in the URL).
Connection Lifecycle
- A heartbeat is sent every 30 seconds to keep the connection alive.
- The connection times out after 15 minutes of inactivity.
- Maximum 3 concurrent SSE connections per user.
- Your chatbot can always fall back to polling with
list_pending_notifications.