PagerDuty MCP Server

by wpfleger96
Verified

list_oncalls

List the on-call entries during a given time range.

Args: current_user_context (bool): Use the current user's ID to filter (default: True, cannot be used with user_ids or escalation_policy_ids) schedule_ids (List[str]): Return only on-calls for the specified schedule IDs (optional) user_ids (List[str]): Return only on-calls for the specified user IDs (optional, cannot be used with current_user_context) escalation_policy_ids (List[str]): Return only on-calls for the specified escalation policy IDs (optional, cannot be used with current_user_context) since (str): Start of date range in ISO8601 format (optional). Default is 1 month ago until (str): End of date range in ISO8601 format (optional). Default is now

Returns: Dict[str, Any]: Dictionary containing metadata (count, description) and a list of on-call entries matching the specified criteria

Input Schema

NameRequiredDescriptionDefault
current_user_contextNo
escalation_policy_idsNo
schedule_idsNo
sinceNo
untilNo
user_idsNo

Input Schema (JSON Schema)

{ "properties": { "current_user_context": { "default": true, "title": "Current User Context", "type": "boolean" }, "escalation_policy_ids": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "default": null, "title": "Escalation Policy Ids" }, "schedule_ids": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "default": null, "title": "Schedule Ids" }, "since": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Since" }, "until": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Until" }, "user_ids": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "default": null, "title": "User Ids" } }, "title": "list_oncallsArguments", "type": "object" }