OneUptime

List Scheduled Maintenance Events

list_scheduled_maintenance_events

Read-only

List Scheduled Maintenance Events, with the total count.

Tool call template

This tool declares no required parameters. Add optional parameters from the input schema as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {},
    "name": "list_scheduled_maintenance_events"
  }
}

Input Schema

Name	Required	Description
`skip`	No
`sort`	No	For example {"createdAt":"DESC"}.
`limit`	No	Default: 10, maximum: 100.
`query`	No	A field's value, or an operator such as {"_type":"GreaterThan","value":...}. Fields and operators: oneuptime_describe_resource.
`select`	No	Omit for all but dataStoreIds, openStackParts, subscriberNotificationStatusMessage, customFields, sendSubscriberNotificationsOnBeforeTheEvent.

Schema Changelog

Changes observed during successful MCP inspections.

Changed5 schema fields changedNov 6, 2026

changedInput schema / properties / limit / description

Previous value: -"Records to return. Default: 10, maximum: 100."New value: +"Default: 10, maximum: 100."

changedInput schema / properties / query / description

Previous value: -"Filter. Each field takes a value (exact match) or an operator, such as {\"_type\":\"GreaterThan\",\"value\":...}. Fields and operators: oneuptime_describe_resource."New value: +"A field's value, or an operator such as {\"_type\":\"GreaterThan\",\"value\":...}. Fields and operators: oneuptime_describe_resource."

changedInput schema / properties / select / description

Previous value: -"Field names to return. Omit for all but these large fields: subscriberNotificationStatusMessage, customFields, sendSubscriberNotificationsOnBeforeTheEvent."New value: +"Omit for all but dataStoreIds, openStackParts, subscriberNotificationStatusMessage, customFields, sendSubscriberNotificationsOnBeforeTheEvent."

removedInput schema / properties / skip / description
```
Removed value: -"Records to skip. Default: 0."
```

changedInput schema / properties / sort / description

Previous value: -"Fields to sort by. Example: {\"createdAt\":\"DESC\"}."New value: +"For example {\"createdAt\":\"DESC\"}."

Changed9 schema fields changedNov 4, 2026

changedInput schema / properties / limit / description

Previous value: -"Maximum number of records to return. Default: 10, Maximum: 100."New value: +"Records to return. Default: 10, maximum: 100."

changedInput schema / properties / query / additionalProperties
```
Previous value: -falseNew value: +true
```

changedInput schema / properties / query / description

Previous value: -"Filter criteria for Scheduled Maintenance Events. Each field accepts a direct value (exact match) or an operator object {\"_type\": \"<Operator>\", \"value\": ...}. Operators: EqualTo, NotEqual, IsNull, NotNull, EqualToOrNull, GreaterThan, LessThan, GreaterThanOrEqual, LessThanOrEqual, InBetween (numbers/dates), Search (partial text), Includes (array of values). Example — items from the last 24 hours: {\"createdAt\": {\"_type\": \"GreaterThan\", \"value\": \"2026-01-01T00:00:00.000Z\"}}."New value: +"Filter. Each field takes a value (exact match) or an operator, such as {\"_type\":\"GreaterThan\",\"value\":...}. Fields and operators: oneuptime_describe_resource."

removedInput schema / properties / query / properties

