Home / Servers / PagerDuty API / list_notifications

List notifications

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

List notifications for a given time range, optionally filtered by type (sms_notification, email_notification, phone_notification, or push_notification). A Notification is created when an Incident is triggered or… [GET /notifications]

Name on the gateway: pagerduty_api__list_notifications · read-only.

Parameters

NameTypeDescription
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…
time_zonestringTime zone in which results will be rendered. This will default to the account…
since requiredstringThe start of the date range over which you want to search. The time element is…
until requiredstringThe end of the date range over which you want to search. This should be in the…
filtersms_notification | email_notification | phone_notification | push_notificationReturn notification of this type only.
include[]usersArray of additional details to include.

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_notifications",
  "arguments": {
    "since": "…",
    "until": "…"
  }
}

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 notifications tool with limit set to ….

More from PagerDuty API