PagerDuty

PagerDuty MCP Server for Cloudflare Workers

Available Tools

68 tools available in the PagerDuty MCP server. Each tool can be called by AI assistants to perform specific actions.

pagerduty_list_escalation_policies

List escalation policies from PagerDuty.

Args:

teamIds: Filter by team IDs
userIds: Filter by user IDs
query: Search query string
include: Additional data to include (services, teams, targets)
limit: Number of policies to return (1-100)
offset: Pagination offset
format: Response format

Returns: Paginated list of escalation policies.

{
  "type": "object",
  "properties": {
    "limit": {
      "type": "integer",
      "default": 25,
      "maximum": 100,
      "minimum": 1
    },
    "query": {
      "type": "string",
      "description": "Search query"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "offset": {
      "type": "integer",
      "default": 0,
      "minimum": 0
    },
    "teamIds": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Filter by team IDs"
    },
    "userIds": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Filter by user IDs"
    }
  }
}

pagerduty_get_escalation_policy

Get a single escalation policy by ID.

Args:

policyId: The escalation policy ID
include: Additional data to include (services, teams, targets)
format: Response format

Returns: The escalation policy with all details.

{
  "type": "object",
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "policyId": {
      "type": "string",
      "description": "Escalation policy ID"
    }
  }
}

pagerduty_create_escalation_policy

Create a new escalation policy.

Args:

name: Policy name (required)
description: Policy description
numLoops: Number of times to loop through the rules (0-9)
onCallHandoffNotifications: When to send handoff notifications
escalationRules: Array of escalation rules (required) Each rule has:
- escalationDelayInMinutes: Delay before escalating
- targets: Array of targets (users or schedules)

Returns: The created escalation policy.

{
  "type": "object",
  "required": [
    "name"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "Policy name"
    },
    "numLoops": {
      "type": "integer",
      "maximum": 9,
      "minimum": 0,
      "description": "Number of loops"
    },
    "description": {
      "type": "string",
      "description": "Policy description"
    }
  }
}

pagerduty_update_escalation_policy

Update an existing escalation policy.

Args:

policyId: Policy ID to update
name: New name
description: New description
numLoops: New number of loops
onCallHandoffNotifications: New handoff notification setting
escalationRules: New escalation rules

Returns: The updated escalation policy.

{
  "type": "object",
  "required": [
    "policyId"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "New name"
    },
    "numLoops": {
      "type": "integer",
      "maximum": 9,
      "minimum": 0,
      "description": "Number of loops"
    },
    "policyId": {
      "type": "string",
      "description": "Policy ID to update"
    },
    "description": {
      "type": "string",
      "description": "New description"
    }
  }
}

pagerduty_delete_escalation_policy

Delete an escalation policy.

Args:

policyId: Policy ID to delete

Returns: Confirmation of deletion.

{
  "type": "object",
  "required": [
    "policyId"
  ],
  "properties": {
    "policyId": {
      "type": "string",
      "description": "Policy ID to delete"
    }
  }
}

pagerduty_list_incidents

List incidents from PagerDuty with filtering options.

Returns a paginated list of incidents. Supports filtering by status, urgency, service, team, and date range.

Args:

statuses: Filter by status (triggered, acknowledged, resolved)
urgencies: Filter by urgency (high, low)
serviceIds: Filter by service IDs
teamIds: Filter by team IDs
since: Start of date range (ISO 8601)
until: End of date range (ISO 8601)
limit: Number of incidents to return (1-100)
offset: Pagination offset
format: Response format ('json' or 'markdown')

Returns: Paginated list of incidents with details.

{
  "type": "object",
  "properties": {
    "limit": {
      "type": "integer",
      "default": 25,
      "maximum": 100,
      "minimum": 1,
      "description": "Number of incidents to return"
    },
    "since": {
      "type": "string",
      "description": "Start of date range (ISO 8601)"
    },
    "until": {
      "type": "string",
      "description": "End of date range (ISO 8601)"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string",
      "default": "json",
      "description": "Response format"
    },
    "offset": {
      "type": "integer",
      "default": 0,
      "minimum": 0,
      "description": "Pagination offset"
    },
    "teamIds": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Filter by team IDs"
    },
    "serviceIds": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Filter by service IDs"
    }
  }
}

pagerduty_get_incident

Get a single incident by ID.

Args:

incidentId: The incident ID
format: Response format ('json' or 'markdown')

Returns: The incident record with all available fields.

