Messaging
The MCP integration is in preview - tools, parameters, and behavior may change between releases.
Messaging tools push real-time notifications to users and read back notifications that Dime.Scheduler has attached to entities (appointments, tasks, jobs).
Send message
Tool: send_message
Sends a real-time SignalR message to a specific user (by email) or broadcasts to everyone in the current tenant. Use to notify users of schedule changes, urgent updates, or operational events.
| Parameter | Type | Required | Description |
|---|---|---|---|
text | string | Yes | The message text to deliver to the recipient(s) |
userEmail | string | No | Recipient email. Omit to broadcast to everyone in the tenant. |
severity | string | No | Severity level. One of: Verbose, Debug, Info (default), Warning, Error, Fatal. |
When the recipient has no active SignalR connections, the response notes that the message was not delivered.
Example prompt
"Tell John his 14:00 appointment moved to 15:00."
Search notifications
Tool: search_notifications
Searches notifications filtered by entity (appointment, task, or job). At least one of appointmentId, taskId, or jobId is required.
For the most recent notifications without entity filtering, prefer reading the dimescheduler://notifications/recent data source - it returns the same data without consuming a tool call.
| Parameter | Type | Required | Description |
|---|---|---|---|
limit | number | No | Maximum number of notifications (default: 50, max: 500) |
appointmentId | number | No | Appointment id to filter by |
taskId | number | No | Task id to filter by |
jobId | number | No | Job id to filter by |
Example prompt
"Show notifications related to job 42."