PagerDuty On-Call Skill

Manage on-call schedules and escalation policies in PagerDuty.

Tools

| Tool | Description | |------|-------------| | list_oncalls | List current on-call users across schedules | | get_schedule | Get detailed schedule information | | list_schedules | List all on-call schedules | | list_schedule_users | List users assigned to a schedule | | get_escalation_policy | Get escalation policy details | | list_escalation_policies | List all escalation policies | | create_schedule | Create a new on-call schedule (requires write) | | update_schedule | Update an existing schedule (requires write) | | create_schedule_override | Create a schedule override (requires write) |

Example Queries

Who is on-call right now?
→ list_oncalls()

Get on-call for a specific schedule
→ list_oncalls(schedule_ids=["PSCHD123"])

List all schedules
→ list_schedules()

Get escalation policy details
→ get_escalation_policy(escalation_policy_id="PESCL456")

Create an override for vacation coverage
→ create_schedule_override(schedule_id="...", user_id="...", start="...", end="...")

Workflows

On-Call Visibility

1. List current on-calls: list_oncalls()
2. Get schedule details: get_schedule(schedule_id="...")
3. Review escalation policy: get_escalation_policy(escalation_policy_id="...")
4. Identify coverage gaps

Shift Handoff

1. List current on-calls: list_oncalls()
2. Get schedule for next shift: list_schedule_users(schedule_id="...")
3. Review active incidents before handoff
4. Document handoff notes in incident

Schedule Override (Vacation Coverage)

1. Get schedule details: get_schedule(schedule_id="...")
2. Identify coverage period
3. Create override: create_schedule_override(schedule_id="...", user_id="...", start="...", end="...")
4. Verify override applied: list_oncalls(since="...", until="...")

Escalation Review

1. List all escalation policies: list_escalation_policies()
2. Get policy details: get_escalation_policy(escalation_policy_id="...")
3. Review escalation levels and timeouts
4. Identify gaps in coverage

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/update schedule, overrides) require --enable-write-tools
• Schedule changes should be communicated to affected team members
• Overrides are useful for planned absences (vacation, training)