{
  "type": "object",
  "required": [
    "incidentId"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "incidentId": {
      "type": "string",
      "description": "Incident ID"
    }
  }
}

pagerduty_create_incident

Create a new incident in PagerDuty.

Requires X-PagerDuty-From header with a valid email address.

Args:

serviceId: Service ID for the incident (required)
title: Incident title (required)
body: Incident description/details
urgency: Incident urgency (high or low)
incidentKey: Deduplication key
priorityId: Priority ID
escalationPolicyId: Override escalation policy
assigneeIds: User IDs to assign

Returns: The created incident record.

{
  "type": "object",
  "required": [
    "serviceId",
    "title"
  ],
  "properties": {
    "body": {
      "type": "string",
      "description": "Incident description"
    },
    "title": {
      "type": "string",
      "description": "Incident title (required)"
    },
    "urgency": {
      "enum": [
        "high",
        "low"
      ],
      "type": "string",
      "description": "Incident urgency"
    },
    "serviceId": {
      "type": "string",
      "description": "Service ID (required)"
    },
    "priorityId": {
      "type": "string",
      "description": "Priority ID"
    },
    "assigneeIds": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "User IDs to assign"
    },
    "incidentKey": {
      "type": "string",
      "description": "Deduplication key"
    },
    "escalationPolicyId": {
      "type": "string",
      "description": "Escalation policy ID"
    }
  }
}

pagerduty_acknowledge_incident

Acknowledge an incident.

Requires X-PagerDuty-From header with a valid email address.

Args:

incidentId: The incident ID to acknowledge

Returns: The updated incident.

{
  "type": "object",
  "required": [
    "incidentId"
  ],
  "properties": {
    "incidentId": {
      "type": "string",
      "description": "Incident ID to acknowledge"
    }
  }
}

pagerduty_resolve_incident

Resolve an incident.

Requires X-PagerDuty-From header with a valid email address.

Args:

incidentId: The incident ID to resolve
resolution: Resolution notes

Returns: The updated incident.

{
  "type": "object",
  "required": [
    "incidentId"
  ],
  "properties": {
    "incidentId": {
      "type": "string",
      "description": "Incident ID to resolve"
    },
    "resolution": {
      "type": "string",
      "description": "Resolution notes"
    }
  }
}

pagerduty_snooze_incident

Snooze an incident for a specified duration.

Requires X-PagerDuty-From header with a valid email address.

Args:

incidentId: The incident ID to snooze
durationSeconds: Duration to snooze in seconds

Returns: The updated incident.

{
  "type": "object",
  "required": [
    "incidentId",
    "durationSeconds"
  ],
  "properties": {
    "incidentId": {
      "type": "string",
      "description": "Incident ID to snooze"
    },
    "durationSeconds": {
      "type": "integer",
      "minimum": 60,
      "description": "Duration to snooze in seconds"
    }
  }
}

pagerduty_merge_incidents

Merge multiple incidents into one.

Requires X-PagerDuty-From header with a valid email address.

Args:

targetIncidentId: The incident to merge into
sourceIncidentIds: Incidents to merge from

Returns: The merged incident.

{
  "type": "object",
  "required": [
    "targetIncidentId",
    "sourceIncidentIds"
  ],
  "properties": {
    "targetIncidentId": {
      "type": "string",
      "description": "Target incident ID"
    },
    "sourceIncidentIds": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Source incident IDs to merge"
    }
  }
}

pagerduty_list_addons

List installed add-ons.

Args:

limit: Number of add-ons to return
offset: Pagination offset
format: Response format

Returns: Paginated list of add-ons.

{
  "type": "object",
  "properties": {
    "limit": {
      "type": "integer",
      "default": 25,
      "maximum": 100,
      "minimum": 1
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "offset": {
      "type": "integer",
      "default": 0,
      "minimum": 0
    }
  }
}

pagerduty_update_incident

Update an incident's properties.

Requires X-PagerDuty-From header with a valid email address.

Args:

incidentId: The incident ID to update
title: New title
urgency: New urgency (high or low)
priorityId: New priority ID
escalationLevel: Escalation level
escalationPolicyId: New escalation policy ID
assigneeIds: New assignee user IDs

Returns: The updated incident.

{
  "type": "object",
  "required": [
    "incidentId"
  ],
  "properties": {
    "title": {
      "type": "string",
      "description": "New title"
    },
    "urgency": {
      "enum": [
        "high",
        "low"
      ],
      "type": "string",
      "description": "New urgency"
    },
    "incidentId": {
      "type": "string",
      "description": "Incident ID to update"
    },
    "priorityId": {
      "type": "string",
      "description": "New priority ID"
    },
    "assigneeIds": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "New assignee user IDs"
    },
    "escalationLevel": {
      "type": "integer",
      "description": "Escalation level"
    },
    "escalationPolicyId": {
      "type": "string",
      "description": "New escalation policy ID"
    }
  }
}

