pagerduty-oncall

name	pagerduty-oncall
description	Manage on-call schedules and escalation policies in PagerDuty.
version	1.0.0
license	Apache-2.0
author	netclaw
tags	[]

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)