Notifications

Send one-way notifications to users via SMS or email. Perfect for status updates and alerts.

Sending Notifications

Use the send_notification tool to send one-way messages:

await mcp.callTool("send_notification", {
  message: "Build complete! All 247 tests passed.",
  channel: "sms"  // or "email"
});

Unlike approval requests, notifications don't wait for a response.

Channel Options

SMS

Best for urgent, time-sensitive notifications. Messages are limited to 160 characters per segment.

Email

Best for detailed notifications with formatting. Can include longer content and links.

Auto (default)

RelayRail chooses the best channel based on user preferences and message content.

Priority Levels

Set priority to influence routing and delivery:

await mcp.callTool("send_notification", {
  message: "Critical: Database connection lost!",
  priority: "high"  // low, normal, high
});
  • high - Always sent via SMS, bypasses quiet hours
  • normal - Uses user's preferred channel
  • low - May be batched or delayed

Use Cases

  • -Build status - Notify when CI/CD completes
  • -Task completion - Alert when long-running tasks finish
  • -Error alerts - Notify about exceptions or failures
  • -Progress updates - Send periodic status during long operations

Rate Limits

PlanEmails/daySMS
Hacker10-
ProUnlimitedPay-as-you-go
TeamUnlimited500 included + pay-as-you-go