list_oncalls

Retrieve on-call entries within a specified time range, filtered by user, schedule, or escalation policy IDs, to manage and monitor PagerDuty schedules effectively.

Instructions

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

Name	Required	Description	Default
`current_user_context`	No
`escalation_policy_ids`	No
`schedule_ids`	No
`since`	No
`until`	No
`user_ids`	No

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"
}

PagerDuty MCP Server

list_oncalls

Instructions

Input Schema

Input Schema (JSON Schema)

Other Tools from PagerDuty MCP Server

Related Tools