pagerduty_list_incident_alerts

List alerts for an incident.

Args:

incidentId: The incident ID
limit: Number of alerts to return
offset: Pagination offset
format: Response format

Returns: Paginated list of alerts.

{
  "type": "object",
  "required": [
    "incidentId"
  ],
  "properties": {
    "limit": {
      "type": "integer",
      "default": 25,
      "maximum": 100,
      "minimum": 1
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "offset": {
      "type": "integer",
      "default": 0,
      "minimum": 0
    },
    "incidentId": {
      "type": "string",
      "description": "Incident ID"
    }
  }
}

pagerduty_list_incident_log_entries

List log entries for an incident.

Args:

incidentId: The incident ID
limit: Number of log entries to return
offset: Pagination offset
format: Response format

Returns: Paginated list of log entries.

{
  "type": "object",
  "required": [
    "incidentId"
  ],
  "properties": {
    "limit": {
      "type": "integer",
      "default": 25,
      "maximum": 100,
      "minimum": 1
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "offset": {
      "type": "integer",
      "default": 0,
      "minimum": 0
    },
    "incidentId": {
      "type": "string",
      "description": "Incident ID"
    }
  }
}

pagerduty_list_incident_notes

List notes for an incident.

Args:

incidentId: The incident ID
format: Response format

Returns: List of incident notes.

{
  "type": "object",
  "required": [
    "incidentId"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "incidentId": {
      "type": "string",
      "description": "Incident ID"
    }
  }
}

pagerduty_add_incident_note

Add a note to an incident.

Requires X-PagerDuty-From header with a valid email address.

Args:

incidentId: The incident ID
content: Note content

Returns: The created note.

{
  "type": "object",
  "required": [
    "incidentId",
    "content"
  ],
  "properties": {
    "content": {
      "type": "string",
      "description": "Note content"
    },
    "incidentId": {
      "type": "string",
      "description": "Incident ID"
    }
  }
}

pagerduty_list_oncalls

List current on-call entries.

Returns who is currently on-call for schedules and escalation policies.

Args:

scheduleIds: Filter by schedule IDs
userIds: Filter by user IDs
escalationPolicyIds: Filter by escalation policy IDs
since: Start of time range (ISO 8601)
until: End of time range (ISO 8601)
earliest: Return only the earliest on-call for each escalation policy
include: Additional data to include (escalation_policies, schedules, users)
limit: Number of entries to return (1-100)
offset: Pagination offset
format: Response format

Returns: Paginated list of on-call entries.

{
  "type": "object",
  "properties": {
    "limit": {
      "type": "integer",
      "default": 25,
      "maximum": 100,
      "minimum": 1
    },
    "since": {
      "type": "string",
      "description": "Start of time range (ISO 8601)"
    },
    "until": {
      "type": "string",
      "description": "End of time range (ISO 8601)"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "offset": {
      "type": "integer",
      "default": 0,
      "minimum": 0
    },
    "userIds": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Filter by user IDs"
    },
    "earliest": {
      "type": "boolean",
      "description": "Return only earliest on-call per policy"
    },
    "scheduleIds": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Filter by schedule IDs"
    },
    "escalationPolicyIds": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Filter by escalation policy IDs"
    }
  }
}

pagerduty_list_abilities

List abilities/features available for the account.

Returns: List of ability names (e.g., 'teams', 'read_only_users', 'service_support_hours').

{
  "type": "object",
  "properties": {}
}

pagerduty_test_ability

Test if an ability/feature is available for the account.

Args:

ability: The ability name to test

Returns: Whether the ability is available.

{
  "type": "object",
  "required": [
    "ability"
  ],
  "properties": {
    "ability": {
      "type": "string",
      "description": "Ability name to test"
    }
  }
}

pagerduty_list_priorities

List incident priorities defined in PagerDuty.

Returns: List of priorities with their IDs, names, and colors.

{
  "type": "object",
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    }
  }
}

pagerduty_list_vendors

List integration vendors available in PagerDuty.

Args:

limit: Number of vendors to return
offset: Pagination offset
format: Response format

Returns: Paginated list of vendors.

