PagerDuty's official MCP server gives you full incident lifecycle management without leaving your IDE. You get tools for creating and triaging incidents, managing on-call schedules and overrides, configuring escalation policies, and working with event orchestrations. What stands out are the embedded React apps: an incident command center with AI-powered similar incident detection, an on-call manager for schedule overrides, a compensation report tracking hours and compliance metrics, and a service dependency graph visualizer. Configure it with your User API Token and enable write-tools flag to go beyond read-only operations. Works with VS Code, Cursor, and Claude Desktop via stdio transport.
Public tool metadata for what this MCP can expose to an agent.
PAGERDUTY_ADD_SERVICE_TO_INCIDENT_WORKFLOW_TRIGGERThis endpoint adds a service to an existing incident workflow trigger in PagerDuty. It allows you to associate a specific service with a trigger, enabling automated incident management processes for that service. Use this endpoint when you need to connect a service to an incid...2 paramsThis endpoint adds a service to an existing incident workflow trigger in PagerDuty. It allows you to associate a specific service with a trigger, enabling automated incident management processes for that service. Use this endpoint when you need to connect a service to an incid...
idstringservice__idstringPAGERDUTY_AGGREGATE_ESCALATION_POLICY_INCIDENT_METRICSThis endpoint analyzes and aggregates incident metrics across all escalation policies in PagerDuty. It allows for detailed filtering and customization of the analysis, enabling users to gain insights into incident patterns, response times, and escalation effectiveness. The end...17 paramsThis endpoint analyzes and aggregates incident metrics across all escalation policies in PagerDuty. It allows for detailed filtering and customization of the analysis, enabling users to gain insights into incident patterns, response times, and escalation effectiveness. The end...
orderstringasc · descorder_bystringtime_zonestringaggregate_unitstringday · week · monthfilters__majorbooleanfilters__urgencystringhigh · lowfilters__team__idsarrayfilters__service__idsarrayfilters__priority__idsarrayfilters__priority__namesarrayfilters__created__at__endstringfilters__pd__advance__usedbooleanfilters__created__at__startstringfilters__min__ackowledgementsintegerfilters__escalation__policy__idsarrayfilters__min__manual__escalationsintegerfilters__min__timeout__escalationsintegerPAGERDUTY_AGGREGATE_INCIDENT_METRICS_WITH_FILTERSRetrieves and aggregates metrics for incidents across all services in PagerDuty. This endpoint allows for extensive filtering and customization of incident data, enabling detailed analysis of operational performance. It's particularly useful for generating reports, identifying...17 paramsRetrieves and aggregates metrics for incidents across all services in PagerDuty. This endpoint allows for extensive filtering and customization of incident data, enabling detailed analysis of operational performance. It's particularly useful for generating reports, identifying...
orderstringasc · descorder_bystringtime_zonestringaggregate_unitstringday · week · monthfilters__majorbooleanfilters__urgencystringhigh · lowfilters__team__idsarrayfilters__service__idsarrayfilters__priority__idsarrayfilters__priority__namesarrayfilters__created__at__endstringfilters__pd__advance__usedbooleanfilters__created__at__startstringfilters__min__ackowledgementsintegerfilters__escalation__policy__idsarrayfilters__min__manual__escalationsintegerfilters__min__timeout__escalationsintegerPAGERDUTY_ASSOCIATE_SERVICE_DEPENDENCIESAssociates multiple service dependencies in PagerDuty, allowing you to define relationships between supporting and dependent services. This endpoint is used to establish a hierarchical structure of services, which is crucial for effective incident management and impact analysi...1 paramsAssociates multiple service dependencies in PagerDuty, allowing you to define relationships between supporting and dependent services. This endpoint is used to establish a hierarchical structure of services, which is crucial for effective incident management and impact analysi...
relationshipsarrayPAGERDUTY_ASSOCIATE_TEAM_WITH_AUTOMATION_ACTIONThis endpoint associates a specific team with an automation action in PagerDuty. It allows you to link a team to an automated workflow, enabling better organization and management of automation actions within your incident response processes. Use this endpoint when you need to...1 paramsThis endpoint associates a specific team with an automation action in PagerDuty. It allows you to link a team to an automated workflow, enabling better organization and management of automation actions within your incident response processes. Use this endpoint when you need to...
idstringPAGERDUTY_AUDIT_ESCALATION_POLICY_RECORDSRetrieves the audit records for a specific escalation policy in PagerDuty. This endpoint allows users to access a detailed history of changes made to the escalation policy, including modifications to escalation rules, associated services, and on-call schedules. It's particular...5 paramsRetrieves the audit records for a specific escalation policy in PagerDuty. This endpoint allows users to access a detailed history of changes made to the escalation policy, including modifications to escalation rules, associated services, and on-call schedules. It's particular...
idstringlimitintegersincestringuntilstringcursorstringPAGERDUTY_CONVERT_SERVICE_RULE_BY_IDConverts the rules associated with a specific PagerDuty service to a new or optimized format. This endpoint is used to update and standardize the incident management rules for a given service, improving the efficiency and consistency of alert handling. It should be used when t...1 paramsConverts the rules associated with a specific PagerDuty service to a new or optimized format. This endpoint is used to update and standardize the incident management rules for a given service, improving the efficiency and consistency of alert handling. It should be used when t...
idstringPAGERDUTY_COUNT_PAUSED_INCIDENT_REPORTSRetrieves the count of paused incident reports in the PagerDuty system. This endpoint is part of PagerDuty's Incident Management and Analytics features, providing a quick way to quantify the number of incidents that are currently in a paused state. It's particularly useful for...4 paramsRetrieves the count of paused incident reports in the PagerDuty system. This endpoint is part of PagerDuty's Incident Management and Analytics features, providing a quick way to quantify the number of incidents that are currently in a paused state. It's particularly useful for...
sincestringuntilstringservice_idstringsuspended_byvaluePAGERDUTY_CREATE_A_CUSTOM_FIELD_FOR_AN_INCIDENT_TYPECreate a Custom Field for an Incident Type. Custom Fields (CF) are a feature which will allow customers to extend Incidents with their own custom data, to provide additional context and support features such as customized filtering, search and analytics. Custom Fields can be a...9 paramsCreate a Custom Field for an Incident Type. Custom Fields (CF) are a feature which will allow customers to extend Incidents with their own custom data, to provide additional context and support features such as customized filtering, search and analytics. Custom Fields can be a...
field__namestringfield__enabledbooleantype_id_or_namestringfield__data__typestringfield__descriptionstringfield__field__typestringsingle_value · single_value_fixed · multi_value · multi_value_fixedfield__display__namestringfield__default__valuestringfield__field__optionsarrayPAGERDUTY_CREATE_A_FIELD_OPTION_FOR_A_CUSTOM_FIELDCreate a field option for a custom field. Custom Fields (CF) are a feature which will allow customers to extend Incidents with their own custom data, to provide additional context and support features such as customized filtering, search and analytics. Custom Fields can be app...4 paramsCreate a field option for a custom field. Custom Fields (CF) are a feature which will allow customers to extend Incidents with their own custom data, to provide additional context and support features such as customized filtering, search and analytics. Custom Fields can be app...
field_idstringtype_id_or_namestringfield__option__data__valuestringfield__option__data__data__typestringPAGERDUTY_CREATE_AND_MANAGE_CUSTOM_INCIDENT_FIELDSCreates a new custom field for incidents in PagerDuty. This endpoint allows you to define additional data points to be associated with incidents, enhancing incident management and reporting capabilities. Custom fields can be used to store various types of information such as e...Creates a new custom field for incidents in PagerDuty. This endpoint allows you to define additional data points to be associated with incidents, enhancing incident management and reporting capabilities. Custom fields can be used to store various types of information such as e...
No parameter schema in public metadata yet.
PAGERDUTY_CREATE_AN_INCIDENT_TYPECreate a new incident type. Incident Types are a feature which will allow customers to categorize incidents, such as a security incident, a major incident, or a fraud incident. <!-- theme: warning --> > ### Early Access > This endpoint is in Early Access and may change at any...5 paramsCreate a new incident type. Incident Types are a feature which will allow customers to categorize incidents, such as a security incident, a major incident, or a fraud incident. <!-- theme: warning --> > ### Early Access > This endpoint is in Early Access and may change at any...
incident__type__namestringincident__type__enabledbooleanincident__type__descriptionstringincident__type__parent__typestringincident__type__display__namestringPAGERDUTY_CREATE_A_RULESETCreates a new Ruleset in PagerDuty for managing incident routing and notification rules. This endpoint allows you to define a named set of rules that determine how incidents are processed and directed to specific teams or users. It's particularly useful when setting up or modi...Creates a new Ruleset in PagerDuty for managing incident routing and notification rules. This endpoint allows you to define a named set of rules that determine how incidents are processed and directed to specific teams or users. It's particularly useful when setting up or modi...
No parameter schema in public metadata yet.
PAGERDUTY_CREATE_A_TRIGGERCreate new Incident Workflow Trigger Scoped OAuth requires: `incident_workflows.write`Create new Incident Workflow Trigger Scoped OAuth requires: `incident_workflows.write`
No parameter schema in public metadata yet.
PAGERDUTY_CREATE_AUTOMATION_RUNNER_ENDPOINTCreates a new automation runner in the PagerDuty incident management system. This endpoint allows you to set up either a sidecar runner, which polls for invocations externally, or a runbook runner, which communicates directly with a runbook instance. Use this when you need to...1 paramsCreates a new automation runner in the PagerDuty incident management system. This endpoint allows you to set up either a sidecar runner, which polls for invocations externally, or a runbook runner, which communicates directly with a runbook instance. Use this when you need to...
runnerobjectPAGERDUTY_CREATE_BUSINESS_SERVICEThis endpoint creates a new Business Service in PagerDuty, which represents a specific service or application that can be monitored and managed within the incident management platform. It allows you to define essential properties of the service, including its name, description...4 paramsThis endpoint creates a new Business Service in PagerDuty, which represents a specific service or application that can be monitored and managed within the incident management platform. It allows you to define essential properties of the service, including its name, description...
business__service__namestringbusiness__service__team__idstringbusiness__service__descriptionstringbusiness__service__point__of__contactstringPAGERDUTY_CREATE_ESCALATION_POLICYCreates a new escalation policy in PagerDuty, defining how incidents are escalated to different responders or teams. This endpoint allows you to set up a structured response plan for managing incidents, including escalation rules, targets, and associated services or teams. Use...Creates a new escalation policy in PagerDuty, defining how incidents are escalated to different responders or teams. This endpoint allows you to set up a structured response plan for managing incidents, including escalation rules, targets, and associated services or teams. Use...
No parameter schema in public metadata yet.
PAGERDUTY_CREATE_EVENT_ORCHESTRATIONCreates a new Event Orchestration in PagerDuty, which defines how incoming events are processed and routed to appropriate services. This endpoint allows you to set up a configuration that manages the flow of events from various integrations, ensuring efficient incident handlin...18 paramsCreates a new Event Orchestration in PagerDuty, which defines how incoming events are processed and routed to appropriate services. This endpoint allows you to set up a configuration that manages the flow of events from various integrations, ensuring efficient incident handlin...
orchestration__idstringorchestration__namestringorchestration__selfstringorchestration__routesintegerorchestration__versionstringorchestration__team__idstringorchestration__team__selfstringorchestration__team__typestringorchestration__created__atstringorchestration__descriptionstringorchestration__updated__atstringorchestration__integrationsarrayorchestration__created__by__idstringorchestration__updated__by__idstringorchestration__created__by__selfstringorchestration__created__by__typestringorchestration__updated__by__selfstringorchestration__updated__by__typestringPAGERDUTY_CREATE_EVENT_RULE_IN_RULESETCreates a new Event Rule within a specified Ruleset in PagerDuty's incident management system. This endpoint allows you to define complex conditions for event matching and specify actions to be taken when an event meets those conditions. Use this to automate incident response,...1 paramsCreates a new Event Rule within a specified Ruleset in PagerDuty's incident management system. This endpoint allows you to define complex conditions for event matching and specify actions to be taken when an event meets those conditions. Use this to automate incident response,...
idstringPAGERDUTY_CREATE_EXTENSION_OBJECTCreates a new extension in PagerDuty, allowing for additional functionality or integrations to be added to your services. This endpoint is used to set up webhooks, custom integrations, or other specific features that enhance the capabilities of your PagerDuty account. The exte...Creates a new extension in PagerDuty, allowing for additional functionality or integrations to be added to your services. This endpoint is used to set up webhooks, custom integrations, or other specific features that enhance the capabilities of your PagerDuty account. The exte...
No parameter schema in public metadata yet.
PAGERDUTY_CREATE_HANDOFF_NOTIFICATION_RULECreates a new on-call handoff notification rule for a specific user in PagerDuty. This endpoint allows you to set up automated notifications for when a user is about to start or end their on-call shift. It defines how and when the user should be notified about upcoming handoff...4 paramsCreates a new on-call handoff notification rule for a specific user in PagerDuty. This endpoint allows you to set up automated notifications for when a user is about to start or end their on-call shift. It defines how and when the user should be notified about upcoming handoff...
idstringoncall__handoff__notification__rule__idstringoncall__handoff__notification__rule__handoff__typestringboth · oncall · offcalldefault: bothoncall__handoff__notification__rule__notify__advance__in__minutesintegerPAGERDUTY_CREATE_INCIDENT_FIELD_OPTIONCreates a new field option for a specific custom field in PagerDuty's incident management system. This endpoint allows you to add predefined options to custom fields, enhancing the ability to categorize and filter incidents with consistent, structured data. Use this when you n...1 paramsCreates a new field option for a specific custom field in PagerDuty's incident management system. This endpoint allows you to add predefined options to custom fields, enhancing the ability to categorize and filter incidents with consistent, structured data. Use this when you n...
field_idstringPAGERDUTY_CREATE_INCIDENT_RECORDCreates a new incident in PagerDuty with specified details and assignments. Use this endpoint when an event requires immediate attention from on-call teams. It supports comprehensive incident documentation, including priority, urgency, and conference bridge information. The 'i...17 paramsCreates a new incident in PagerDuty with specified details and assignments. Use this endpoint when an event requires immediate attention from on-call teams. It supports comprehensive incident documentation, including priority, urgency, and conference bridge information. The 'i...
incident__typestringincident__titlestringincident__urgencystringincident__body__typestringincident__assignmentsarrayincident__service__idstringincident__priority__idstringincident__body__detailsstringincident__incident__keystringincident__service__typestringservice_referencedefault: service_referenceincident__priority__typestringincident__incident__type__idstringincident__incident__type__namestringmajor_incident · security_incident · engineering_incident · customer_incidentdefault: engineering_incidentincident__incident__type__typestringincident__conference__bridge__conference__urlstringincident__conference__bridge__conference__typestringzoom · meet · teams · webex · otherincident__conference__bridge__conference__numberstringPAGERDUTY_CREATE_INCIDENT_WORKFLOWThis endpoint creates a new Incident Workflow in PagerDuty, allowing users to define a series of automated steps to be executed during incident response. It enables the setup of complex, multi-step processes that can include actions like sending notifications, updating statuse...This endpoint creates a new Incident Workflow in PagerDuty, allowing users to define a series of automated steps to be executed during incident response. It enables the setup of complex, multi-step processes that can include actions like sending notifications, updating statuse...
No parameter schema in public metadata yet.
PAGERDUTY_CREATE_INCIDENT_WORKFLOW_INSTANCECreates a new instance of an incident workflow for a specific incident in PagerDuty. This endpoint allows you to initiate a predefined workflow process for managing and resolving an ongoing incident. It links the workflow instance to a particular incident, enabling automated a...2 paramsCreates a new instance of an incident workflow for a specific incident in PagerDuty. This endpoint allows you to initiate a predefined workflow process for managing and resolving an ongoing incident. It links the workflow instance to a particular incident, enabling automated a...
idstringincident__workflow__instance__incident__typestringincident_referencePAGERDUTY_CREATE_INTEGRATION_FOR_ORCHESTRATIONCreates a new integration within an existing event orchestration in PagerDuty. This endpoint allows users to set up connections between PagerDuty and external systems or services, enabling automated event management and incident response. It should be used when adding a new in...2 paramsCreates a new integration within an existing event orchestration in PagerDuty. This endpoint allows users to set up connections between PagerDuty and external systems or services, enabling automated event management and incident response. It should be used when adding a new in...
idstringintegration__labelstringPAGERDUTY_CREATE_INTEGRATION_FOR_SERVICEThis endpoint creates a new integration for a specific PagerDuty service. It allows you to set up various types of integrations, including email-based and Events API v2 integrations. The primary use case is to establish new channels for incident creation and management within...1 paramsThis endpoint creates a new integration for a specific PagerDuty service. It allows you to set up various types of integrations, including email-based and Events API v2 integrations. The primary use case is to establish new channels for incident creation and management within...
idstringPAGERDUTY_CREATE_MAINTENANCE_WINDOW_OBJECTCreates a new maintenance window in PagerDuty, allowing you to schedule periods of planned maintenance for specific services. During a maintenance window, incidents are not created for the affected services, preventing unnecessary alerts and notifications. This endpoint is use...Creates a new maintenance window in PagerDuty, allowing you to schedule periods of planned maintenance for specific services. During a maintenance window, incidents are not created for the affected services, preventing unnecessary alerts and notifications. This endpoint is use...
No parameter schema in public metadata yet.
PAGERDUTY_CREATE_NEW_SCHEDULE_LAYERCreates a new on-call schedule in PagerDuty, defining rotation patterns for team members. This endpoint allows you to set up complex schedules with multiple layers, each having its own rotation pattern, user assignments, and time restrictions. Use it to establish new on-call r...1 paramsCreates a new on-call schedule in PagerDuty, defining rotation patterns for team members. This endpoint allows you to set up complex schedules with multiple layers, each having its own rotation pattern, user assignments, and time restrictions. Use it to establish new on-call r...
overflowbooleanPAGERDUTY_CREATE_NEW_SERVICECreates a new service in PagerDuty, which is a key component for managing incidents and alerts. This endpoint allows you to set up a service with various configurations including escalation policies, incident urgency rules, support hours, and alert grouping parameters. Use thi...Creates a new service in PagerDuty, which is a key component for managing incidents and alerts. This endpoint allows you to set up a service with various configurations including escalation policies, incident urgency rules, support hours, and alert grouping parameters. Use thi...
No parameter schema in public metadata yet.
PAGERDUTY_CREATE_NEW_TAG_IN_SYSTEMCreates a new tag in PagerDuty for labeling and categorizing entities. This endpoint allows users to add a custom label to their PagerDuty account, which can be used to organize and filter various resources such as incidents, services, or teams. The created tag can be subseque...Creates a new tag in PagerDuty for labeling and categorizing entities. This endpoint allows users to add a custom label to their PagerDuty account, which can be used to organize and filter various resources such as incidents, services, or teams. The created tag can be subseque...
No parameter schema in public metadata yet.
PAGERDUTY_CREATE_NEW_TEAM_WITH_DETAILSCreates a new team within your PagerDuty account. This endpoint allows you to establish a group of users with shared responsibilities, often used for organizing incident management and on-call schedules. Use this when setting up a new department, project team, or any other gro...Creates a new team within your PagerDuty account. This endpoint allows you to establish a group of users with shared responsibilities, often used for organizing incident management and on-call schedules. Use this when setting up a new department, project team, or any other gro...
No parameter schema in public metadata yet.
PAGERDUTY_CREATE_NEW_WEBHOOK_SUBSCRIPTIONCreates a new webhook subscription in PagerDuty to receive specific event notifications. This endpoint allows users to set up automated notifications for various incident-related events, such as triggers, acknowledgments, and resolutions. The webhook can be configured to filte...13 paramsCreates a new webhook subscription in PagerDuty to receive specific event notifications. This endpoint allows users to set up automated notifications for various incident-related events, such as triggers, acknowledgments, and resolutions. The webhook can be configured to filte...
webhook__subscription__idstringwebhook__subscription__typestringwebhook_subscriptiondefault: webhook_subscriptionwebhook__subscription__activebooleanwebhook__subscription__eventsarraywebhook__subscription__filter__idstringwebhook__subscription__descriptionstringwebhook__subscription__filter__typestringaccount_reference · service_reference · team_referencewebhook__subscription__delivery__method__idstringwebhook__subscription__delivery__method__urlstringwebhook__subscription__delivery__method__typestringhttp_delivery_methoddefault: http_delivery_methodwebhook__subscription__delivery__method__secretstringwebhook__subscription__delivery__method__custom__headersarraywebhook__subscription__delivery__method__temporarily__disabledbooleanPAGERDUTY_CREATE_OR_UPDATE_STATUS_PAGE_POSTCreates a new post on a specified PagerDuty Status Page. This endpoint allows you to publish information about incidents or scheduled maintenance, including details such as the post type, timing, and associated updates. Use this to communicate service status, planned downtime,...9 paramsCreates a new post on a specified PagerDuty Status Page. This endpoint allows you to publish information about incidents or scheduled maintenance, including details such as the post type, timing, and associated updates. Use this to communicate service status, planned downtime,...
idstringpost__typestringstatus_page_postpost__titlestringpost__updatesarraypost__ends__atstringpost__post__typestringincident · maintenancepost__starts__atstringpost__status__page__idstringpost__status__page__typestringPAGERDUTY_CREATE_OR_UPDATE_STATUS_PAGE_POSTMORTEMCreates or updates a postmortem for a specific status page post in PagerDuty. This endpoint allows you to add detailed analysis and insights about an incident after its resolution. The postmortem can include rich-text content and offers the option to notify subscribers. Use th...7 paramsCreates or updates a postmortem for a specific status page post in PagerDuty. This endpoint allows you to add detailed analysis and insights about an incident after its resolution. The postmortem can include rich-text content and offers the option to notify subscribers. Use th...
idstringpost_idstringpostmortem__typestringstatus_page_post_postmortemdefault: status_page_post_postmortempostmortem__messagestringpostmortem__post__idstringpostmortem__post__typestringpostmortem__notify__subscribersbooleanPAGERDUTY_CREATE_RESPONSE_PLAY_FOR_INCIDENTSCreates a new Response Play in PagerDuty, which is a predefined set of actions to be executed in response to an incident. This endpoint allows you to configure automated responses, including adding subscribers, assigning responders, setting up conference details, and defining...Creates a new Response Play in PagerDuty, which is a predefined set of actions to be executed in response to an incident. This endpoint allows you to configure automated responses, including adding subscribers, assigning responders, setting up conference details, and defining...
No parameter schema in public metadata yet.
PAGERDUTY_CREATE_SCHEDULE_OVERRIDES_CONFIGURATIONCreates one or more overrides for a specific schedule in PagerDuty. This endpoint allows you to temporarily modify the on-call schedule by assigning different users for specific time periods. It's useful for handling planned absences, shift swaps, or special coverage requireme...2 paramsCreates one or more overrides for a specific schedule in PagerDuty. This endpoint allows you to temporarily modify the on-call schedule by assigning different users for specific time periods. It's useful for handling planned absences, shift swaps, or special coverage requireme...
idstringoverridesarrayPAGERDUTY_CREATE_SERVICE_EVENT_RULECreates a new event rule for a specific service in PagerDuty. This endpoint allows you to define complex conditions and actions for handling incoming events, enabling automated incident management and alert routing. Use this when you need to set up custom logic for processing...1 paramsCreates a new event rule for a specific service in PagerDuty. This endpoint allows you to define complex conditions and actions for handling incoming events, enabling automated incident management and alert routing. Use this when you need to set up custom logic for processing...
idstringPAGERDUTY_CREATE_STATUS_PAGE_SUBSCRIPTIONCreates a new subscription for a PagerDuty status page. This endpoint allows users to set up notifications for specific status pages or components within those pages. It's used to keep subscribers informed about updates, incidents, or changes to the monitored services. The sub...8 paramsCreates a new subscription for a PagerDuty status page. This endpoint allows users to set up notifications for specific status pages or components within those pages. It's used to keep subscribers informed about updates, incidents, or changes to the monitored services. The sub...
idstringsubscription__typestringsubscription__channelstringwebhook · emailsubscription__contactstringsubscription__status__page__idstringsubscription__status__page__typestringsubscription__subscribable__object__idstringsubscription__subscribable__object__typestringstatus_page · status_page_service · status_page_postPAGERDUTY_CREATE_STATUS_UPDATE_TEMPLATECreates a new template in PagerDuty for standardized status updates. This endpoint allows users to define customizable templates for various notification types, including emails and short messages. It's primarily used to streamline communication during incident management by p...6 paramsCreates a new template in PagerDuty for standardized status updates. This endpoint allows users to define customizable templates for various notification types, including emails and short messages. It's primarily used to streamline communication during incident management by p...
template__namestringtemplate__descriptionstringtemplate__template__typestringstatus_updatetemplate__templated__fields__messagestringtemplate__templated__fields__email__bodystringtemplate__templated__fields__email__subjectstringPAGERDUTY_CREATE_USER_NOTIFICATION_RULECreates a new notification rule for a specific user in PagerDuty. This endpoint allows you to define how and when a user should be notified about assigned incidents. You can specify the delay before notification, the method of contact, and the urgency level of incidents that t...1 paramsCreates a new notification rule for a specific user in PagerDuty. This endpoint allows you to define how and when a user should be notified about assigned incidents. You can specify the delay before notification, the method of contact, and the urgency level of incidents that t...
idstringPAGERDUTY_CREATE_USER_OBJECTCreates a new user in the PagerDuty system with the specified attributes. This endpoint should be used when onboarding new team members or adding users to your PagerDuty account. It allows you to set up essential user information, including name, email, role, and time zone pre...Creates a new user in the PagerDuty system with the specified attributes. This endpoint should be used when onboarding new team members or adding users to your PagerDuty account. It allows you to set up essential user information, including name, email, role, and time zone pre...
No parameter schema in public metadata yet.
PAGERDUTY_CREATE_USER_STATUS_UPDATE_NOTIFICATION_RULECreates a new status update notification rule for a specific user in PagerDuty. This endpoint allows you to define how a user will be notified about incident status updates. It's used to customize notification preferences for individual users, ensuring they receive timely upda...1 paramsCreates a new status update notification rule for a specific user in PagerDuty. This endpoint allows you to define how a user will be notified about incident status updates. It's used to customize notification preferences for individual users, ensuring they receive timely upda...
idstringPAGERDUTY_CREATE_WORKFLOW_INTEGRATION_CONNECTIONCreate a new Workflow Integration Connection. Scoped OAuth requires: `workflow_integrations:connections.write`13 paramsCreate a new Workflow Integration Connection. Scoped OAuth requires: `workflow_integrations:connections.write`
idstringnamestringtypestringteamsarrayscopesarrayis_defaultbooleanexternal_idstringservice_urlstringintegration_idstringexternal_id_labelstringhealth__is__healthybooleanhealth__health__messagestringhealth__last__checked__atstringPAGERDUTY_DELETE_ACCOUNT_SUBSCRIPTION_BY_IDDeletes the account subscription associated with a specific business service in PagerDuty. This endpoint is used to terminate the subscription or billing relationship between a business service and the account. It should be used when you need to discontinue the subscription fo...1 paramsDeletes the account subscription associated with a specific business service in PagerDuty. This endpoint is used to terminate the subscription or billing relationship between a business service and the account. It should be used when you need to discontinue the subscription fo...
idstringPAGERDUTY_DELETE_A_CUSTOM_FIELD_FOR_AN_INCIDENT_TYPEDelete a custom field for an incident type. Custom Fields (CF) are a feature which will allow customers to extend Incidents with their own custom data, to provide additional context and support features such as customized filtering, search and analytics. Custom Fields can be a...2 paramsDelete a custom field for an incident type. Custom Fields (CF) are a feature which will allow customers to extend Incidents with their own custom data, to provide additional context and support features such as customized filtering, search and analytics. Custom Fields can be a...
field_idstringtype_id_or_namestringPAGERDUTY_DELETE_ADDON_BY_IDDeletes a specific add-on from the PagerDuty account using its unique identifier. This endpoint should be used when you want to remove an integration or extension that is no longer needed or active in your PagerDuty setup. It's important to note that this action is irreversibl...1 paramsDeletes a specific add-on from the PagerDuty account using its unique identifier. This endpoint should be used when you want to remove an integration or extension that is no longer needed or active in your PagerDuty setup. It's important to note that this action is irreversibl...
idstringPAGERDUTY_DELETE_A_FIELD_OPTION_FOR_A_CUSTOM_FIELDDelete a field option for a custom field. <!-- theme: warning --> > ### Early Access > This endpoint is in Early Access and may change at any time. You must pass in the X-EARLY-ACCESS header to access it. Scoped OAuth requires: `custom_fields.write`3 paramsDelete a field option for a custom field. <!-- theme: warning --> > ### Early Access > This endpoint is in Early Access and may change at any time. You must pass in the X-EARLY-ACCESS header to access it. Scoped OAuth requires: `custom_fields.write`
field_idstringfield_option_idstringtype_id_or_namestringPAGERDUTY_DELETE_ALERT_GROUPING_SETTINGThis endpoint allows you to delete specific alert grouping settings in PagerDuty. It is used to remove outdated or unnecessary configurations that determine how alerts are grouped into incidents. The deletion is permanent and cannot be undone, so it should be used with caution...1 paramsThis endpoint allows you to delete specific alert grouping settings in PagerDuty. It is used to remove outdated or unnecessary configurations that determine how alerts are grouped into incidents. The deletion is permanent and cannot be undone, so it should be used with caution...
idstringPAGERDUTY_DELETE_ALL_OAUTH_DELEGATIONSDelete all OAuth delegations as per provided query parameters. An OAuth delegation represents an instance of a user or account's authorization to an app (via OAuth) to access their PagerDuty account. Common apps include the PagerDuty mobile app, Slack, Microsoft Teams, and thi...2 paramsDelete all OAuth delegations as per provided query parameters. An OAuth delegation represents an instance of a user or account's authorization to an app (via OAuth) to access their PagerDuty account. Common apps include the PagerDuty mobile app, Slack, Microsoft Teams, and thi...
typestringmobileuser_idstringPAGERDUTY_DELETE_AUTOMATION_ACTION_BY_IDDeletes a specific Automation Action from the PagerDuty system. This endpoint is used to permanently remove an Automation Action, which includes any associated scripts or jobs in Runbook Automation. It should be used when an Automation Action is no longer needed or has become...1 paramsDeletes a specific Automation Action from the PagerDuty system. This endpoint is used to permanently remove an Automation Action, which includes any associated scripts or jobs in Runbook Automation. It should be used when an Automation Action is no longer needed or has become...
idstringPAGERDUTY_DELETE_AUTOMATION_ACTION_SERVICE_BY_IDThis endpoint removes a specific automation action from a particular service in PagerDuty. It is used to disassociate an automated workflow or action from a service, effectively stopping that action from being triggered for incidents related to the specified service. This oper...2 paramsThis endpoint removes a specific automation action from a particular service in PagerDuty. It is used to disassociate an automated workflow or action from a service, effectively stopping that action from being triggered for incidents related to the specified service. This oper...
idstringservice_idstringPAGERDUTY_DELETE_AUTOMATION_ACTIONS_RUNNER_BY_IDDeletes a specific automation runner from the PagerDuty system. This endpoint is used to permanently remove an automation runner, which is responsible for executing automated tasks and workflows. It should be used when an automation runner is no longer needed or needs to be re...1 paramsDeletes a specific automation runner from the PagerDuty system. This endpoint is used to permanently remove an automation runner, which is responsible for executing automated tasks and workflows. It should be used when an automation runner is no longer needed or needs to be re...
idstringPAGERDUTY_DELETE_BUSINESS_SERVICE_BY_IDDeletes a specific business service from the PagerDuty system. This endpoint should be used when you want to permanently remove a business service that is no longer needed or relevant to your organization's incident management structure. It's important to note that this action...1 paramsDeletes a specific business service from the PagerDuty system. This endpoint should be used when you want to permanently remove a business service that is no longer needed or relevant to your organization's incident management structure. It's important to note that this action...
idstringPAGERDUTY_DELETE_BUSINESS_SERVICE_PRIORITY_THRESHOLDSDeletes all priority thresholds for business services in the PagerDuty account. This endpoint is used to remove the configured priority settings that determine how incidents are escalated based on their urgency for business services. It should be used when you want to reset or...Deletes all priority thresholds for business services in the PagerDuty account. This endpoint is used to remove the configured priority settings that determine how incidents are escalated based on their urgency for business services. It should be used when you want to reset or...
No parameter schema in public metadata yet.
PAGERDUTY_DELETE_CACHE_VARIABLE_FOR_EVENTDeletes a specific cache variable associated with an event orchestration in PagerDuty. This endpoint is used to remove temporary data storage that was previously set up for use in event orchestration workflows. It should be used when you need to clean up or remove outdated cac...2 paramsDeletes a specific cache variable associated with an event orchestration in PagerDuty. This endpoint is used to remove temporary data storage that was previously set up for use in event orchestration workflows. It should be used when you need to clean up or remove outdated cac...
idstringcache_variable_idstringPAGERDUTY_DELETE_CACHE_VARIABLE_FROM_SERVICEThis endpoint deletes a specific cache variable associated with a service in PagerDuty's event orchestration system. It is used to remove temporary data that is no longer needed, helping to maintain system efficiency. The endpoint should be used when you want to permanently re...2 paramsThis endpoint deletes a specific cache variable associated with a service in PagerDuty's event orchestration system. It is used to remove temporary data that is no longer needed, helping to maintain system efficiency. The endpoint should be used when you want to permanently re...
service_idstringcache_variable_idstringPAGERDUTY_DELETE_CUSTOM_FIELD_BY_FIELD_IDDeletes a specific custom field from incidents in PagerDuty. This endpoint allows users to remove a custom field that is no longer needed or relevant for incident management. It should be used when you want to permanently delete a custom field from all incidents, both existing...1 paramsDeletes a specific custom field from incidents in PagerDuty. This endpoint allows users to remove a custom field that is no longer needed or relevant for incident management. It should be used when you want to permanently delete a custom field from all incidents, both existing...
field_idstringPAGERDUTY_DELETE_ESCALATION_POLICY_BY_IDPermanently removes a specific escalation policy from the PagerDuty system. This endpoint should be used when an escalation policy is no longer needed or has become obsolete. Once deleted, the escalation policy cannot be recovered, and any services or incidents associated with...1 paramsPermanently removes a specific escalation policy from the PagerDuty system. This endpoint should be used when an escalation policy is no longer needed or has become obsolete. Once deleted, the escalation policy cannot be recovered, and any services or incidents associated with...
idstringPAGERDUTY_DELETE_EVENT_BY_IDDeletes a specific Event Orchestration from the PagerDuty system. This endpoint should be used when you want to permanently remove an Event Orchestration configuration, including all its associated rules and routing logic. It's important to note that this action is irreversibl...1 paramsDeletes a specific Event Orchestration from the PagerDuty system. This endpoint should be used when you want to permanently remove an Event Orchestration configuration, including all its associated rules and routing logic. It's important to note that this action is irreversibl...
idstringPAGERDUTY_DELETE_EXTENSION_BY_IDDeletes a specific extension from the PagerDuty service. This endpoint should be used when you want to remove an additional feature or integration that has been previously added to your PagerDuty account. It's particularly useful for cleaning up obsolete integrations or disabl...1 paramsDeletes a specific extension from the PagerDuty service. This endpoint should be used when you want to remove an additional feature or integration that has been previously added to your PagerDuty account. It's particularly useful for cleaning up obsolete integrations or disabl...
idstringPAGERDUTY_DELETE_FIELD_OPTIONThis endpoint deletes a specific field option from a custom field in PagerDuty's incident management system. It allows you to remove predefined options that are no longer needed or relevant for incident categorization or data collection. Use this endpoint when you want to upda...2 paramsThis endpoint deletes a specific field option from a custom field in PagerDuty's incident management system. It allows you to remove predefined options that are no longer needed or relevant for incident categorization or data collection. Use this endpoint when you want to upda...
field_idstringfield_option_idstringPAGERDUTY_DELETE_INCIDENT_WORKFLOW_BY_IDDeletes a specific incident workflow from the PagerDuty system. This endpoint should be used when you want to permanently remove a customized sequence of automated actions and triggers associated with incident management. It's important to note that this action is irreversible...1 paramsDeletes a specific incident workflow from the PagerDuty system. This endpoint should be used when you want to permanently remove a customized sequence of automated actions and triggers associated with incident management. It's important to note that this action is irreversible...
idstringPAGERDUTY_DELETE_INCIDENT_WORKFLOW_TRIGGER_BY_IDDeletes a specific trigger associated with an incident workflow in PagerDuty. This endpoint is used to remove an automated trigger that initiates a predefined workflow in response to incidents. It should be used when you need to modify your incident response automation by remo...1 paramsDeletes a specific trigger associated with an incident workflow in PagerDuty. This endpoint is used to remove an automated trigger that initiates a predefined workflow in response to incidents. It should be used when you need to modify your incident response automation by remo...
idstringPAGERDUTY_DELETE_INCIDENT_WORKFLOW_TRIGGER_SERVICEThis endpoint removes a specific service from a trigger within an incident workflow in PagerDuty. It is used to modify the configuration of an existing incident workflow by disassociating a service from a particular trigger. This action is useful when you need to update the au...2 paramsThis endpoint removes a specific service from a trigger within an incident workflow in PagerDuty. It is used to modify the configuration of an existing incident workflow by disassociating a service from a particular trigger. This action is useful when you need to update the au...
service_idstringtrigger_idstringPAGERDUTY_DELETE_INTEGRATION_FROM_EVENT_ORCHESTRATIONRemoves a specific integration from an event orchestration in PagerDuty. This endpoint is used to disconnect a particular tool or service from the event orchestration setup, effectively stopping it from triggering or modifying incidents within that orchestration. It's particul...2 paramsRemoves a specific integration from an event orchestration in PagerDuty. This endpoint is used to disconnect a particular tool or service from the event orchestration setup, effectively stopping it from triggering or modifying incidents within that orchestration. It's particul...
idstringintegration_idstringPAGERDUTY_DELETE_MAINTENANCE_WINDOW_BY_IDDeletes a specific maintenance window in PagerDuty's incident management system. This endpoint is used to permanently remove a scheduled maintenance window, effectively re-enabling any services and integrations that were temporarily disabled during the maintenance period. It s...1 paramsDeletes a specific maintenance window in PagerDuty's incident management system. This endpoint is used to permanently remove a scheduled maintenance window, effectively re-enabling any services and integrations that were temporarily disabled during the maintenance period. It s...
idstringPAGERDUTY_DELETE_ONCALL_HANDOFF_NOTIFICATION_RULEThis endpoint deletes a specific on-call handoff notification rule for a given user in PagerDuty. It is used to remove custom notification settings for when on-call responsibilities are transferred between team members. This operation is permanent and cannot be undone, so it s...2 paramsThis endpoint deletes a specific on-call handoff notification rule for a given user in PagerDuty. It is used to remove custom notification settings for when on-call responsibilities are transferred between team members. This operation is permanent and cannot be undone, so it s...
idstringoncall_handoff_notification_rule_idstringPAGERDUTY_DELETE_POST_FROM_STATUS_PAGEThis endpoint deletes a specific post from a PagerDuty status page. It is used to remove outdated or irrelevant information from a status page, helping to maintain clear and accurate communication with users about service status. The operation is irreversible, so it should be...2 paramsThis endpoint deletes a specific post from a PagerDuty status page. It is used to remove outdated or irrelevant information from a status page, helping to maintain clear and accurate communication with users about service status. The operation is irreversible, so it should be...
idstringpost_idstringPAGERDUTY_DELETE_POST_UPDATE_BY_IDThis endpoint deletes a specific post update from a status page post in PagerDuty. It allows users to remove outdated or incorrect information from a status page, ensuring that only relevant and accurate updates are displayed. The endpoint should be used when an organization n...3 paramsThis endpoint deletes a specific post update from a status page post in PagerDuty. It allows users to remove outdated or incorrect information from a status page, ensuring that only relevant and accurate updates are displayed. The endpoint should be used when an organization n...
idstringpost_idstringpost_update_idstringPAGERDUTY_DELETE_RESPONSE_PLAYDeletes a specific Response Play from the PagerDuty system. This endpoint should be used when you need to remove an outdated or unnecessary Response Play from your incident management workflow. It permanently eliminates the predefined sequence of actions associated with the sp...1 paramsDeletes a specific Response Play from the PagerDuty system. This endpoint should be used when you need to remove an outdated or unnecessary Response Play from your incident management workflow. It permanently eliminates the predefined sequence of actions associated with the sp...
idstringPAGERDUTY_DELETE_RULE_FROM_RULESET_BY_IDDeletes a specific rule from a ruleset in PagerDuty's incident management platform. This endpoint allows users to remove individual event rules, providing flexibility in managing and updating rulesets. It should be used when you need to eliminate an outdated, unnecessary, or i...2 paramsDeletes a specific rule from a ruleset in PagerDuty's incident management platform. This endpoint allows users to remove individual event rules, providing flexibility in managing and updating rulesets. It should be used when you need to eliminate an outdated, unnecessary, or i...
idstringrule_idstringPAGERDUTY_DELETE_RULESET_BY_IDDeletes a specific ruleset from the PagerDuty system based on the provided ID. This endpoint should be used when you need to remove an existing ruleset, which may be necessary during incident management reconfiguration or when cleaning up obsolete rulesets. The deletion is per...1 paramsDeletes a specific ruleset from the PagerDuty system based on the provided ID. This endpoint should be used when you need to remove an existing ruleset, which may be necessary during incident management reconfiguration or when cleaning up obsolete rulesets. The deletion is per...
idstringPAGERDUTY_DELETE_RUNNER_TEAM_ASSOCIATIONThis endpoint removes a team's association from a specific Automation Action runner in PagerDuty. It is used to revoke a team's access to execute or manage tasks on a particular runner. The operation is permanent and should be used when you no longer want a team to have access...2 paramsThis endpoint removes a team's association from a specific Automation Action runner in PagerDuty. It is used to revoke a team's access to execute or manage tasks on a particular runner. The operation is permanent and should be used when you no longer want a team to have access...
idstringteam_idstringPAGERDUTY_DELETE_SCHEDULE_BY_IDThe DeleteSchedule endpoint removes a specific schedule from the PagerDuty system. It is used to delete outdated or unnecessary on-call schedules, helping to maintain an organized and efficient incident management workflow. This operation is permanent and cannot be undone, so...1 paramsThe DeleteSchedule endpoint removes a specific schedule from the PagerDuty system. It is used to delete outdated or unnecessary on-call schedules, helping to maintain an organized and efficient incident management workflow. This operation is permanent and cannot be undone, so...
idstringPAGERDUTY_DELETE_SCHEDULE_OVERRIDE_BY_IDThis endpoint deletes a specific override from a PagerDuty schedule. It allows users to remove temporary changes made to the regular schedule, reverting it back to its original state. This operation is useful for canceling previously set overrides that are no longer needed, su...2 paramsThis endpoint deletes a specific override from a PagerDuty schedule. It allows users to remove temporary changes made to the regular schedule, reverting it back to its original state. This operation is useful for canceling previously set overrides that are no longer needed, su...
idstringoverride_idstringPAGERDUTY_DELETE_SERVICE_BY_IDDeletes a specific service from the PagerDuty account. This endpoint should be used when you need to permanently remove a service that is no longer required or active. It's important to note that this operation is irreversible and will delete all associated incidents, alerts,...1 paramsDeletes a specific service from the PagerDuty account. This endpoint should be used when you need to permanently remove a service that is no longer required or active. It's important to note that this operation is irreversible and will delete all associated incidents, alerts,...
idstringPAGERDUTY_DELETE_SERVICE_RULE_BY_IDDeletes a specific rule from a PagerDuty service. This endpoint is used to permanently remove a rule that defines conditions for incident creation or automation within a particular service. It should be used when you need to eliminate an outdated, incorrect, or no longer neede...2 paramsDeletes a specific rule from a PagerDuty service. This endpoint is used to permanently remove a rule that defines conditions for incident creation or automation within a particular service. It should be used when you need to eliminate an outdated, incorrect, or no longer neede...
idstringrule_idstringPAGERDUTY_DELETE_STATUS_PAGE_POSTMORTEMThis endpoint allows you to delete a postmortem associated with a specific post on a PagerDuty status page. It is used to remove the detailed analysis and lessons learned from an incident after it has been resolved and documented. This action is permanent and should be used wi...2 paramsThis endpoint allows you to delete a postmortem associated with a specific post on a PagerDuty status page. It is used to remove the detailed analysis and lessons learned from an incident after it has been resolved and documented. This action is permanent and should be used wi...
idstringpost_idstringPAGERDUTY_DELETE_STATUS_UPDATE_NOTIFICATION_RULEDeletes a specific status update notification rule associated with a user in the PagerDuty system. This endpoint allows administrators or users with appropriate permissions to remove custom notification rules for status updates, helping to manage and streamline the user's noti...2 paramsDeletes a specific status update notification rule associated with a user in the PagerDuty system. This endpoint allows administrators or users with appropriate permissions to remove custom notification rules for status updates, helping to manage and streamline the user's noti...
idstringstatus_update_notification_rule_idstringPagerDuty's local MCP (Model Context Protocol) server which provides tools to interact with your PagerDuty account, allowing you to manage incidents, services, schedules, event orchestrations, and more directly from your MCP-enabled client.
Interactive React UIs for PagerDuty incident management, embedded directly in the Python MCP server for seamless IDE integration. Manage your full incident lifecycle without leaving your IDE.
Available Apps:
Full incident lifecycle management from your IDE:
Usage in VS Code: Ask Claude: Show me the incident command center
Schedule management with override CRUD and coverage wizards:
Usage in VS Code: Ask Claude: Show me the on-call manager
Per-user on-call metrics with compliance tracking:
Usage in VS Code: Ask Claude: Show me the oncall compensation report
Interactive graph of service relationships and dependencies:
Usage in VS Code: Ask Claude: Show me the service dependency graph
Step-by-step PagerDuty account setup:
Usage in VS Code: Ask Claude: Open the onboarding wizard
Architecture:
uv run pagerduty-mcpSee mcp-apps/README.md for development instructions and customization.
asdf-vm installed.
uv installed globally.
A PagerDuty User API Token. To obtain a PagerDuty User API Token, follow these steps:
For Freemium accounts, the permissions for generating User API tokens are limited to the user role as defined here.
Use of the PagerDuty User API Token is subject to the PagerDuty Developer Agreement.
You can configure this MCP server directly within Cursor's settings.json file, by following these steps:
Open Cursor settings (Cursor Settings > Tools > Add MCP, or Cmd+, on Mac, or Ctrl+, on Windows/Linux).
Add the following configuration:
{
"mcpServers": {
"pagerduty-mcp": {
"type": "stdio",
"command": "uvx",
"args": [
"pagerduty-mcp",
"--enable-write-tools"
// This flag enables write operations on the MCP Server enabling you to creating incidents, schedule overrides and much more
],
"env": {
"PAGERDUTY_USER_API_KEY": "${input:pagerduty-api-key}"
}
}
}
}
You can configure this MCP server directly within Visual Studio Code's settings.json file, allowing VS Code to manage the server lifecycle.
Open VS Code settings (File > Preferences > Settings, or Cmd+, on Mac, or Ctrl+, on Windows/Linux).
Search for "mcp" and ensure "Mcp: Enabled" is checked under Features > Chat.
Click "Edit in settings.json" under "Mcp > Discovery: Servers".
Add the following configuration:
{
"mcp": {
"inputs": [
{
"type": "promptString",
"id": "pagerduty-api-key",
"description": "PagerDuty API Key",
"password": true
}
],
"servers": {
"pagerduty-mcp": {
"type": "stdio",
"command": "uvx",
"args": [
"pagerduty-mcp",
"--enable-write-tools"
// This flag enables write operations on the MCP Server enabling you to creating incidents, schedule overrides and much more
],
"env": {
"PAGERDUTY_USER_API_KEY": "${input:pagerduty-api-key}",
"PAGERDUTY_API_HOST": "https://api.pagerduty.com"
// If your PagerDuty account is located in EU update your API host to https://api.eu.pagerduty.com
}
}
}
}
}
View > Chat).Agent mode is selected. In the Chat view, you can enable or disable specific tools by clicking the 🛠️ icon.Show me the latest incident or List my event orchestrations to interact with your PagerDuty account through the MCP server.Cmd+Shift+P/Ctrl+Shift+P) and searching for MCP: List Servers. Ensure the server is running before sending commands. You can also try to restart the server if you encounter any issues.You can configure this MCP server to work with Claude Desktop by adding it to Claude's configuration file.
Locate your Claude Desktop configuration file:
~/Library/Application Support/Claude/claude_desktop_config.json%APPDATA%\Claude\claude_desktop_config.jsonCreate or edit the configuration file and add the following configuration:
{
"mcpServers": {
"pagerduty-mcp": {
"command": "uvx",
"args": [
"pagerduty-mcp",
"--enable-write-tools"
],
"env": {
"PAGERDUTY_USER_API_KEY": "your-pagerduty-api-key-here",
"PAGERDUTY_API_HOST": "https://api.pagerduty.com"
}
}
}
}
Replace the placeholder values:
/path/to/your/mcp-server-directory with the full path to the directory where you cloned the MCP server (e.g., /Users/yourname/code/pagerduty-mcp)your-pagerduty-api-key-here with your actual PagerDuty User API Tokenhttps://api.eu.pagerduty.comRestart Claude Desktop completely for the changes to take effect.
Test the integration by starting a conversation with Claude and asking something like "Show me my latest PagerDuty incidents" or "List my event orchestrations" to verify the MCP server is working.
Security Note: Unlike VS Code's secure input prompts, Claude Desktop requires you to store your API key directly in the configuration file. Ensure this file has appropriate permissions (readable only by your user account) and consider the security implications of storing credentials in plain text.
The PagerDuty MCP server can be run in a Docker container, providing an isolated and portable deployment option. The Docker image uses stdio transport for MCP communication.
Build the Docker image:
docker build -t pagerduty-mcp:latest .
Run in read-only mode (default):
docker run -i --rm \
-e PAGERDUTY_USER_API_KEY="your-api-key-here" \
pagerduty-mcp:latest
Run with write tools enabled:
docker run -i --rm \
-e PAGERDUTY_USER_API_KEY="your-api-key-here" \
pagerduty-mcp:latest --enable-write-tools
For EU region:
docker run -i --rm \
-e PAGERDUTY_USER_API_KEY="your-api-key-here" \
-e PAGERDUTY_API_HOST="https://api.eu.pagerduty.com" \
pagerduty-mcp:latest
To integrate the Docker container with MCP clients, you can use Docker as the command:
Claude Desktop example:
{
"mcpServers": {
"pagerduty-mcp": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"PAGERDUTY_USER_API_KEY=your-api-key-here",
"pagerduty-mcp:latest"
]
}
}
}
Note: The Docker container uses stdio transport, making it compatible with MCP clients that expect standard input/output communication. Ensure you build the image first using
docker build -t pagerduty-mcp:latest .
Clone the repository
Install asdf plugins
asdf plugin add python
asdf plugin add nodejs https://github.com/asdf-vm/asdf-nodejs.git
asdf plugin add uv
Install tool versions using asdf:
asdf install
Create a virtual environment and install dependencies using uv (now that asdf has set the correct Python and uv versions):
uv sync
Ensure uv is available globally.
The MCP server can be run from different places so you need uv to be available globally. To do so, follow the official documentation.
Tip: You may need to restart your terminal and/or VS Code for the changes to take effect.
Run it locally
To run your cloned PagerDuty MCP Server you need to update your configuration to use uv instead of uvx.
"pagerduty-mcp": {
"type": "stdio",
"command": "uv",
"args": [
"run",
"--directory",
"/path/to/your/mcp-server-directory",
// Replace with the full path to the directory where you cloned the MCP server, e.g. "/Users/yourname/code/mcp-server",
"python",
"-m",
"pagerduty_mcp",
"--enable-write-tools"
// This flag enables write operations on the MCP Server enabling you to creating incidents, schedule overrides and much more
],
"env": {
"PAGERDUTY_USER_API_KEY": "${input:pagerduty-api-key}",
"PAGERDUTY_API_HOST": "https://api.pagerduty.com"
// If your PagerDuty account is located in EU update your API host to https://api.eu.pagerduty.com
}
}
The MCP server is configured via environment variables:
| Environment Variable | Required | Default | Description |
|---|---|---|---|
PAGERDUTY_USER_API_KEY | Yes | — | Your PagerDuty User API Token. |
PAGERDUTY_API_HOST | No | https://api.pagerduty.com | PagerDuty API base URL. Use https://api.eu.pagerduty.com for EU accounts. |
This section describes the tools provided by the PagerDuty MCP server. They are categorized based on whether they only read data or can modify data in your PagerDuty account.
Important: By default, the MCP server only exposes read-only tools. To enable tools that can modify your PagerDuty account (write-mode tools), you must explicitly start the server with the
--enable-write-toolsflag. This helps prevent accidental changes to your PagerDuty data.
| Tool | Area | Description | Read-only |
|---|---|---|---|
| create_alert_grouping_setting | Alert Grouping | Creates a new alert grouping setting | ❌ |
| delete_alert_grouping_setting | Alert Grouping | Deletes an alert grouping setting | ❌ |
| get_alert_grouping_setting | Alert Grouping | Retrieves a specific alert grouping setting | ✅ |
| list_alert_grouping_settings | Alert Grouping | Lists alert grouping settings with filtering | ✅ |
| update_alert_grouping_setting | Alert Grouping | Updates an existing alert grouping setting | ❌ |
| get_change_event | Change Events | Retrieves a specific change event | ✅ |
| list_change_events | Change Events | Lists change events with optional filtering | ✅ |
| list_incident_change_events | Change Events | Lists change events related to a specific incident | ✅ |
| list_service_change_events | Change Events | Lists change events for a specific service | ✅ |
| get_event_orchestration | Event Orchestrations | Retrieves a specific event orchestration | ✅ |
| get_event_orchestration_global | Event Orchestrations | Gets the global orchestration configuration for an event orchestration | ✅ |
| get_event_orchestration_router | Event Orchestrations | Gets the router configuration for an event orchestration | ✅ |
| get_event_orchestration_service | Event Orchestrations | Gets the service orchestration configuration for a specific service | ✅ |
| list_event_orchestrations | Event Orchestrations | Lists event orchestrations with optional filtering | ✅ |
| update_event_orchestration_router | Event Orchestrations | Updates the router configuration for an event orchestration | ❌ |
| append_event_orchestration_router_rule | Event Orchestrations | Adds a new routing rule to an event orchestration router | ❌ |
| list_escalation_policies | Escalation Policy | Lists escalation policies | ✅ |
| get_escalation_policy | Escalation Policy | Retrieves a specific escalation policy | ✅ |
| add_note_to_incident | Incidents | Adds note to an incident | ❌ |
| add_responders | Incidents | Adds responders to an incident | ❌ |
| create_incident | Incidents | Creates a new incident | ❌ |
| get_alert_from_incident | Incidents | Retrieves a specific alert from an incident | ✅ |
| get_incident | Incidents | Retrieves a specific incident | ✅ |
| get_outlier_incident | Incidents | Retrieves outlier incident information for a specific incident | ✅ |
| get_past_incidents | Incidents | Retrieves past incidents related to a specific incident | ✅ |
| get_related_incidents | Incidents | Retrieves related incidents for a specific incident | ✅ |
| list_alerts_from_incident | Incidents | Lists all alerts for a specific incident with pagination | ✅ |
| list_incident_notes | Incidents | Lists all notes for a specific incident | ✅ |
| list_incidents | Incidents | Lists incidents | ✅ |
| manage_incidents | Incidents | Updates status, urgency, assignment, or escalation level | ❌ |
| get_incident_workflow | Incident Workflows | Retrieves a specific incident workflow | ✅ |
| list_incident_workflows | Incident Workflows | Lists incident workflows with optional filtering | ✅ |
| start_incident_workflow | Incident Workflows | Starts a workflow instance for an incident | ❌ |
| get_log_entry | Log Entries | Retrieves a specific log entry by ID | ✅ |
| list_log_entries | Log Entries | Lists all log entries across the account with time filtering | ✅ |
| add_team_member | Teams | Adds a user to a team with a specific role | ❌ |
| create_team | Teams | Creates a new team | ❌ |
| delete_team | Teams | Deletes a team | ❌ |
| get_team | Teams | Retrieves a specific team | ✅ |
| list_team_members | Teams | Lists members of a team | ✅ |
| list_teams | Teams | Lists teams | ✅ |
| remove_team_member | Teams | Removes a user from a team | ❌ |
| update_team | Teams | Updates an existing team | ❌ |
| get_user_data | Users | Gets the current user's data | ✅ |
| list_users | Users | Lists users in the PagerDuty account | ✅ |
| list_oncalls | On-call | Lists on-call schedules | ✅ |
| create_schedule_override | Schedules | Creates an override for a schedule | ❌ |
| get_schedule | Schedules | Retrieves a specific schedule | ✅ |
| list_schedule_users | Schedules | Lists users in a schedule | ✅ |
| list_schedules | Schedules | Lists schedules | ✅ |
| create_schedule | Schedules | Creates a new on-call schedule | ❌ |
| update_schedule | Schedules | Updates an existing schedule | ❌ |
| create_service | Services | Creates a new service | ❌ |
| get_service | Services | Retrieves a specific service | ✅ |
| list_services | Services | Lists services | ✅ |
| update_service | Services | Updates an existing service | ❌ |
| create_status_page_post | Status Pages | Creates a new post (incident or maintenance) on a status page | ❌ |
| create_status_page_post_update | Status Pages | Adds a new update to an existing status page post | ❌ |
| get_status_page_post | Status Pages | Retrieves details of a specific status page post | ✅ |
| list_status_page_impacts | Status Pages | Lists available impact levels for a status page | ✅ |
| list_status_page_post_updates | Status Pages | Lists all updates for a specific status page post | ✅ |
| list_status_page_severities | Status Pages | Lists available severity levels for a status page | ✅ |
| list_status_page_statuses | Status Pages | Lists available statuses for a status page | ✅ |
| list_status_pages | Status Pages | Lists all status pages with optional filtering | ✅ |
PagerDuty's MCP server is an open-source project, and as such, we offer only community-based support. If assistance is required, please open an issue in GitHub or PagerDuty's community forum.
If you are interested in contributing to this project, please refer to our Contributing Guidelines.
PAGERDUTY_USER_API_KEYPagerDuty User API Token - obtain from User Settings > API Access in your PagerDuty account
PAGERDUTY_API_HOSTPagerDuty API host URL (default: https://api.pagerduty.com, EU: https://api.eu.pagerduty.com)