Home / Servers / PagerDuty API / list_on_calls
List all of the on-calls
An MCP tool from the PagerDuty API server, hosted on mcp.hjlabs.in.
List all of the on-calls List the on-call entries during a given time range. An on-call represents a contiguous unit of time for which a User will be on call for a given Escalation Policy and Escalation Rules. For more… [GET /oncalls]
Name on the gateway: pagerduty_api__list_on_calls · read-only.
Parameters
| Name | Type | Description |
|---|---|---|
time_zone | string | Time zone in which results will be rendered. This will default to the account… |
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… |
include[] | escalation_policies | users | schedules | Array of additional details to include. |
user_ids[] | array | Filters the results, showing only on-calls for the specified user IDs. |
escalation_policy_ids[] | array | Filters the results, showing only on-calls for the specified escalation policy… |
schedule_ids[] | array | Filters the results, showing only on-calls for the specified schedule IDs. If… |
since | string | The start of the time range over which you want to search. If an on-call… |
until | string | The end of the time range over which you want to search. If an on-call period… |
earliest | boolean | This will filter on-calls such that only the earliest on-call for each… |
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_on_calls",
"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 all of the on-calls tool with time_zone set to ….