{
  "type": "object",
  "properties": {
    "limit": {
      "type": "integer",
      "default": 25,
      "maximum": 100,
      "minimum": 1
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "offset": {
      "type": "integer",
      "default": 0,
      "minimum": 0
    }
  }
}

pagerduty_get_vendor

Get a single vendor by ID.

Args:

vendorId: The vendor ID
format: Response format

Returns: The vendor details.

{
  "type": "object",
  "required": [
    "vendorId"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "vendorId": {
      "type": "string",
      "description": "Vendor ID"
    }
  }
}

pagerduty_list_log_entries

List log entries from PagerDuty.

Args:

since: Start of time range (ISO 8601)
until: End of time range (ISO 8601)
isOverview: Return overview entries only
include: Additional data to include (incidents, services, channels, teams)
timeZone: Time zone for rendering
limit: Number of entries to return
offset: Pagination offset
format: Response format

Returns: Paginated list of log entries.

{
  "type": "object",
  "properties": {
    "limit": {
      "type": "integer",
      "default": 25,
      "maximum": 100,
      "minimum": 1
    },
    "since": {
      "type": "string",
      "description": "Start of time range (ISO 8601)"
    },
    "until": {
      "type": "string",
      "description": "End of time range (ISO 8601)"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "offset": {
      "type": "integer",
      "default": 0,
      "minimum": 0
    },
    "timeZone": {
      "type": "string",
      "description": "Time zone for rendering"
    },
    "isOverview": {
      "type": "boolean",
      "description": "Return overview entries only"
    }
  }
}

pagerduty_get_log_entry

Get a single log entry by ID.

Args:

logEntryId: The log entry ID
format: Response format

Returns: The log entry details.

{
  "type": "object",
  "required": [
    "logEntryId"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "logEntryId": {
      "type": "string",
      "description": "Log entry ID"
    }
  }
}

pagerduty_list_maintenance_windows

List maintenance windows.

Args:

serviceIds: Filter by service IDs
teamIds: Filter by team IDs
filter: Filter by status (past, future, ongoing, all)
query: Search query
include: Additional data to include (services, teams)
limit: Number of windows to return
offset: Pagination offset
format: Response format

Returns: Paginated list of maintenance windows.

{
  "type": "object",
  "properties": {
    "limit": {
      "type": "integer",
      "default": 25,
      "maximum": 100,
      "minimum": 1
    },
    "query": {
      "type": "string",
      "description": "Search query"
    },
    "filter": {
      "enum": [
        "past",
        "future",
        "ongoing",
        "all"
      ],
      "type": "string",
      "description": "Filter by status"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "offset": {
      "type": "integer",
      "default": 0,
      "minimum": 0
    },
    "include": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Additional data to include"
    },
    "teamIds": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Filter by team IDs"
    },
    "serviceIds": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Filter by service IDs"
    }
  }
}

pagerduty_get_maintenance_window

Get a single maintenance window by ID.

Args:

windowId: The maintenance window ID
format: Response format

Returns: The maintenance window details.

{
  "type": "object",
  "required": [
    "windowId"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "windowId": {
      "type": "string",
      "description": "Maintenance window ID"
    }
  }
}

pagerduty_create_maintenance_window

Create a maintenance window.

Requires X-PagerDuty-From header.

Args:

startTime: Start time (ISO 8601)
endTime: End time (ISO 8601)
description: Description
serviceIds: Service IDs to include (required)

Returns: The created maintenance window.

{
  "type": "object",
  "required": [
    "startTime",
    "endTime",
    "serviceIds"
  ],
  "properties": {
    "endTime": {
      "type": "string",
      "description": "End time (ISO 8601)"
    },
    "startTime": {
      "type": "string",
      "description": "Start time (ISO 8601)"
    },
    "serviceIds": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Service IDs to include"
    },
    "description": {
      "type": "string",
      "description": "Description"
    }
  }
}

pagerduty_delete_maintenance_window

Delete a maintenance window.

Args:

windowId: Maintenance window ID to delete

Returns: Confirmation of deletion.

{
  "type": "object",
  "required": [
    "windowId"
  ],
  "properties": {
    "windowId": {
      "type": "string",
      "description": "Maintenance window ID to delete"
    }
  }
}

pagerduty_list_extensions

List extensions.

Args:

limit: Number of extensions to return
offset: Pagination offset
format: Response format

Returns: Paginated list of extensions.

