Tools Reference

PagerDuty MCP provides 10 tools — 6 read tools and 4 write tools.

Incidents

Monitor and inspect incident activity.

Tool	Parameters	Description
list_incidents	status?: "triggered" | "acknowledged" | "resolved", limit?: number (default: 25, max: 100)	Lists incidents with summary, status, urgency, service, and assignments. Optionally filter by status.
get_incident	incident_id: string	Retrieves full details for a specific incident including title, status, urgency, service, escalation policy, assignments, acknowledgements, and timestamps.

Example prompts:

• "Are there any triggered incidents right now?"
• "Show me the details of incident PABC123."
• "List all resolved incidents."
• "How many acknowledged incidents do we have?"

---

Services

Discover and inspect PagerDuty service configurations.

Tool	Parameters	Description
list_services	limit?: number (default: 25, max: 100)	Lists services with name, status, escalation policy, and alert grouping settings.
get_service	service_id: string	Retrieves full details for a specific service including status, description, escalation policy, integrations, and alert creation settings.

Example prompts:

• "List all our PagerDuty services and their status."
• "What escalation policy is configured for service PSVC123?"
• "Show me all services that are currently active."

---

On-Call

Check who is on-call and view schedule configurations.

Tool	Parameters	Description
list_oncalls	schedule_ids?: string[], limit?: number (default: 25, max: 100)	Lists who is currently on-call with user, escalation policy, escalation level, schedule, and time window. Optionally filter by schedule IDs.
get_schedule	schedule_id: string	Retrieves a specific on-call schedule including rotation details, current on-call user, overrides, and the rendered schedule.

Example prompts:

• "Who is currently on-call?"
• "Who is on-call for schedule PSCH123?"
• "Show me the full rotation details for the primary on-call schedule."
• "List all on-call entries and their escalation levels."

---

Write Operations

caution

Write tools modify incident state in your PagerDuty account. Use with care.

Incident Management

Tool	Parameters	Description
acknowledge_incident	incident_id: string, from_email?: string	Acknowledges a triggered incident. The from_email should match a PagerDuty user.
resolve_incident	incident_id: string, from_email?: string	Resolves an incident.
reassign_incident	incident_id: string, user_ids: string[], from_email?: string	Reassigns an incident to one or more users.
add_incident_note	incident_id: string, content: string, from_email?: string	Adds a note to an incident timeline for context and documentation.

Example prompts:

• "Acknowledge incident PABC123."
• "Resolve incident PXYZ789 — the fix has been deployed."
• "Reassign incident P111 to users PUSER1 and PUSER2."
• "Add a note to incident PABC123: 'Root cause was a misconfigured DNS record'."