PagerDuty
OfficialPagerDuty's official MCP server which provides tools to interact with your PagerDuty account.
Tools (40)
list_alert_grouping_settings
List all alert grouping settings with optional filtering. Args: query_model: Optional filtering parameters Returns: List of alert grouping settings matching the query parameters
get_alert_grouping_setting
Get details for a specific alert grouping setting. Args: setting_id: The ID of the alert grouping setting to retrieve Returns: Alert grouping setting details
list_incidents
List incidents with optional filtering. Args: query_model: Optional filtering parameters Returns: List of Incident objects matching the query parameters Examples: Basic usage filtering by status: >>> from pagerduty_mcp.models import IncidentQuery >>> result = list_incidents(IncidentQuery(status=["triggered"])) >>> isinstance(result.response, list) True Multiple statuses with a limit: >>> result = list_incidents(IncidentQuery(status=["triggered", "acknowledged"], limit=10))
get_incident
Get a specific incident. Args: incident_id: The ID or number of the incident to retrieve. Returns: Incident details
get_outlier_incident
Get Outlier Incident information for a given Incident on its Service. Outlier Incident returns incident that deviates from the expected patterns for the same Service. This feature is currently available as part of the Event Intelligence package or Digital Operations plan only. Args: query_model: Query parameters including incident ID, date range, and additional details Returns: Outlier incident information calculated over the same Service as the given Incident
get_past_incidents
Get Past Incidents related to a specific incident ID. Past Incidents returns Incidents within the past 6 months that have similar metadata and were generated on the same Service as the parent Incident. By default, 5 Past Incidents are returned. This feature is currently available as part of the Event Intelligence package or Digital Operations plan only. Args: query_model: Query parameters including incident ID, limit, and total flag Returns: List of past incidents with similarity scores
get_related_incidents
Get Related Incidents for a specific incident ID. Returns the 20 most recent Related Incidents that are impacting other Responders and Services. This feature is currently available as part of the Event Intelligence package or Digital Operations plan only. Args: query_model: Query parameters including incident ID and additional details Returns: List of related incidents and their relationships
list_services
List all services. Args: query_model: Optional filtering parameters Returns: List of services matching the query parameters
get_service
Get details for a specific service. Args: service_id: The ID of the service to retrieve Returns: The service details
list_teams
List teams based on the provided query model. Args: query_model: The model containing the query parameters Returns: List of teams.
get_team
Get a specific team. Args: team_id: The ID or name of the team to retrieve Returns: Team details
list_team_members
List members of a team. Args: team_id: The ID of the team Returns: List of UserReference objects
get_user_data
Get the current user's data. Returns: User: User name, role, id, and summary and teams
list_users
List users, optionally filtering by name (query) and team IDs. Args: query_model: Optional filtering parameters Returns: List of users matching the criteria.
list_schedules
List schedules with optional filtering. Returns: List of schedules matching the query parameters
get_schedule
Get a specific schedule by ID. Args: schedule_id: The ID of the schedule to retrieve Returns: Schedule details
list_schedule_users
List users in a schedule. Args: schedule_id: The ID of the schedule Returns: List of users in the schedule
list_oncalls
List on-call schedules with optional filtering. Returns: List of on-call schedules matching the query parameters
list_escalation_policies
List escalation policies with optional filtering. Returns: List of escalation policies matching the query parameters
get_escalation_policy
Get a specific escalation policy. Args: policy_id: The ID of the escalation policy to retrieve Returns: Escalation policy details
list_event_orchestrations
List event orchestrations with optional filtering. Args: query_model: Optional filtering parameters Returns: List of event orchestrations matching the query parameters
get_event_orchestration
Get details for a specific event orchestration. Args: orchestration_id: The ID of the event orchestration to retrieve Returns: The event orchestration details
get_event_orchestration_router
Get the router configuration for a specific event orchestration. Args: orchestration_id: The ID of the event orchestration to retrieve router for Returns: The event orchestration router configuration
create_alert_grouping_setting
Create a new alert grouping setting. Args: create_model: The alert grouping setting creation request Returns: The created alert grouping setting
update_alert_grouping_setting
Update an existing alert grouping setting. Args: setting_id: The ID of the alert grouping setting to update update_model: The alert grouping setting update request Returns: The updated alert grouping setting
delete_alert_grouping_setting
Delete an alert grouping setting. Args: setting_id: The ID of the alert grouping setting to delete Returns: None (successful deletion returns no content)
create_incident
Create an incident. Returns: The created incident
manage_incidents
Manage one or more incidents by changing its status, urgency, assignment, or escalation level. Use this tool when you want to bulk update incidents. Args: manage_request: The request model containing the incident IDs and the fields to update (status, urgency, assignment, escalation level) Returns: The updated incident
add_responders
Add responders to an incident. Args: incident_id: The ID of the incident to add responders to request: The responder request data containing user IDs and optional message ctx: The context containing the request information Returns: Details of the responder request
add_note_to_incident
Add a note to an incident. Args: incident_id: The ID of the incident to add a note to note: The note text to be added Returns: The updated incident with the new note
create_service
Create a new service. Args: service_data: The data for the new service. Do not include the ID in the data since it is auto-generated. Always include the summary field for all references if available. Returns: The created service
update_service
Update an existing service. Args: service_id: The ID of the service to update service_data: The updated service data Returns: The updated service
create_team
Create a team. Returns: The created team.
update_team
Update a team. Args: team_id: The ID of the team to update update_model: The model containing the updated team data Returns: The updated team
delete_team
Delete a team. Args: team_id: The ID of the team to delete
add_team_member
Add a user to a team. Args: team_id: The ID of the team to add the user to member_data: Object containing the user ID and role to add to the team Returns: The API response confirming the addition
remove_team_member
Remove a user from a team. Args: team_id: The ID of the team to remove the user from user_id: The ID of the user to remove
create_schedule_override
Create an override for a schedule. Args: schedule_id: The ID of the schedule to override override_request: Data for the schedule override Returns: The created schedule override
update_event_orchestration_router
Update the router configuration for a specific event orchestration. Args: orchestration_id: The ID of the event orchestration to update router for router_update: The updated router configuration Returns: The updated event orchestration router configuration
append_event_orchestration_router_rule
Append a new routing rule to the end of an event orchestration's router rules. This function first retrieves the current router configuration, appends the new rule to the existing rules array, and then updates the router configuration. Args: orchestration_id: The ID of the event orchestration to append rule to new_rule: The new rule configuration to append Returns: The updated event orchestration router configuration with the new rule appended