{
  "type": "object",
  "properties": {
    "limit": {
      "type": "integer",
      "default": 25,
      "maximum": 100,
      "minimum": 1
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "offset": {
      "type": "integer",
      "default": 0,
      "minimum": 0
    }
  }
}

pagerduty_get_extension

Get a single extension by ID.

Args:

extensionId: The extension ID
format: Response format

Returns: The extension details.

{
  "type": "object",
  "required": [
    "extensionId"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "extensionId": {
      "type": "string",
      "description": "Extension ID"
    }
  }
}

pagerduty_list_response_plays

List response plays.

Requires X-PagerDuty-From header.

Args:

format: Response format

Returns: List of response plays.

{
  "type": "object",
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    }
  }
}

pagerduty_run_response_play

Run a response play on an incident.

Requires X-PagerDuty-From header.

Args:

responsePlayId: The response play ID
incidentId: The incident ID to run the play on

Returns: Confirmation that the play was run.

{
  "type": "object",
  "required": [
    "responsePlayId",
    "incidentId"
  ],
  "properties": {
    "incidentId": {
      "type": "string",
      "description": "Incident ID"
    },
    "responsePlayId": {
      "type": "string",
      "description": "Response play ID"
    }
  }
}

pagerduty_list_tags

List tags.

Args:

limit: Number of tags to return
offset: Pagination offset
format: Response format

Returns: Paginated list of tags.

{
  "type": "object",
  "properties": {
    "limit": {
      "type": "integer",
      "default": 25,
      "maximum": 100,
      "minimum": 1
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "offset": {
      "type": "integer",
      "default": 0,
      "minimum": 0
    }
  }
}

pagerduty_create_tag

Create a tag.

Args:

label: Tag label

Returns: The created tag.

{
  "type": "object",
  "required": [
    "label"
  ],
  "properties": {
    "label": {
      "type": "string",
      "description": "Tag label"
    }
  }
}

pagerduty_delete_tag

Delete a tag.

Args:

tagId: Tag ID to delete

Returns: Confirmation of deletion.

{
  "type": "object",
  "required": [
    "tagId"
  ],
  "properties": {
    "tagId": {
      "type": "string",
      "description": "Tag ID to delete"
    }
  }
}

pagerduty_list_business_services

List business services.

Args:

limit: Number of business services to return
offset: Pagination offset
format: Response format

Returns: Paginated list of business services.

{
  "type": "object",
  "properties": {
    "limit": {
      "type": "integer",
      "default": 25,
      "maximum": 100,
      "minimum": 1
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "offset": {
      "type": "integer",
      "default": 0,
      "minimum": 0
    }
  }
}

pagerduty_get_business_service

Get a single business service by ID.

Args:

businessServiceId: The business service ID
format: Response format

Returns: The business service details.

{
  "type": "object",
  "required": [
    "businessServiceId"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "businessServiceId": {
      "type": "string",
      "description": "Business service ID"
    }
  }
}

pagerduty_create_business_service

Create a business service.

Args:

name: Business service name (required)
description: Description
pointOfContact: Point of contact
teamId: Owning team ID

Returns: The created business service.

{
  "type": "object",
  "required": [
    "name"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "Business service name"
    },
    "teamId": {
      "type": "string",
      "description": "Owning team ID"
    },
    "description": {
      "type": "string",
      "description": "Description"
    },
    "pointOfContact": {
      "type": "string",
      "description": "Point of contact"
    }
  }
}

pagerduty_delete_business_service

Delete a business service.

Args:

businessServiceId: Business service ID to delete

Returns: Confirmation of deletion.

{
  "type": "object",
  "required": [
    "businessServiceId"
  ],
  "properties": {
    "businessServiceId": {
      "type": "string",
      "description": "Business service ID to delete"
    }
  }
}

pagerduty_get_user

Get a single user by ID.

Args:

userId: The user ID
include: Additional data to include
format: Response format

Returns: The user record with all available fields.

{
  "type": "object",
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "userId": {
      "type": "string",
      "description": "User ID"
    }
  }
}

pagerduty_get_current_user

Get the currently authenticated user.

Args:

format: Response format

Returns: The current user's record.

{
  "type": "object",
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    }
  }
}

pagerduty_get_incident_analytics

Get raw incident analytics data.

Args:

since: Start of time range (ISO 8601, required)
until: End of time range (ISO 8601, required)
serviceIds: Filter by service IDs
teamIds: Filter by team IDs
urgency: Filter by urgency (high, low)
format: Response format

Returns: List of analytics data for incidents.

