pagerduty-incidents

---
name: pagerduty-incidents
description: "Manage and investigate incidents in PagerDuty."
version: 1.0.0
license: Apache-2.0
author: netclaw
tags: []
---

# PagerDuty Incidents Skill

Manage and investigate incidents in PagerDuty.

## Tools

| Tool | Description |
|------|-------------|
| `list_incidents` | List incidents with filters (status, urgency, time range) |
| `get_incident` | Get detailed incident information |
| `get_alert_from_incident` | Get specific alert from an incident |
| `list_alerts_from_incident` | List all alerts associated with an incident |
| `list_incident_notes` | Get notes/timeline from an incident |
| `get_outlier_incident` | Identify anomalous incident patterns |
| `get_past_incidents` | Get historical incidents for pattern analysis |
| `get_related_incidents` | Find related incidents by service or time |
| `create_incident` | Create a new incident (requires write permission) |
| `manage_incidents` | Acknowledge, resolve, or merge incidents |
| `add_note_to_incident` | Add investigation notes to incident |
| `add_responders` | Add additional responders to an incident |

## Example Queries

```
List all triggered incidents
→ list_incidents(statuses=["triggered"])

Get details of a specific incident
→ get_incident(incident_id="P12ABC3")

List incidents for a service in the past hour
→ list_incidents(service_ids=["PSERVICE1"], since="1h")

Get all alerts from an incident
→ list_alerts_from_incident(incident_id="P12ABC3")

Find related incidents to investigate
→ get_related_incidents(incident_id="P12ABC3")
```

## Workflows

### Incident Investigation
1. List triggered incidents: `list_incidents(statuses=["triggered"])`
2. Get incident details: `get_incident(incident_id="...")`
3. Review alerts: `list_alerts_from_incident(incident_id="...")`
4. Check for related incidents: `get_related_incidents(incident_id="...")`
5. Add investigation notes: `add_note_to_incident(incident_id="...", note="...")`

### Network Outage Response
1. List high-urgency incidents: `list_incidents(urgencies=["high"])`
2. Filter by network services: `list_incidents(service_ids=["network-core"])`
3. Acknowledge incident: `manage_incidents(incident_ids=["..."], type="acknowledge")`
4. Check past incidents for patterns: `get_past_incidents(incident_id="...")`
5. Add responders if needed: `add_responders(incident_id="...", responder_ids=["..."])`

### Incident Pattern Analysis
1. Get historical incidents: `list_incidents(since="7d", until="now")`
2. Identify outliers: `get_outlier_incident()`
3. Find related incidents: `get_related_incidents(incident_id="...")`
4. Review notes for root cause: `list_incident_notes(incident_id="...")`

## Prerequisites

- `PAGERDUTY_USER_API_KEY` PagerDuty User API key
- `PAGERDUTY_API_HOST` API host (optional, for EU customers)

## Server

This skill uses the `pagerduty-mcp` server via uvx (stdio transport).

## Notes

- Write operations (create, manage, add_note) require `--enable-write-tools` flag
- NetClaw requires explicit confirmation before modifying incidents
- Incident creation should integrate with ServiceNow CR workflow