> This page is for Agent Handler.

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.merge.dev/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.merge.dev/_mcp/server.

# PagerDuty

**Authentication:** OAuth or API key. See [Magic Link](/merge-agent-handler/features/magic-link) for the runtime auth flow, or [Application credentials](/merge-agent-handler/admin-setup/add-oauth-credentials) to bring your own OAuth app.

## Sample use cases

* Show me incidents from the last 24 hours, grouped by service.
* Trigger an incident on the `payments` service with severity SEV2 and page the on-call.
* Pull on-call rotation for the next 7 days and post in #engineering.

## Available Tools

#### get\_incident\_analytics

Get aggregated incident metrics across the account. Filter by date range, urgency, service, or team. Returns MTTA, MTTR, incident counts.

#### get\_service\_analytics

Get aggregated metrics broken down by service. Filter by date range, urgency, service, or team. Returns per-service MTTA, MTTR, incident counts.

#### list\_escalation\_policies

List escalation policies with optional filters. Escalation policies define who to notify and in what order. Supports pagination.

#### get\_escalation\_policy

Get an escalation policy by ID. Returns full policy details including escalation rules and targets.

#### create\_escalation\_policy

Create an escalation policy. Requires name and escalation\_rules with targets (users/schedules) and delays. Use list\_users or list\_schedules to find target IDs.

#### update\_escalation\_policy

Update an escalation policy. Change name, description, rules, or loop count.

#### delete\_escalation\_policy

Delete an escalation policy by ID. This is permanent. Ensure no services reference this policy first.

#### list\_incidents

List incidents with optional filters for status, urgency, service, date range. Supports pagination via offset/limit.

#### get\_incident

Get a specific incident by ID. Returns full incident details including status, assignments, and priority.

#### create\_incident

Create a new incident. Requires title and service\_id. Use list\_services to find valid service IDs. Optionally set urgency, priority, and assignments.

#### update\_incident

Update an incident. Change status (acknowledge/resolve), urgency, priority, or reassign. Use list\_priorities for valid priority IDs.

#### list\_incident\_notes

List notes on an incident. Notes are timestamped comments added by responders during incident lifecycle.

#### create\_incident\_note

Add a note to an incident. Notes help document incident response activities and findings.

#### list\_incident\_alerts

List alerts for an incident. Alerts are the underlying triggers that created or were grouped into the incident.

#### list\_incident\_log\_entries

List log entries for an incident. Shows the timeline of actions taken during incident response.

#### list\_priorities

List priority levels configured in PagerDuty. Priorities are used when creating or updating incidents.

#### list\_tags

List tags with optional name filter. Tags can be attached to users, teams, and escalation policies for organization.

#### create\_tag

Create a new tag. Tags help organize users, teams, and escalation policies.

#### list\_log\_entries

List log entries across the account. Log entries record all actions in PagerDuty (triggers, acknowledgements, escalations, etc.).

#### list\_maintenance\_windows

List maintenance windows. Maintenance windows temporarily disable incident creation for specified services.

#### get\_maintenance\_window

Get a maintenance window by ID. Returns full details including services and time range.

#### create\_maintenance\_window

Create a maintenance window. Temporarily disables incident creation for specified services during the time range.

#### update\_maintenance\_window

Update a maintenance window. Change time range, description, or services.

#### delete\_maintenance\_window

Delete a maintenance window by ID. This is permanent and cannot be undone.

#### list\_audit\_records

List audit records across the account. Tracks changes to all PagerDuty resources for compliance and security review.

#### list\_oncalls

List who is currently on-call. Filter by schedule, escalation policy, user, or time range. Use to find current responders.

#### list\_schedules

List on-call schedules with optional name filter. Schedules define who is on-call at any given time. Supports pagination.

#### get\_schedule

Get a schedule by ID with rendered on-call entries. Optionally specify since/until for the rendered time range.

#### create\_schedule

Create an on-call schedule. Requires name, time\_zone, and schedule\_layers. Each layer defines a rotation with users, start time, and turn length.

#### update\_schedule

Update a schedule. Change name, description, time zone, or schedule layers.

#### delete\_schedule

Delete a schedule by ID. This is permanent. Ensure no escalation policies reference this schedule first.

#### list\_services

List services with optional filters. Services represent applications or components that generate incidents. Supports pagination via offset/limit.

#### get\_service

Get a specific service by ID. Returns full service details including escalation policy and alert settings.

#### create\_service

Create a new service. Requires name and escalation\_policy\_id. Use list\_escalation\_policies to find valid IDs.

#### update\_service

Update a service. Change name, description, escalation policy, or alert settings.

#### delete\_service

Delete a service by ID. This is permanent and cannot be undone. All associated incidents will remain.

#### list\_teams

List teams with optional name filter. Teams group users for incident assignment and escalation. Supports pagination.

#### get\_team

Get a specific team by ID. Returns team details including parent team relationship.

#### create\_team

Create a new team. Requires a name. Optionally set description and parent team for nesting.

#### update\_team

Update a team. Change name, description, or parent team.

#### delete\_team

Delete a team by ID. This is permanent. Reassign users and escalation policies before deleting.

#### list\_users

List users with optional filters by name, email, or team. Supports pagination via offset/limit.

#### get\_user

Get a specific user by ID. Returns full user details including role, teams, and contact methods.

#### create\_user

Create a new user. Requires name and email. Optionally set role, time zone, and job title.

#### update\_user

Update a user. Change name, email, role, time zone, or other profile fields.

#### delete\_user

Delete a user by ID. This is permanent. The user must not be on-call or have pending incidents.