{
  "type": "object",
  "required": [
    "since",
    "until"
  ],
  "properties": {
    "since": {
      "type": "string",
      "description": "Start of time range (ISO 8601)"
    },
    "until": {
      "type": "string",
      "description": "End of time range (ISO 8601)"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "teamIds": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Filter by team IDs"
    },
    "urgency": {
      "enum": [
        "high",
        "low"
      ],
      "type": "string",
      "description": "Filter by urgency"
    },
    "serviceIds": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Filter by service IDs"
    }
  }
}

pagerduty_list_schedules

List schedules from PagerDuty.

Args:

query: Search query string
include: Additional data to include (schedule_layers, final_schedule, override_subschedule)
limit: Number of schedules to return (1-100)
offset: Pagination offset
format: Response format

Returns: Paginated list of schedules.

{
  "type": "object",
  "properties": {
    "limit": {
      "type": "integer",
      "default": 25,
      "maximum": 100,
      "minimum": 1
    },
    "query": {
      "type": "string",
      "description": "Search query"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "offset": {
      "type": "integer",
      "default": 0,
      "minimum": 0
    }
  }
}

pagerduty_get_schedule

Get a single schedule by ID with rendered schedule entries.

Args:

scheduleId: The schedule ID
since: Start of time range (ISO 8601)
until: End of time range (ISO 8601)
timeZone: Time zone for rendering
format: Response format

Returns: The schedule with rendered entries.

{
  "type": "object",
  "required": [
    "scheduleId"
  ],
  "properties": {
    "since": {
      "type": "string",
      "description": "Start of time range (ISO 8601)"
    },
    "until": {
      "type": "string",
      "description": "End of time range (ISO 8601)"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "timeZone": {
      "type": "string",
      "description": "Time zone for rendering"
    },
    "scheduleId": {
      "type": "string",
      "description": "Schedule ID"
    }
  }
}

pagerduty_create_schedule

Create a new schedule.

Args:

name: Schedule name (required)
description: Schedule description
timeZone: Schedule time zone (required)
scheduleLayers: Array of schedule layers (required) Each layer has:
- start: Layer start time (ISO 8601)
- rotationVirtualStart: Rotation reference point
- rotationTurnLengthSeconds: Rotation period in seconds
- users: Array of user references

Returns: The created schedule.

{
  "type": "object",
  "required": [
    "name",
    "timeZone"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "Schedule name"
    },
    "timeZone": {
      "type": "string",
      "description": "Schedule time zone"
    },
    "description": {
      "type": "string",
      "description": "Schedule description"
    }
  }
}

pagerduty_delete_schedule

Delete a schedule.

Args:

scheduleId: Schedule ID to delete

Returns: Confirmation of deletion.

{
  "type": "object",
  "required": [
    "scheduleId"
  ],
  "properties": {
    "scheduleId": {
      "type": "string",
      "description": "Schedule ID to delete"
    }
  }
}

pagerduty_list_schedule_overrides

List overrides for a schedule within a time range.

Args:

scheduleId: The schedule ID
since: Start of time range (ISO 8601, required)
until: End of time range (ISO 8601, required)
format: Response format

Returns: List of schedule overrides.

{
  "type": "object",
  "required": [
    "scheduleId",
    "since",
    "until"
  ],
  "properties": {
    "since": {
      "type": "string",
      "description": "Start of time range (ISO 8601)"
    },
    "until": {
      "type": "string",
      "description": "End of time range (ISO 8601)"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "scheduleId": {
      "type": "string",
      "description": "Schedule ID"
    }
  }
}

pagerduty_create_schedule_override

Create an override for a schedule.

Args:

scheduleId: The schedule ID
userId: User ID who will be on-call during the override
start: Override start time (ISO 8601)
end: Override end time (ISO 8601)

Returns: The created override.

{
  "type": "object",
  "required": [
    "scheduleId",
    "userId",
    "start",
    "end"
  ],
  "properties": {
    "end": {
      "type": "string",
      "description": "Override end time (ISO 8601)"
    },
    "start": {
      "type": "string",
      "description": "Override start time (ISO 8601)"
    },
    "userId": {
      "type": "string",
      "description": "User ID for the override"
    },
    "scheduleId": {
      "type": "string",
      "description": "Schedule ID"
    }
  }
}

pagerduty_delete_schedule_override

Delete a schedule override.

Args:

scheduleId: The schedule ID
overrideId: Override ID to delete

Returns: Confirmation of deletion.

{
  "type": "object",
  "required": [
    "scheduleId",
    "overrideId"
  ],
  "properties": {
    "overrideId": {
      "type": "string",
      "description": "Override ID to delete"
    },
    "scheduleId": {
      "type": "string",
      "description": "Schedule ID"
    }
  }
}

pagerduty_list_services

List services from PagerDuty with optional filtering.

Args:

teamIds: Filter by team IDs
query: Search query string
include: Additional data to include (escalation_policies, teams, integrations)
limit: Number of services to return (1-100)
offset: Pagination offset
format: Response format ('json' or 'markdown')

Returns: Paginated list of services.

{
  "type": "object",
  "properties": {
    "limit": {
      "type": "integer",
      "default": 25,
      "maximum": 100,
      "minimum": 1
    },
    "query": {
      "type": "string",
      "description": "Search query"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "offset": {
      "type": "integer",
      "default": 0,
      "minimum": 0
    },
    "teamIds": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Filter by team IDs"
    }
  }
}

pagerduty_get_service

Get a single service by ID.

Args:

serviceId: The service ID
include: Additional data to include (escalation_policies, teams, integrations)
format: Response format

Returns: The service record with all available fields.

{
  "type": "object",
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "serviceId": {
      "type": "string",
      "description": "Service ID"
    }
  }
}

pagerduty_create_service

Create a new service in PagerDuty.

Args:

name: Service name (required)
description: Service description
escalationPolicyId: Escalation policy ID (required)
autoResolveTimeout: Auto-resolve timeout in seconds (null to disable)
acknowledgementTimeout: Acknowledgement timeout in seconds (null to disable)
alertCreation: Alert creation setting

Returns: The created service.

{
  "type": "object",
  "required": [
    "name",
    "escalationPolicyId"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "Service name"
    },
    "description": {
      "type": "string",
      "description": "Service description"
    },
    "autoResolveTimeout": {
      "type": "number",
      "description": "Auto-resolve timeout in seconds"
    },
    "escalationPolicyId": {
      "type": "string",
      "description": "Escalation policy ID"
    },
    "acknowledgementTimeout": {
      "type": "number",
      "description": "Acknowledgement timeout in seconds"
    }
  }
}

