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.
- Recurring Transactions Processed: Alerts when automatic recurring expenses or income are logged.
- 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. - Browsers that cannot set the Authorization header may use
?token=mns_xxxas a query parameter.
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.