Home / Servers / PagerDuty API / list_maintenance_windows

List maintenance windows

An MCP tool from the PagerDuty API server, hosted on mcp.hjlabs.in.

List maintenance windows List existing maintenance windows, optionally filtered by service and/or team, or whether they are from the past, present or future. A Maintenance Window is used to temporarily disable one or more… [GET /maintenance_windows]

Name on the gateway: pagerduty_api__list_maintenance_windows · read-only.

Parameters

NameTypeDescription
querystringFilters the result, showing only the records whose name matches the query.
limitintegerThe number of results per page.
offsetintegerOffset to start pagination search results.
totalbooleanBy default the total field in pagination responses is set to null to provide…
team_ids[]arrayAn array of team IDs. Only results related to these teams will be returned.…
service_ids[]arrayAn array of service IDs. Only results related to these services will be…
include[]teams | services | usersArray of additional Models to include in response.
filterpast | future | ongoing | open | allOnly return maintenance windows in a given state.

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:

call_tool arguments
{
  "name": "pagerduty_api__list_maintenance_windows",
  "arguments": {}
}

Or connect the PagerDuty API server directly, which lists 459 tools including this one:

Run in your terminal
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 maintenance windows tool with query set to ….

More from PagerDuty API