pagerduty_update_service

Update an existing service.

Args:

serviceId: Service ID to update
name: New name
description: New description
escalationPolicyId: New escalation policy ID
status: New status (active or disabled)
autoResolveTimeout: Auto-resolve timeout in seconds
acknowledgementTimeout: Acknowledgement timeout in seconds

Returns: The updated service.

{
  "type": "object",
  "required": [
    "serviceId"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "New name"
    },
    "status": {
      "enum": [
        "active",
        "disabled"
      ],
      "type": "string",
      "description": "New status"
    },
    "serviceId": {
      "type": "string",
      "description": "Service ID to update"
    },
    "description": {
      "type": "string",
      "description": "New description"
    },
    "autoResolveTimeout": {
      "type": "number",
      "description": "Auto-resolve timeout"
    },
    "escalationPolicyId": {
      "type": "string",
      "description": "New escalation policy ID"
    },
    "acknowledgementTimeout": {
      "type": "number",
      "description": "Acknowledgement timeout"
    }
  }
}

pagerduty_delete_service

Delete a service.

Args:

serviceId: Service ID to delete

Returns: Confirmation of deletion.

{
  "type": "object",
  "required": [
    "serviceId"
  ],
  "properties": {
    "serviceId": {
      "type": "string",
      "description": "Service ID to delete"
    }
  }
}

pagerduty_list_teams

List teams from PagerDuty.

Args:

query: Search query string
limit: Number of teams to return (1-100)
offset: Pagination offset
format: Response format

Returns: Paginated list of teams.

{
  "type": "object",
  "properties": {
    "limit": {
      "type": "integer",
      "default": 25,
      "maximum": 100,
      "minimum": 1
    },
    "query": {
      "type": "string",
      "description": "Search query"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "offset": {
      "type": "integer",
      "default": 0,
      "minimum": 0
    }
  }
}

pagerduty_get_team

Get a single team by ID.

Args:

teamId: The team ID
format: Response format

Returns: The team record.

{
  "type": "object",
  "required": [
    "teamId"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "teamId": {
      "type": "string",
      "description": "Team ID"
    }
  }
}

pagerduty_create_team

Create a new team.

Args:

name: Team name (required)
description: Team description
parentId: Parent team ID

Returns: The created team.

{
  "type": "object",
  "required": [
    "name"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "Team name"
    },
    "parentId": {
      "type": "string",
      "description": "Parent team ID"
    },
    "description": {
      "type": "string",
      "description": "Team description"
    }
  }
}

