SuperAPI AI Directory
Partner with us中文AI newsFavorites
Skillspagerduty-oncall

pagerduty-oncall

General & other

View repository

Updated 10-15 17:21

About this skill

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)

Failure Behavior

  • On a tool error (timeout, unreachable host, malformed response), report the failure and its error message directly to the user rather than fabricating or guessing at results.
  • Do not automatically retry a write/mutating operation after a failure — surface the error and get explicit confirmation before retrying, since a blind retry on a partially-applied change can leave state inconsistent.