Removed value: -{
-  "_id": {
-    "description": "Query operators for _id field of type Object ID. Supported operators: EqualTo, NotEqual, IsNull, NotNull, EqualToOrNull, Includes",
-    "example": {
-      "_type": "EqualTo",
-      "value": "aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaa"
-    },
-    "type": "object"
-  },
-  "cephClusters": {
-    "description": "Query operators for cephClusters field of type Entity Array. Supported operators: EqualTo, NotEqual, IsNull, NotNull, Includes",
-    "example": {
-      "_type": "EqualTo",
-      "value": "example_value_1"
-    },
-    "type": "object"
-  },
-  "changeMonitorStatusToId": {
-    "description": "Query operators for changeMonitorStatusToId field of type Object ID. Supported operators: EqualTo, NotEqual, IsNull, NotNull, EqualToOrNull, Includes",
-    "example": {
-      "_type": "EqualTo",
-      "value": "aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaa"
-    },
-    "type": "object"
-  },
-  "createdAt": {
-    "description": "Query operators for createdAt field of type Date. Supported operators: EqualTo, NotEqual, IsNull, NotNull, EqualToOrNull, GreaterThan, LessThan, GreaterThanOrEqual, LessThanOrEqual, InBetween",
-    "example": {
-      "_type": "EqualTo",
-      "value": "2023-01-01T00:00:00.000Z"
-    },
-    "type": "object"
-  },
-  "createdByUserId": {
-    "description": "Query operators for createdByUserId field of type Object ID. Supported operators: EqualTo, NotEqual, IsNull, NotNull, EqualToOrNull, Includes",
-    "example": {
-      "_type": "EqualTo",
-      "value": "aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaa"
-    },
-    "type": "object"
-  },
-  "currentScheduledMaintenanceStateId": {
-    "description": "Query operators for currentScheduledMaintenanceStateId field of type Object ID. Supported operators: EqualTo, NotEqual, IsNull, NotNull, EqualToOrNull, Includes",
-    "example": {
-      "_type": "EqualTo",
-      "value": "aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaa"
-    },
-    "type": "object"
-  },
-  "customFields": {
-    "description": "Query operators for customFields field of type JSON. Supported operators: EqualTo, NotEqual, IsNull, NotNull",
-    "example": {
-      "_type": "EqualTo",
-      "value": "example_value_1"
-    },
-    "type": "object"
-  },
-  "databaseServers": {
-    "description": "Query operators for databaseServers field of type Entity Array. Supported operators: EqualTo, NotEqual, IsNull, NotNull, Includes",
-    "example": {
-      "_type": "EqualTo",
-      "value": "example_value_1"
-    },
-    "type": "object"
-  },
-  "deletedAt": {
-    "description": "Query operators for deletedAt field of type Date. Supported operators: EqualTo, NotEqual, IsNull, NotNull, EqualToOrNull, GreaterThan, LessThan, GreaterThanOrEqual, LessThanOrEqual, InBetween",
-    "example": {
-      "_type": "EqualTo",
-      "value": "2023-01-01T00:00:00.000Z"
-    },
-    "type": "object"
-  },
-  "deletedByUserId": {
-    "description": "Query operators for deletedByUserId field of type Object ID. Supported operators: EqualTo, NotEqual, IsNull, NotNull, EqualToOrNull, Includes",
-    "example": {
-      "_type": "EqualTo",
-      "value": "aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaa"
-    },
-    "type": "object"
-  },
-  "description": {
-    "description": "Query operators for description field of type Markdown. Supported operators: EqualTo, NotEqual, IsNull, NotNull, EqualToOrNull, Search, Includes",
-    "example": {
-      "_type": "EqualTo",
-      "value": "example_value_1"
-    },
-    "type": "object"
-  },
-  "dockerHosts": {
-    "description": "Query operators for dockerHosts field of type Entity Array. Supported operators: EqualTo, NotEqual, IsNull, NotNull, Includes",
-    "example": {
-      "_type": "EqualTo",
-      "value": "example_value_1"
-    },
-    "type": "object"
-  },
-  "dockerSwarmClusters": {
-    "description": "Query operators for dockerSwarmClusters field of type Entity Array. Supported operators: EqualTo, NotEqual, IsNull, NotNull, Includes",
-    "example": {
-      "_type": "EqualTo",
-      "value": "example_value_1"
-    },
-    "type": "object"
-  },
-  "enableReminders": {
-    "description": "Query operators for enableReminders field of type Boolean. Supported operators: EqualTo, NotEqual, IsNull, NotNull, EqualToOrNull",
-    "example": {
-      "_type": "EqualTo",
-      "value": true
-    },
-    "type": "object"
-  },
-  "endsAt": {
-    "description": "Query operators for endsAt field of type Date. Supported operators: EqualTo, NotEqual, IsNull, NotNull, EqualToOrNull, GreaterThan, LessThan, GreaterThanOrEqual, LessThanOrEqual, InBetween",
-    "example": {
-      "_type": "EqualTo",
-      "value": "2023-01-01T00:00:00.000Z"
-    },
-    "type": "object"
-  },
-  "hosts": {
-    "description": "Query operators for hosts field of type Entity Array. Supported operators: EqualTo, NotEqual, IsNull, NotNull, Includes",
-    "example": {
-      "_type": "EqualTo",
-      "value": "example_value_1"
-    },
-    "type": "object"
-  },
-  "iotFleets": {
-    "description": "Query operators for iotFleets field of type Entity Array. Supported operators: EqualTo, NotEqual, IsNull, NotNull, Includes",
-    "example": {
-      "_type": "EqualTo",
-      "value": "example_value_1"
-    },
-    "type": "object"
-  },
-  "isOwnerNotifiedOfResourceCreation": {
-    "description": "Query operators for isOwnerNotifiedOfResourceCreation field of type Boolean. Supported operators: EqualTo, NotEqual, IsNull, NotNull, EqualToOrNull",
-    "example": {
-      "_type": "EqualTo",
-      "value": true
-    },
-    "type": "object"
-  },
-  "isVisibleOnStatusPage": {
-    "description": "Query operators for isVisibleOnStatusPage field of type Boolean. Supported operators: EqualTo, NotEqual, IsNull, NotNull, EqualToOrNull",
-    "example": {
-      "_type": "EqualTo",
-      "value": true
-    },
-    "type": "object"
-  },
-  "kubernetesClusters": {
-    "description": "Query operators for kubernetesClusters field of type Entity Array. Supported operators: EqualTo, NotEqual, IsNull, NotNull, Includes",
-    "example": {
-      "_type": "EqualTo",
-      "value": "example_value_1"
-    },
-    "type": "object"
-  },
-  "labels": {
-    "description": "Query operators for labels field of type Entity Array. Supported operators: EqualTo, NotEqual, IsNull, NotNull, Includes",
-    "example": {
-      "_type": "EqualTo",
-      "value": "example_value_1"
-    },
-    "type": "object"
-  },
-  "monitors": {
-    "description": "Query operators for monitors field of type Entity Array. Supported operators: EqualTo, NotEqual, IsNull, NotNull, Includes",
-    "example": {
-      "_type": "EqualTo",
-      "value": "example_value_1"
-    },
-    "type": "object"
-  },
-  "networkSites": {
-    "description": "Query operators for networkSites field of type Entity Array. Supported operators: EqualTo, NotEqual, IsNull, NotNull, Includes",
-    "example": {
-      "_type": "EqualTo",
-      "value": "example_value_1"
-    },
-    "type": "object"
-  },
-  "nextReminderNotificationAt": {
-    "description": "Query operators for nextReminderNotificationAt field of type Date. Supported operators: EqualTo, NotEqual, IsNull, NotNull, EqualToOrNull, GreaterThan, LessThan, GreaterThanOrEqual, LessThanOrEqual, InBetween",
-    "example": {
-      "_type": "EqualTo",
-      "value": "2023-01-01T00:00:00.000Z"
-    },
-    "type": "object"
-  },
-  "nextSubscriberNotificationBeforeTheEventAt": {
-    "description": "Query operators for nextSubscriberNotificationBeforeTheEventAt field of type Date. Supported operators: EqualTo, NotEqual, IsNull, NotNull, EqualToOrNull, GreaterThan, LessThan, GreaterThanOrEqual, LessThanOrEqual, InBetween",
-    "example": {
-      "_type": "EqualTo",
-      "value": "2023-01-01T00:00:00.000Z"
-    },
-    "type": "object"
-  },
-  "podmanHosts": {
-    "description": "Query operators for podmanHosts field of type Entity Array. Supported operators: EqualTo, NotEqual, IsNull, NotNull, Includes",
-    "example": {
-      "_type": "EqualTo",
-      "value": "example_value_1"
-    },
-    "type": "object"
-  },
-  "postUpdatesToWorkspaceChannels": {
-    "description": "Query operators for postUpdatesToWorkspaceChannels field of type JSON. Supported operators: EqualTo, NotEqual, IsNull, NotNull",
-    "example": {
-      "_type": "EqualTo",
-      "value": "example_value_1"
-    },
-    "type": "object"
-  },
-  "projectId": {
-    "description": "Query operators for projectId field of type Object ID. Supported operators: EqualTo, NotEqual, IsNull, NotNull, EqualToOrNull, Includes",
-    "example": {
-      "_type": "EqualTo",
-      "value": "aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaa"
-    },
-    "type": "object"
-  },
-  "proxmoxClusters": {
-    "description": "Query operators for proxmoxClusters field of type Entity Array. Supported operators: EqualTo, NotEqual, IsNull, NotNull, Includes",
-    "example": {
-      "_type": "EqualTo",
-      "value": "example_value_1"
-    },
-    "type": "object"
-  },
-  "publishOnStatusPageAt": {
-    "description": "Query operators for publishOnStatusPageAt field of type Date. Supported operators: EqualTo, NotEqual, IsNull, NotNull, EqualToOrNull, GreaterThan, LessThan, GreaterThanOrEqual, LessThanOrEqual, InBetween",
-    "example": {
-      "_type": "EqualTo",
-      "value": "2023-01-01T00:00:00.000Z"
-    },
-    "type": "object"
-  },
-  "reminderNotificationSentCount": {
-    "description": "Query operators for reminderNotificationSentCount field of type Number. Supported operators: EqualTo, NotEqual, IsNull, NotNull, EqualToOrNull, GreaterThan, LessThan, GreaterThanOrEqual, LessThanOrEqual, InBetween",
-    "example": {
-      "_type": "EqualTo",
-      "value": 50
-    },
-    "type": "object"
-  },
-  "scheduledMaintenanceNumber": {
-    "description": "Query operators for scheduledMaintenanceNumber field of type Number. Supported operators: EqualTo, NotEqual, IsNull, NotNull, EqualToOrNull, GreaterThan, LessThan, GreaterThanOrEqual, LessThanOrEqual, InBetween",
-    "example": {
-      "_type": "EqualTo",
-      "value": 50
-    },
-    "type": "object"
-  },
-  "scheduledMaintenanceNumberWithPrefix": {
-    "description": "Query operators for scheduledMaintenanceNumberWithPrefix field of type Text. Supported operators: EqualTo, NotEqual, IsNull, NotNull, EqualToOrNull, Search, Includes",
-    "example": {
-      "_type": "EqualTo",
-      "value": "John Doe"
-    },
-    "type": "object"
-  },
-  "sendSubscriberNotificationsOnBeforeTheEvent": {
-    "description": "Query operators for sendSubscriberNotificationsOnBeforeTheEvent field of type JSON. Supported operators: EqualTo, NotEqual, IsNull, NotNull",
-    "example": {
-      "_type": "EqualTo",
-      "value": "example_value_1"
-    },
-    "type": "object"
-  },
-  "services": {
-    "description": "Query operators for services field of type Entity Array. Supported operators: EqualTo, NotEqual, IsNull, NotNull, Includes",
-    "example": {
-      "_type": "EqualTo",
-      "value": "example_value_1"
-    },
-    "type": "object"
-  },
-  "shouldStatusPageSubscribersBeNotifiedOnEventCreated": {
-    "description": "Query operators for shouldStatusPageSubscribersBeNotifiedOnEventCreated field of type Boolean. Supported operators: EqualTo, NotEqual, IsNull, NotNull, EqualToOrNull",
-    "example": {
-      "_type": "EqualTo",
-      "value": true
-    },
-    "type": "object"
-  },
-  "shouldStatusPageSubscribersBeNotifiedWhenEventChangedToEnded": {
-    "description": "Query operators for shouldStatusPageSubscribersBeNotifiedWhenEventChangedToEnded field of type Boolean. Supported operators: EqualTo, NotEqual, IsNull, NotNull, EqualToOrNull",
-    "example": {
-      "_type": "EqualTo",
-      "value": true
-    },
-    "type": "object"
-  },
-  "shouldStatusPageSubscribersBeNotifiedWhenEventChangedToOngoing": {
-    "description": "Query operators for shouldStatusPageSubscribersBeNotifiedWhenEventChangedToOngoing field of type Boolean. Supported operators: EqualTo, NotEqual, IsNull, NotNull, EqualToOrNull",
-    "example": {
-      "_type": "EqualTo",
-      "value": true
-    },
-    "type": "object"
-  },
-  "slug": {
-    "description": "Query operators for slug field of type Slug. Supported operators: EqualTo, NotEqual, IsNull, NotNull, EqualToOrNull, Includes",
-    "example": {
-      "_type": "EqualTo",
-      "value": "example_value_1"
-    },
-    "type": "object"
-  },
-  "startsAt": {
-    "description": "Query operators for startsAt field of type Date. Supported operators: EqualTo, NotEqual, IsNull, NotNull, EqualToOrNull, GreaterThan, LessThan, GreaterThanOrEqual, LessThanOrEqual, InBetween",
-    "example": {
-      "_type": "EqualTo",
-      "value": "2023-01-01T00:00:00.000Z"
-    },
-    "type": "object"
-  },
-  "statusPages": {
-    "description": "Query operators for statusPages field of type Entity Array. Supported operators: EqualTo, NotEqual, IsNull, NotNull, Includes",
-    "example": {
-      "_type": "EqualTo",
-      "value": "example_value_1"
-    },
-    "type": "object"
-  },
-  "storageArrays": {
-    "description": "Query operators for storageArrays field of type Entity Array. Supported operators: EqualTo, NotEqual, IsNull, NotNull, Includes",
-    "example": {
-      "_type": "EqualTo",
-      "value": "example_value_1"
-    },
-    "type": "object"
-  },
-  "subscriberNotificationStatusMessage": {
-    "description": "Query operators for subscriberNotificationStatusMessage field of type Very Long Text. Supported operators: EqualTo, NotEqual, IsNull, NotNull, EqualToOrNull, Search, Includes",
-    "example": {
-      "_type": "EqualTo",
-      "value": "example_value_1"
-    },
-    "type": "object"
-  },
-  "subscriberNotificationStatusOnEventScheduled": {
-    "description": "Query operators for subscriberNotificationStatusOnEventScheduled field of type Text. Supported operators: EqualTo, NotEqual, IsNull, NotNull, EqualToOrNull, Search, Includes",
-    "example": {
-      "_type": "EqualTo",
-      "value": "John Doe"
-    },
-    "type": "object"
-  },
-  "title": {
-    "description": "Query operators for title field of type Text. Supported operators: EqualTo, NotEqual, IsNull, NotNull, EqualToOrNull, Search, Includes",
-    "example": {
-      "_type": "EqualTo",
-      "value": "John Doe"
-    },
-    "type": "object"
-  },
-  "updatedAt": {
-    "description": "Query operators for updatedAt field of type Date. Supported operators: EqualTo, NotEqual, IsNull, NotNull, EqualToOrNull, GreaterThan, LessThan, GreaterThanOrEqual, LessThanOrEqual, InBetween",
-    "example": {
-      "_type": "EqualTo",
-      "value": "2023-01-01T00:00:00.000Z"
-    },
-    "type": "object"
-  },
-  "version": {
-    "description": "Query operators for version field of type Number. Supported operators: EqualTo, NotEqual, IsNull, NotNull, EqualToOrNull, GreaterThan, LessThan, GreaterThanOrEqual, LessThanOrEqual, InBetween",
-    "example": {
-      "_type": "EqualTo",
-      "value": 50
-    },
-    "type": "object"
-  },
-  "vmwareVCenters": {
-    "description": "Query operators for vmwareVCenters field of type Entity Array. Supported operators: EqualTo, NotEqual, IsNull, NotNull, Includes",
-    "example": {
-      "_type": "EqualTo",
-      "value": "example_value_1"
-    },
-    "type": "object"
-  }
-}