pagerduty_update_team

Update an existing team.

Args:

teamId: Team ID to update
name: New name
description: New description
parentId: New parent team ID (null to remove parent)

Returns: The updated team.

{
  "type": "object",
  "required": [
    "teamId"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "New name"
    },
    "teamId": {
      "type": "string",
      "description": "Team ID to update"
    },
    "parentId": {
      "type": "string",
      "description": "New parent team ID"
    },
    "description": {
      "type": "string",
      "description": "New description"
    }
  }
}

pagerduty_delete_team

Delete a team.

Args:

teamId: Team ID to delete

Returns: Confirmation of deletion.

{
  "type": "object",
  "required": [
    "teamId"
  ],
  "properties": {
    "teamId": {
      "type": "string",
      "description": "Team ID to delete"
    }
  }
}

pagerduty_list_team_members

List members of a team.

Args:

teamId: The team ID
format: Response format

Returns: List of team members.

{
  "type": "object",
  "required": [
    "teamId"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "teamId": {
      "type": "string",
      "description": "Team ID"
    }
  }
}

pagerduty_add_team_member

Add a user to a team.

Args:

teamId: The team ID
userId: The user ID to add
role: Role for the user (manager, observer, responder)

Returns: Confirmation of addition.

{
  "type": "object",
  "required": [
    "teamId",
    "userId"
  ],
  "properties": {
    "role": {
      "enum": [
        "manager",
        "observer",
        "responder"
      ],
      "type": "string",
      "description": "Role for the user"
    },
    "teamId": {
      "type": "string",
      "description": "Team ID"
    },
    "userId": {
      "type": "string",
      "description": "User ID to add"
    }
  }
}

pagerduty_remove_team_member

Remove a user from a team.

Args:

teamId: The team ID
userId: The user ID to remove

Returns: Confirmation of removal.

{
  "type": "object",
  "required": [
    "teamId",
    "userId"
  ],
  "properties": {
    "teamId": {
      "type": "string",
      "description": "Team ID"
    },
    "userId": {
      "type": "string",
      "description": "User ID to remove"
    }
  }
}

pagerduty_list_users

List users from PagerDuty with optional filtering.

Args:

teamIds: Filter by team IDs
query: Search query string
include: Additional data to include (contact_methods, notification_rules, teams)
limit: Number of users to return (1-100)
offset: Pagination offset
format: Response format

Returns: Paginated list of users.

{
  "type": "object",
  "properties": {
    "limit": {
      "type": "integer",
      "default": 25,
      "maximum": 100,
      "minimum": 1
    },
    "query": {
      "type": "string",
      "description": "Search query"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "offset": {
      "type": "integer",
      "default": 0,
      "minimum": 0
    },
    "teamIds": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Filter by team IDs"
    }
  }
}

pagerduty_create_user

Create a new user in PagerDuty.

Requires X-PagerDuty-From header with a valid email address.

Args:

name: User name (required)
email: User email (required)
role: User role
timeZone: User time zone
jobTitle: Job title
description: User description

Returns: The created user.

{
  "type": "object",
  "required": [
    "name",
    "email"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "User name"
    },
    "role": {
      "type": "string",
      "description": "User role"
    },
    "email": {
      "type": "string",
      "description": "User email"
    },
    "jobTitle": {
      "type": "string",
      "description": "Job title"
    },
    "timeZone": {
      "type": "string",
      "description": "User time zone"
    },
    "description": {
      "type": "string",
      "description": "User description"
    }
  }
}

pagerduty_update_user

Update an existing user.

Args:

userId: User ID to update
name: New name
email: New email
role: New role
timeZone: New time zone
jobTitle: New job title
description: New description

Returns: The updated user.

{
  "type": "object",
  "required": [
    "userId"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "New name"
    },
    "role": {
      "type": "string",
      "description": "New role"
    },
    "email": {
      "type": "string",
      "description": "New email"
    },
    "userId": {
      "type": "string",
      "description": "User ID to update"
    },
    "jobTitle": {
      "type": "string",
      "description": "New job title"
    },
    "timeZone": {
      "type": "string",
      "description": "New time zone"
    },
    "description": {
      "type": "string",
      "description": "New description"
    }
  }
}

pagerduty_delete_user

Delete a user.

Args:

userId: User ID to delete

Returns: Confirmation of deletion.

{
  "type": "object",
  "required": [
    "userId"
  ],
  "properties": {
    "userId": {
      "type": "string",
      "description": "User ID to delete"
    }
  }
}