Home / Servers / PagerDuty API / list_schedules
List schedules
An MCP tool from the PagerDuty API server, hosted on mcp.hjlabs.in.
List schedules List the on-call schedules. A Schedule determines the time periods that users are On-Call. For more information see the API Concepts Document Scoped OAuth requires: schedules.read [GET /schedules]
Name on the gateway: pagerduty_api__list_schedules · read-only.
Parameters
| Name | Type | Description |
|---|---|---|
limit | integer | The number of results per page. |
offset | integer | Offset to start pagination search results. |
total | boolean | By default the total field in pagination responses is set to null to provide… |
query | string | Filters the result, showing only the records whose name matches the query. |
include[] | schedule_layers | overrides_subschedule | final_schedule | Array of additional details to include. |
time_zone | string | Time zone in which results will be rendered. This will default to the current… |
include_next_oncall_for_user | string | Specify an user_id, and the schedule list API will return information about… |
since | string | The start of the date range over which you want to show schedule entries.… |
until | string | The end of the date range over which you want to show schedule entries.… |
team_ids[] | array | An array of team IDs. Only results related to these teams will be returned.… |
How to call it
Through the Smart Gateway, any client can run it by name with call_tool, or let the gateway find it with search_tools:
{
"name": "pagerduty_api__list_schedules",
"arguments": {}
}Or connect the PagerDuty API server directly, which lists 459 tools including this one:
claude mcp add --transport http hj-pagerduty-api https://mcp.hjlabs.in/mcp/pagerduty-api \
--header "Authorization: Bearer YOUR_API_KEY"Try asking
Use the list schedules tool with limit set to ….