changedInput schema / properties / select / description

Previous value: -"Optional: field names to return for each Scheduled Maintenance Event (e.g. [\"_id\", \"name\"]). Omit to get all readable fields. Large fields excluded by default (request explicitly if needed): subscriberNotificationStatusMessage, customFields, sendSubscriberNotificationsOnBeforeTheEvent."New value: +"Field names to return. Omit for all but these large fields: subscriberNotificationStatusMessage, customFields, sendSubscriberNotificationsOnBeforeTheEvent."

changedInput schema / properties / skip / description

Previous value: -"Number of records to skip for pagination. Default: 0. Example: skip=10 to start from the 11th record."New value: +"Records to skip. Default: 0."

changedInput schema / properties / sort / additionalProperties

Previous value: -falseNew value: +{
+  "enum": [
+    "ASC",
+    "DESC"
+  ],
+  "type": "string"
+}

changedInput schema / properties / sort / description

Previous value: -"Sort order for results. Use \"ASC\" for ascending or \"DESC\" for descending. Example: {\"createdAt\": \"DESC\"} to sort by newest first."New value: +"Fields to sort by. Example: {\"createdAt\":\"DESC\"}."

removedInput schema / properties / sort / properties

Removed value: -{
-  "_id": {
-    "description": "Sort order for _id field",
-    "enum": [
-      "ASC",
-      "DESC"
-    ],
-    "example": "ASC",
-    "type": "string"
-  },
-  "changeMonitorStatusToId": {
-    "description": "Sort order for changeMonitorStatusToId field",
-    "enum": [
-      "ASC",
-      "DESC"
-    ],
-    "example": "ASC",
-    "type": "string"
-  },
-  "createdAt": {
-    "description": "Sort order for createdAt field",
-    "enum": [
-      "ASC",
-      "DESC"
-    ],
-    "example": "ASC",
-    "type": "string"
-  },
-  "createdByUserId": {
-    "description": "Sort order for createdByUserId field",
-    "enum": [
-      "ASC",
-      "DESC"
-    ],
-    "example": "ASC",
-    "type": "string"
-  },
-  "currentScheduledMaintenanceStateId": {
-    "description": "Sort order for currentScheduledMaintenanceStateId field",
-    "enum": [
-      "ASC",
-      "DESC"
-    ],
-    "example": "ASC",
-    "type": "string"
-  },
-  "deletedAt": {
-    "description": "Sort order for deletedAt field",
-    "enum": [
-      "ASC",
-      "DESC"
-    ],
-    "example": "ASC",
-    "type": "string"
-  },
-  "deletedByUserId": {
-    "description": "Sort order for deletedByUserId field",
-    "enum": [
-      "ASC",
-      "DESC"
-    ],
-    "example": "ASC",
-    "type": "string"
-  },
-  "enableReminders": {
-    "description": "Sort order for enableReminders field",
-    "enum": [
-      "ASC",
-      "DESC"
-    ],
-    "example": "ASC",
-    "type": "string"
-  },
-  "endsAt": {
-    "description": "Sort order for endsAt field",
-    "enum": [
-      "ASC",
-      "DESC"
-    ],
-    "example": "ASC",
-    "type": "string"
-  },
-  "isOwnerNotifiedOfResourceCreation": {
-    "description": "Sort order for isOwnerNotifiedOfResourceCreation field",
-    "enum": [
-      "ASC",
-      "DESC"
-    ],
-    "example": "ASC",
-    "type": "string"
-  },
-  "isVisibleOnStatusPage": {
-    "description": "Sort order for isVisibleOnStatusPage field",
-    "enum": [
-      "ASC",
-      "DESC"
-    ],
-    "example": "ASC",
-    "type": "string"
-  },
-  "nextReminderNotificationAt": {
-    "description": "Sort order for nextReminderNotificationAt field",
-    "enum": [
-      "ASC",
-      "DESC"
-    ],
-    "example": "ASC",
-    "type": "string"
-  },
-  "nextSubscriberNotificationBeforeTheEventAt": {
-    "description": "Sort order for nextSubscriberNotificationBeforeTheEventAt field",
-    "enum": [
-      "ASC",
-      "DESC"
-    ],
-    "example": "ASC",
-    "type": "string"
-  },
-  "projectId": {
-    "description": "Sort order for projectId field",
-    "enum": [
-      "ASC",
-      "DESC"
-    ],
-    "example": "ASC",
-    "type": "string"
-  },
-  "publishOnStatusPageAt": {
-    "description": "Sort order for publishOnStatusPageAt field",
-    "enum": [
-      "ASC",
-      "DESC"
-    ],
-    "example": "ASC",
-    "type": "string"
-  },
-  "reminderNotificationSentCount": {
-    "description": "Sort order for reminderNotificationSentCount field",
-    "enum": [
-      "ASC",
-      "DESC"
-    ],
-    "example": "ASC",
-    "type": "string"
-  },
-  "scheduledMaintenanceNumber": {
-    "description": "Sort order for scheduledMaintenanceNumber field",
-    "enum": [
-      "ASC",
-      "DESC"
-    ],
-    "example": "ASC",
-    "type": "string"
-  },
-  "scheduledMaintenanceNumberWithPrefix": {
-    "description": "Sort order for scheduledMaintenanceNumberWithPrefix field",
-    "enum": [
-      "ASC",
-      "DESC"
-    ],
-    "example": "ASC",
-    "type": "string"
-  },
-  "shouldStatusPageSubscribersBeNotifiedOnEventCreated": {
-    "description": "Sort order for shouldStatusPageSubscribersBeNotifiedOnEventCreated field",
-    "enum": [
-      "ASC",
-      "DESC"
-    ],
-    "example": "ASC",
-    "type": "string"
-  },
-  "shouldStatusPageSubscribersBeNotifiedWhenEventChangedToEnded": {
-    "description": "Sort order for shouldStatusPageSubscribersBeNotifiedWhenEventChangedToEnded field",
-    "enum": [
-      "ASC",
-      "DESC"
-    ],
-    "example": "ASC",
-    "type": "string"
-  },
-  "shouldStatusPageSubscribersBeNotifiedWhenEventChangedToOngoing": {
-    "description": "Sort order for shouldStatusPageSubscribersBeNotifiedWhenEventChangedToOngoing field",
-    "enum": [
-      "ASC",
-      "DESC"
-    ],
-    "example": "ASC",
-    "type": "string"
-  },
-  "slug": {
-    "description": "Sort order for slug field",
-    "enum": [
-      "ASC",
-      "DESC"
-    ],
-    "example": "ASC",
-    "type": "string"
-  },
-  "startsAt": {
-    "description": "Sort order for startsAt field",
-    "enum": [
-      "ASC",
-      "DESC"
-    ],
-    "example": "ASC",
-    "type": "string"
-  },
-  "subscriberNotificationStatusMessage": {
-    "description": "Sort order for subscriberNotificationStatusMessage field",
-    "enum": [
-      "ASC",
-      "DESC"
-    ],
-    "example": "ASC",
-    "type": "string"
-  },
-  "subscriberNotificationStatusOnEventScheduled": {
-    "description": "Sort order for subscriberNotificationStatusOnEventScheduled field",
-    "enum": [
-      "ASC",
-      "DESC"
-    ],
-    "example": "ASC",
-    "type": "string"
-  },
-  "title": {
-    "description": "Sort order for title field",
-    "enum": [
-      "ASC",
-      "DESC"
-    ],
-    "example": "ASC",
-    "type": "string"
-  },
-  "updatedAt": {
-    "description": "Sort order for updatedAt field",
-    "enum": [
-      "ASC",
-      "DESC"
-    ],
-    "example": "ASC",
-    "type": "string"
-  },
-  "version": {
-    "description": "Sort order for version field",
-    "enum": [
-      "ASC",
-      "DESC"
-    ],
-    "example": "ASC",
-    "type": "string"
-  }
-}

