PagerDuty Automation via Rube MCP
Automate PagerDuty incident management and operations through Composio's PagerDuty toolkit via Rube MCP.
Prerequisites
- Rube MCP must be connected (RUBE_SEARCH_TOOLS available)
- Active PagerDuty connection via
RUBE_MANAGE_CONNECTIONS with toolkit pagerduty
- Always call
RUBE_SEARCH_TOOLS first to get current tool schemas
Setup
Get Rube MCP: Add https://rube.app/mcp as an MCP server in your client configuration. No API keys needed — just add the endpoint and it works.
- Verify Rube MCP is available by confirming
RUBE_SEARCH_TOOLS responds
- Call
RUBE_MANAGE_CONNECTIONS with toolkit pagerduty
- If connection is not ACTIVE, follow the returned auth link to complete PagerDuty authentication
- Confirm connection status shows ACTIVE before running any workflows
Core Workflows
1. Manage Incidents
When to use: User wants to create, update, acknowledge, or resolve incidents
Tool sequence:
PAGERDUTY_FETCH_INCIDENT_LIST - List incidents with filters [Required]
PAGERDUTY_RETRIEVE_INCIDENT_BY_INCIDENT_ID - Get specific incident details [Optional]
PAGERDUTY_CREATE_INCIDENT_RECORD - Create a new incident [Optional]
PAGERDUTY_UPDATE_INCIDENT_BY_ID - Update incident status or assignment [Optional]
PAGERDUTY_POST_INCIDENT_NOTE_USING_ID - Add a note to an incident [Optional]
PAGERDUTY_SNOOZE_INCIDENT_BY_DURATION - Snooze an incident for a period [Optional]
Key parameters:
statuses[]: Filter by status ('triggered', 'acknowledged', 'resolved')
service_ids[]: Filter by service IDs
urgencies[]: Filter by urgency ('high', 'low')
title: Incident title (for creation)
service: Service object with id and type (for creation)
status: New status for update operations
Pitfalls:
- Incident creation requires a
service object with both id and type: 'service_reference'
- Status transitions follow: triggered -> acknowledged -> resolved
- Cannot transition from resolved back to triggered directly
PAGERDUTY_UPDATE_INCIDENT_BY_ID requires the incident ID as a path parameter
- Snooze duration is in seconds; the incident re-triggers after the snooze period
2. Inspect Incident Alerts and Analytics
When to use: User wants to review alerts within an incident or analyze incident metrics
Tool sequence:
PAGERDUTY_GET_ALERTS_BY_INCIDENT_ID - List alerts for an incident [Required]
PAGERDUTY_GET_INCIDENT_ALERT_DETAILS - Get details of a specific alert [Optional]
PAGERDUTY_FETCH_INCIDENT_ANALYTICS_BY_ID - Get incident analytics/metrics [Optional]
Key parameters:
incident_id: The incident ID
alert_id: Specific alert ID within the incident
statuses[]: Filter alerts by status
Pitfalls:
- An incident can have multiple alerts; each alert has its own status
- Alert IDs are scoped to the incident
- Analytics data includes response times, engagement metrics, and resolution times
3. Manage Services
When to use: User wants to create, update, or list services
Tool sequence:
PAGERDUTY_RETRIEVE_LIST_OF_SERVICES - List all services [Required]
PAGERDUTY_RETRIEVE_SERVICE_BY_ID - Get service details [Optional]
PAGERDUTY_CREATE_NEW_SERVICE - Create a new technical service [Optional]
PAGERDUTY_UPDATE_SERVICE_BY_ID - Update service configuration [Optional]
PAGERDUTY_CREATE_INTEGRATION_FOR_SERVICE - Add an integration to a service [Optional]
PAGERDUTY_CREATE_BUSINESS_SERVICE - Create a business service [Optional]
PAGERDUTY_UPDATE_BUSINESS_SERVICE_BY_ID - Update a business service [Optional]
Key parameters:
name: Service name
escalation_policy: Escalation policy object with id and type
alert_creation: Alert creation mode ('create_alerts_and_incidents' or 'create_incidents')
status: Service status ('active', 'warning', 'critical', 'maintenance', 'disabled')
Pitfalls:
- Creating a service requires an existing escalation policy
- Business services are different from technical services; they represent business-level groupings
- Service integrations define how alerts are created (email, API, events)
- Disabling a service stops all incident creation for that service
4. Manage Schedules and On-Call
When to use: User wants to view or manage on-call schedules and rotations
Tool sequence:
PAGERDUTY_GET_SCHEDULES - List all schedules [Required]
PAGERDUTY_RETRIEVE_SCHEDULE_BY_ID - Get specific schedule details [Optional]
PAGERDUTY_CREATE_NEW_SCHEDULE_LAYER - Create a new schedule [Optional]
PAGERDUTY_UPDATE_SCHEDULE_BY_ID - Update an existing schedule [Optional]
PAGERDUTY_RETRIEVE_ONCALL_LIST - View who is currently on-call [Optional]
PAGERDUTY_CREATE_SCHEDULE_OVERRIDES_CONFIGURATION - Create temporary overrides [Optional]
PAGERDUTY_DELETE_SCHEDULE_OVERRIDE_BY_ID - Remove an override [Optional]
PAGERDUTY_RETRIEVE_USERS_BY_SCHEDULE_ID - List users in a schedule [Optional]
PAGERDUTY_PREVIEW_SCHEDULE_OBJECT - Preview schedule changes before saving [Optional]
Key parameters:
schedule_id: Schedule identifier
time_zone: Schedule timezone (e.g., 'America/New_York')
schedule_layers: Array of rotation layer configurations
since/until: Date range for on-call queries (ISO 8601)
override: Override object with user, start, and end times
Pitfalls:
- Schedule layers define rotation order; multiple layers can overlap
- Overrides are temporary and take precedence over the normal schedule
since and until are required for on-call queries to scope the time range
- Time zones must be valid IANA timezone strings
- Preview before saving complex schedule changes to verify correctness
5. Manage Escalation Policies
When to use: User wants to create or modify escalation policies
Tool sequence:
PAGERDUTY_FETCH_ESCALATION_POLICES_LIST - List all escalation policies [Required]
PAGERDUTY_GET_ESCALATION_POLICY_BY_ID - Get policy details [Optional]
PAGERDUTY_CREATE_ESCALATION_POLICY - Create a new policy [Optional]
PAGERDUTY_UPDATE_ESCALATION_POLICY_BY_ID - Update an existing policy [Optional]
PAGERDUTY_AUDIT_ESCALATION_POLICY_RECORDS - View audit trail for a policy [Optional]
Key parameters:
name: Policy name
escalation_rules: Array of escalation rule objects
num_loops: Number of times to loop through rules before stopping (0 = no loop)
escalation_delay_in_minutes: Delay between escalation levels
Pitfalls:
- Each escalation rule requires at least one target (user, schedule, or team)
escalation_delay_in_minutes defines how long before escalating to the next level
- Setting
num_loops to 0 means the policy runs once and stops
- Deleting a policy fails if services still reference it
6. Manage Teams
When to use: User wants to create or manage PagerDuty teams
Tool sequence:
PAGERDUTY_CREATE_NEW_TEAM_WITH_DETAILS - Create a new team [Required]
Key parameters:
name: Team name
description: Team description
Pitfalls:
- Team names must be unique within the account
- Teams are used to scope services, escalation policies, and schedules
Common Patterns
ID Resolution
Service name -> Service ID:
1. Call PAGERDUTY_RETRIEVE_LIST_OF_SERVICES
2. Find service by name in response
3. Extract id field
Schedule name -> Schedule ID:
1. Call PAGERDUTY_GET_SCHEDULES
2. Find schedule by name in response
3. Extract id field
Incident Lifecycle
1. Incident triggered (via API, integration, or manual creation)
2. On-call user notified per escalation policy
3. User acknowledges -> status: 'acknowledged'
4. User resolves -> status: 'resolved'
Pagination
- PagerDuty uses offset-based pagination
- Check response for
more boolean field
- Use
offset and limit parameters
- Continue until
more is false
Known Pitfalls
ID Formats:
- All PagerDuty IDs are alphanumeric strings (e.g., 'P1234AB')
- Service references require
type: 'service_reference'
- User references require
type: 'user_reference'
Status Transitions:
- Incidents: triggered -> acknowledged -> resolved (forward only)
- Services: active, warning, critical, maintenance, disabled
Rate Limits:
- PagerDuty API enforces rate limits per account
- Implement exponential backoff on 429 responses
- Bulk operations should be spaced out
Response Parsing:
- Response data may be nested under
data or data.data
- Parse defensively with fallback patterns
- Pagination uses
offset/limit/more pattern
Quick Reference
| Task |
Tool Slug |
Key Params |
| List incidents |
PAGERDUTY_FETCH_INCIDENT_LIST |
statuses[], service_ids[] |
| Get incident |
PAGERDUTY_RETRIEVE_INCIDENT_BY_INCIDENT_ID |
incident_id |
| Create incident |
PAGERDUTY_CREATE_INCIDENT_RECORD |
title, service |
| Update incident |
PAGERDUTY_UPDATE_INCIDENT_BY_ID |
incident_id, status |
| Add incident note |
PAGERDUTY_POST_INCIDENT_NOTE_USING_ID |
incident_id, content |
| Snooze incident |
PAGERDUTY_SNOOZE_INCIDENT_BY_DURATION |
incident_id, duration |
| Get incident alerts |
PAGERDUTY_GET_ALERTS_BY_INCIDENT_ID |
incident_id |
| Incident analytics |
PAGERDUTY_FETCH_INCIDENT_ANALYTICS_BY_ID |
incident_id |
| List services |
PAGERDUTY_RETRIEVE_LIST_OF_SERVICES |
(none) |
| Get service |
PAGERDUTY_RETRIEVE_SERVICE_BY_ID |
service_id |
| Create service |
PAGERDUTY_CREATE_NEW_SERVICE |
name, escalation_policy |
| Update service |
PAGERDUTY_UPDATE_SERVICE_BY_ID |
service_id |
| List schedules |
PAGERDUTY_GET_SCHEDULES |
(none) |
| Get schedule |
PAGERDUTY_RETRIEVE_SCHEDULE_BY_ID |
schedule_id |
| Get on-call |
PAGERDUTY_RETRIEVE_ONCALL_LIST |
since, until |
| Create schedule override |
PAGERDUTY_CREATE_SCHEDULE_OVERRIDES_CONFIGURATION |
schedule_id |
| List escalation policies |
PAGERDUTY_FETCH_ESCALATION_POLICES_LIST |
(none) |
| Create escalation policy |
PAGERDUTY_CREATE_ESCALATION_POLICY |
name, escalation_rules |
| Create team |
PAGERDUTY_CREATE_NEW_TEAM_WITH_DETAILS |
name, description |
When to Use
This skill is applicable to execute the workflow or actions described in the overview.
1---2name: pagerduty-automation3description: "Automate PagerDuty tasks via Rube MCP (Composio): manage incidents, services, schedules, escalation policies, and on-call rotations. Always search tools first for current schemas."4requires:5 mcp: [rube]6risk: unknown7source: community8metadata:9 source: https://skillmd.com/skills/mayurrathi/pagerduty-automation10---1112# PagerDuty Automation via Rube MCP1314Automate PagerDuty incident management and operations through Composio's PagerDuty toolkit via Rube MCP.1516## Prerequisites1718- Rube MCP must be connected (RUBE_SEARCH_TOOLS available)19- Active PagerDuty connection via `RUBE_MANAGE_CONNECTIONS` with toolkit `pagerduty`20- Always call `RUBE_SEARCH_TOOLS` first to get current tool schemas2122## Setup2324**Get Rube MCP**: Add `https://rube.app/mcp` as an MCP server in your client configuration. No API keys needed — just add the endpoint and it works.2526271. Verify Rube MCP is available by confirming `RUBE_SEARCH_TOOLS` responds282. Call `RUBE_MANAGE_CONNECTIONS` with toolkit `pagerduty`293. If connection is not ACTIVE, follow the returned auth link to complete PagerDuty authentication304. Confirm connection status shows ACTIVE before running any workflows3132## Core Workflows3334### 1. Manage Incidents3536**When to use**: User wants to create, update, acknowledge, or resolve incidents3738**Tool sequence**:391. `PAGERDUTY_FETCH_INCIDENT_LIST` - List incidents with filters [Required]402. `PAGERDUTY_RETRIEVE_INCIDENT_BY_INCIDENT_ID` - Get specific incident details [Optional]413. `PAGERDUTY_CREATE_INCIDENT_RECORD` - Create a new incident [Optional]424. `PAGERDUTY_UPDATE_INCIDENT_BY_ID` - Update incident status or assignment [Optional]435. `PAGERDUTY_POST_INCIDENT_NOTE_USING_ID` - Add a note to an incident [Optional]446. `PAGERDUTY_SNOOZE_INCIDENT_BY_DURATION` - Snooze an incident for a period [Optional]4546**Key parameters**:47- `statuses[]`: Filter by status ('triggered', 'acknowledged', 'resolved')48- `service_ids[]`: Filter by service IDs49- `urgencies[]`: Filter by urgency ('high', 'low')50- `title`: Incident title (for creation)51- `service`: Service object with `id` and `type` (for creation)52- `status`: New status for update operations5354**Pitfalls**:55- Incident creation requires a `service` object with both `id` and `type: 'service_reference'`56- Status transitions follow: triggered -> acknowledged -> resolved57- Cannot transition from resolved back to triggered directly58- `PAGERDUTY_UPDATE_INCIDENT_BY_ID` requires the incident ID as a path parameter59- Snooze duration is in seconds; the incident re-triggers after the snooze period6061### 2. Inspect Incident Alerts and Analytics6263**When to use**: User wants to review alerts within an incident or analyze incident metrics6465**Tool sequence**:661. `PAGERDUTY_GET_ALERTS_BY_INCIDENT_ID` - List alerts for an incident [Required]672. `PAGERDUTY_GET_INCIDENT_ALERT_DETAILS` - Get details of a specific alert [Optional]683. `PAGERDUTY_FETCH_INCIDENT_ANALYTICS_BY_ID` - Get incident analytics/metrics [Optional]6970**Key parameters**:71- `incident_id`: The incident ID72- `alert_id`: Specific alert ID within the incident73- `statuses[]`: Filter alerts by status7475**Pitfalls**:76- An incident can have multiple alerts; each alert has its own status77- Alert IDs are scoped to the incident78- Analytics data includes response times, engagement metrics, and resolution times7980### 3. Manage Services8182**When to use**: User wants to create, update, or list services8384**Tool sequence**:851. `PAGERDUTY_RETRIEVE_LIST_OF_SERVICES` - List all services [Required]862. `PAGERDUTY_RETRIEVE_SERVICE_BY_ID` - Get service details [Optional]873. `PAGERDUTY_CREATE_NEW_SERVICE` - Create a new technical service [Optional]884. `PAGERDUTY_UPDATE_SERVICE_BY_ID` - Update service configuration [Optional]895. `PAGERDUTY_CREATE_INTEGRATION_FOR_SERVICE` - Add an integration to a service [Optional]906. `PAGERDUTY_CREATE_BUSINESS_SERVICE` - Create a business service [Optional]917. `PAGERDUTY_UPDATE_BUSINESS_SERVICE_BY_ID` - Update a business service [Optional]9293**Key parameters**:94- `name`: Service name95- `escalation_policy`: Escalation policy object with `id` and `type`96- `alert_creation`: Alert creation mode ('create_alerts_and_incidents' or 'create_incidents')97- `status`: Service status ('active', 'warning', 'critical', 'maintenance', 'disabled')9899**Pitfalls**:100- Creating a service requires an existing escalation policy101- Business services are different from technical services; they represent business-level groupings102- Service integrations define how alerts are created (email, API, events)103- Disabling a service stops all incident creation for that service104105### 4. Manage Schedules and On-Call106107**When to use**: User wants to view or manage on-call schedules and rotations108109**Tool sequence**:1101. `PAGERDUTY_GET_SCHEDULES` - List all schedules [Required]1112. `PAGERDUTY_RETRIEVE_SCHEDULE_BY_ID` - Get specific schedule details [Optional]1123. `PAGERDUTY_CREATE_NEW_SCHEDULE_LAYER` - Create a new schedule [Optional]1134. `PAGERDUTY_UPDATE_SCHEDULE_BY_ID` - Update an existing schedule [Optional]1145. `PAGERDUTY_RETRIEVE_ONCALL_LIST` - View who is currently on-call [Optional]1156. `PAGERDUTY_CREATE_SCHEDULE_OVERRIDES_CONFIGURATION` - Create temporary overrides [Optional]1167. `PAGERDUTY_DELETE_SCHEDULE_OVERRIDE_BY_ID` - Remove an override [Optional]1178. `PAGERDUTY_RETRIEVE_USERS_BY_SCHEDULE_ID` - List users in a schedule [Optional]1189. `PAGERDUTY_PREVIEW_SCHEDULE_OBJECT` - Preview schedule changes before saving [Optional]119120**Key parameters**:121- `schedule_id`: Schedule identifier122- `time_zone`: Schedule timezone (e.g., 'America/New_York')123- `schedule_layers`: Array of rotation layer configurations124- `since`/`until`: Date range for on-call queries (ISO 8601)125- `override`: Override object with user, start, and end times126127**Pitfalls**:128- Schedule layers define rotation order; multiple layers can overlap129- Overrides are temporary and take precedence over the normal schedule130- `since` and `until` are required for on-call queries to scope the time range131- Time zones must be valid IANA timezone strings132- Preview before saving complex schedule changes to verify correctness133134### 5. Manage Escalation Policies135136**When to use**: User wants to create or modify escalation policies137138**Tool sequence**:1391. `PAGERDUTY_FETCH_ESCALATION_POLICES_LIST` - List all escalation policies [Required]1402. `PAGERDUTY_GET_ESCALATION_POLICY_BY_ID` - Get policy details [Optional]1413. `PAGERDUTY_CREATE_ESCALATION_POLICY` - Create a new policy [Optional]1424. `PAGERDUTY_UPDATE_ESCALATION_POLICY_BY_ID` - Update an existing policy [Optional]1435. `PAGERDUTY_AUDIT_ESCALATION_POLICY_RECORDS` - View audit trail for a policy [Optional]144145**Key parameters**:146- `name`: Policy name147- `escalation_rules`: Array of escalation rule objects148- `num_loops`: Number of times to loop through rules before stopping (0 = no loop)149- `escalation_delay_in_minutes`: Delay between escalation levels150151**Pitfalls**:152- Each escalation rule requires at least one target (user, schedule, or team)153- `escalation_delay_in_minutes` defines how long before escalating to the next level154- Setting `num_loops` to 0 means the policy runs once and stops155- Deleting a policy fails if services still reference it156157### 6. Manage Teams158159**When to use**: User wants to create or manage PagerDuty teams160161**Tool sequence**:1621. `PAGERDUTY_CREATE_NEW_TEAM_WITH_DETAILS` - Create a new team [Required]163164**Key parameters**:165- `name`: Team name166- `description`: Team description167168**Pitfalls**:169- Team names must be unique within the account170- Teams are used to scope services, escalation policies, and schedules171172## Common Patterns173174### ID Resolution175176**Service name -> Service ID**:177```1781. Call PAGERDUTY_RETRIEVE_LIST_OF_SERVICES1792. Find service by name in response1803. Extract id field181```182183**Schedule name -> Schedule ID**:184```1851. Call PAGERDUTY_GET_SCHEDULES1862. Find schedule by name in response1873. Extract id field188```189190### Incident Lifecycle191192```1931. Incident triggered (via API, integration, or manual creation)1942. On-call user notified per escalation policy1953. User acknowledges -> status: 'acknowledged'1964. User resolves -> status: 'resolved'197```198199### Pagination200201- PagerDuty uses offset-based pagination202- Check response for `more` boolean field203- Use `offset` and `limit` parameters204- Continue until `more` is false205206## Known Pitfalls207208**ID Formats**:209- All PagerDuty IDs are alphanumeric strings (e.g., 'P1234AB')210- Service references require `type: 'service_reference'`211- User references require `type: 'user_reference'`212213**Status Transitions**:214- Incidents: triggered -> acknowledged -> resolved (forward only)215- Services: active, warning, critical, maintenance, disabled216217**Rate Limits**:218- PagerDuty API enforces rate limits per account219- Implement exponential backoff on 429 responses220- Bulk operations should be spaced out221222**Response Parsing**:223- Response data may be nested under `data` or `data.data`224- Parse defensively with fallback patterns225- Pagination uses `offset`/`limit`/`more` pattern226227## Quick Reference228229| Task | Tool Slug | Key Params |230|------|-----------|------------|231| List incidents | PAGERDUTY_FETCH_INCIDENT_LIST | statuses[], service_ids[] |232| Get incident | PAGERDUTY_RETRIEVE_INCIDENT_BY_INCIDENT_ID | incident_id |233| Create incident | PAGERDUTY_CREATE_INCIDENT_RECORD | title, service |234| Update incident | PAGERDUTY_UPDATE_INCIDENT_BY_ID | incident_id, status |235| Add incident note | PAGERDUTY_POST_INCIDENT_NOTE_USING_ID | incident_id, content |236| Snooze incident | PAGERDUTY_SNOOZE_INCIDENT_BY_DURATION | incident_id, duration |237| Get incident alerts | PAGERDUTY_GET_ALERTS_BY_INCIDENT_ID | incident_id |238| Incident analytics | PAGERDUTY_FETCH_INCIDENT_ANALYTICS_BY_ID | incident_id |239| List services | PAGERDUTY_RETRIEVE_LIST_OF_SERVICES | (none) |240| Get service | PAGERDUTY_RETRIEVE_SERVICE_BY_ID | service_id |241| Create service | PAGERDUTY_CREATE_NEW_SERVICE | name, escalation_policy |242| Update service | PAGERDUTY_UPDATE_SERVICE_BY_ID | service_id |243| List schedules | PAGERDUTY_GET_SCHEDULES | (none) |244| Get schedule | PAGERDUTY_RETRIEVE_SCHEDULE_BY_ID | schedule_id |245| Get on-call | PAGERDUTY_RETRIEVE_ONCALL_LIST | since, until |246| Create schedule override | PAGERDUTY_CREATE_SCHEDULE_OVERRIDES_CONFIGURATION | schedule_id |247| List escalation policies | PAGERDUTY_FETCH_ESCALATION_POLICES_LIST | (none) |248| Create escalation policy | PAGERDUTY_CREATE_ESCALATION_POLICY | name, escalation_rules |249| Create team | PAGERDUTY_CREATE_NEW_TEAM_WITH_DETAILS | name, description |250251## When to Use252This skill is applicable to execute the workflow or actions described in the overview.