Home / Servers / PagerDuty API / list_incidents
List incidents
An MCP tool from the PagerDuty API server, hosted on mcp.hjlabs.in.
List incidents List existing incidents. An incident represents a problem or an issue that needs to be addressed and resolved. For more information see the API Concepts Document Scoped OAuth requires: incidents.read [GET /incidents]
Name on the gateway: pagerduty_api__list_incidents · read-only.
Parameters
| Name | Type | Description |
|---|---|---|
limit | integer | The number of results per page. Maximum of 100. |
offset | integer | Offset to start pagination search results. |
total | boolean | By default the total field in pagination responses is set to null to provide… |
date_range | all | When set to all, the since and until parameters and defaults are ignored. |
incident_key | string | Incident de-duplication key. Incidents with child alerts do not have an… |
service_ids[] | array | Returns only the incidents associated with the passed service(s). This expects… |
team_ids[] | array | An array of team IDs. Only results related to these teams will be returned.… |
user_ids[] | array | Returns only the incidents currently assigned to the passed user(s). This… |
urgencies[] | high | low | Array of the urgencies of the incidents to be returned. Defaults to all… |
time_zone | string | Time zone used to render timestamps and to interpret since/until values before… |
statuses[] | triggered | acknowledged | resolved | Return only incidents with the given statuses. To query multiple statuses… |
sort_by | array | Used to specify both the field you wish to sort the results on… |
include[] | acknowledgers | agents | assignees | conference_bridge | escalation_policies | first_trigger_log_entries | priorities | services | teams | users | Array of additional details to include. |
since | string | The start of the date range over which you want to search. Maximum range is 6… |
until | string | The end of the date range over which you want to search. Maximum range is 6… |
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_incidents",
"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 incidents tool with limit set to ….