Changed2 schema fields changedOct 28, 2026

addedInput schema / properties / query / properties / publishOnStatusPageAt

Added value: +{
+  "description": "Query operators for publishOnStatusPageAt field of type Date. Supported operators: EqualTo, NotEqual, IsNull, NotNull, EqualToOrNull, GreaterThan, LessThan, GreaterThanOrEqual, LessThanOrEqual, InBetween",
+  "example": {
+    "_type": "EqualTo",
+    "value": "2023-01-01T00:00:00.000Z"
+  },
+  "type": "object"
+}

addedInput schema / properties / sort / properties / publishOnStatusPageAt

Added value: +{
+  "description": "Sort order for publishOnStatusPageAt field",
+  "enum": [
+    "ASC",
+    "DESC"
+  ],
+  "example": "ASC",
+  "type": "string"
+}

First observedOct 19, 2026

TDQS

C2.4/5.0

Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already declare readOnlyHint=true, destructiveHint=false, and openWorldHint=false, so the safety profile is covered. The description's only added behavioral fact is that a total count accompanies the results, which is genuinely useful but thin; nothing is said about pagination behavior (default 10, max 100 lives only in the schema) or ordering defaults.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness2/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The single sentence contains no wasted words, but for a five-parameter list tool with nested sort/query objects it is under-specified rather than concise. Brevity here comes at the cost of any operational guidance.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

With five optional parameters, nested objects, no required fields, and no output schema, the description should explain filtering, sorting, and the selectable-field caveat. Instead it covers only that a total count is returned, leaving the agent to reconstruct everything else from the schema and the generic oneuptime_describe_resource pointer.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 80%, with skip, sort, query, and select documented in the schema, so the baseline of 3 applies. The description adds no meaning for any parameter and does not explain the nested query operator convention beyond what the schema already states.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose2/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description restates the title almost verbatim ("List Scheduled Maintenance Events") and adds only "with the total count." It does not distinguish this from siblings such as count_scheduled_maintenance_events, get_scheduled_maintenance_event, or list_scheduled_maintenance_states beyond what the tool name already conveys.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

There is no guidance on when to use this tool: no mention of when to prefer count_scheduled_maintenance_events for counts alone, nor when get_scheduled_maintenance_event is the right choice for a single record. Usage must be inferred entirely from the name.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

All OneUptime tools Inspect

Try in Browser

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Glama MCP Gateway

Add one secure layer between your agents and this server.