# PagerDuty

import ToolInfo from "@/app/_components/tool-info";
import Badges from "@/app/_components/badges";
import TabbedCodeBlock from "@/app/_components/tabbed-code-block";
import TableOfContents from "@/app/_components/table-of-contents";
import ToolFooter from "@/app/_components/tool-footer";
import { Callout } from "nextra/components";

<ToolInfo
  description="Enable agents to read incidents, on-call info, services, and teams in PagerDuty"
  author="Arcade"
  authType="OAuth2"
  versions={["1.0.0"]}
/>

<Badges repo="arcadeai/arcade_pagerduty" />

The PagerDuty MCP Server lets agents list and inspect incidents, on-calls, services, teams, users, schedules, log entries, and escalation policies. Follows the Linear-style docs with code snippets in Python and JavaScript.

<Callout type="warning" title="Classic PagerDuty OAuth">
  Arcade supports Classic PagerDuty apps. Select **read-only** access; all tools
  in this MCP Server only read data. (Use read/write only if you add custom
  write tools.) See [PagerDuty OAuth
  functionality](https://developer.pagerduty.com/docs/oauth-functionality).
</Callout>

<Callout type="info">
  Configure PagerDuty OAuth in the [PagerDuty auth
  provider](/references/auth-providers/pagerduty) before using these tools.
</Callout>

## Available tools

<TableOfContents
  headers={["Tool Name", "Description"]}
  data={[
    [
      "PagerDuty.WhoAmI",
      "Get the authenticated user's profile + on-call status",
    ],
    ["PagerDuty.ListIncidents", "List incidents with filters"],
    ["PagerDuty.GetIncident", "Get a single incident by ID"],
    ["PagerDuty.ListLogEntries", "List account log entries (activity feed)"],
    ["PagerDuty.ListEscalationPolicies", "List escalation policies"],
    ["PagerDuty.GetEscalationPolicy", "Get an escalation policy by ID"],
    ["PagerDuty.ListServices", "List services with optional name search"],
    ["PagerDuty.GetService", "Get a service by ID"],
    ["PagerDuty.ListSchedules", "List schedules with on-call data"],
    ["PagerDuty.ListOnCalls", "List on-call entries with filters"],
    ["PagerDuty.ListUsers", "List users"],
    ["PagerDuty.SearchUsers", "Search users by name/email (fuzzy)"],
    ["PagerDuty.ListTeams", "List teams"],
    ["PagerDuty.GetTeam", "Get a team by ID"],
  ]}
/>

<Callout>
  If you need a tool that's not listed, [contact us](mailto:contact@arcade.dev)
  or [build your own](/guides/create-tools/tool-basics/build-mcp-server).
</Callout>

<Callout type="info" title="MCP behavior hints">
  - `readOnlyHint` — reads data only - `openWorldHint` — calls PagerDuty's
  external API - `destructiveHint` — none of these tools delete data -
  `idempotentHint` — repeating the same read call returns the same data
</Callout>

---

## User context

### PagerDuty.WhoAmI

Get the authenticated user's profile plus current on-call info.

<Callout type="info" title="MCP behavior hints">
  - `readOnlyHint: true` — reads data only - `openWorldHint: true` — calls
  PagerDuty’s external API - `destructiveHint: false` — no destructive
  operations - `idempotentHint: true` — same request returns same data
</Callout>

<TabbedCodeBlock
  tabs={[
    {
      label: "Call the tool directly",
      content: {
        Python: [
          "/examples/integrations/resources/integrations/pagerduty/whoami_example_call_tool.py",
        ],
        JavaScript: [
          "/examples/integrations/resources/integrations/pagerduty/whoami_example_call_tool.js",
        ],
      },
    },
  ]}
/>

**Parameters**
None.

**API calls:** GET `/users/me`, GET `/oncalls`

---

## Incident tools

### PagerDuty.ListIncidents

List incidents with filters (status, urgency, services, teams, time window).

<Callout type="info" title="MCP behavior hints">
  - `readOnlyHint: true` — reads data only - `openWorldHint: true` — calls
  PagerDuty’s external API - `destructiveHint: false` — no destructive
  operations - `idempotentHint: true` — same request returns same data
</Callout>

<TabbedCodeBlock
  tabs={[
    {
      label: "Call the tool directly",
      content: {
        Python: [
          "/examples/integrations/resources/integrations/pagerduty/list_incidents_example_call_tool.py",
        ],
        JavaScript: [
          "/examples/integrations/resources/integrations/pagerduty/list_incidents_example_call_tool.js",
        ],
      },
    },
  ]}
/>

**Parameters**

- **status** (`enum`, _optional_) Filter by status.
- **urgency** (`enum`, _optional_) Filter by urgency.
- **service_ids** (`array`, _optional_) Filter by service IDs.
- **team_ids** (`array`, _optional_) Filter by team IDs.
- **since** / **until** (`string`, _optional_) ISO-8601 time range.
- **limit** (`integer`, _optional_) 1-50, default 10.
- **offset** (`integer`, _optional_) Pagination offset.

**API calls:** GET `/incidents`

---

### PagerDuty.GetIncident

Get a single incident by ID.

<Callout type="info" title="MCP behavior hints">
  - `readOnlyHint: true` — reads data only - `openWorldHint: true` — calls
  PagerDuty’s external API - `destructiveHint: false` — no destructive
  operations - `idempotentHint: true` — same request returns same data
</Callout>

<TabbedCodeBlock
  tabs={[
    {
      label: "Call the tool directly",
      content: {
        Python: [
          "/examples/integrations/resources/integrations/pagerduty/get_incident_example_call_tool.py",
        ],
        JavaScript: [
          "/examples/integrations/resources/integrations/pagerduty/get_incident_example_call_tool.js",
        ],
      },
    },
  ]}
/>

**Parameters**

- **incident_id** (`string`, **required**) Incident ID.

**API calls:** GET `/incidents/{id}`

---

### PagerDuty.ListLogEntries

List account log entries (activity feed).

<Callout type="info" title="MCP behavior hints">
  - `readOnlyHint: true` — reads data only - `openWorldHint: true` — calls
  PagerDuty’s external API - `destructiveHint: false` — no destructive
  operations - `idempotentHint: true` — same request returns same data
</Callout>

<TabbedCodeBlock
  tabs={[
    {
      label: "Call the tool directly",
      content: {
        Python: [
          "/examples/integrations/resources/integrations/pagerduty/list_log_entries_example_call_tool.py",
        ],
        JavaScript: [
          "/examples/integrations/resources/integrations/pagerduty/list_log_entries_example_call_tool.js",
        ],
      },
    },
  ]}
/>

**Parameters**

- **since** / **until** (`string`, _optional_) ISO-8601 time range.
- **team_ids** (`array`, _optional_) Filter by team IDs.
- **time_zone** (`string`, _optional_) IANA time zone.
- **is_overview** (`boolean`, _optional_) Compact mode. Default: `true`.
- **limit** (`integer`, _optional_) 1-50. Default: 10.
- **offset** (`integer`, _optional_) Pagination offset.

**API calls:** GET `/log_entries`

---

## Escalation policy tools

### PagerDuty.ListEscalationPolicies

List escalation policies.

<Callout type="info" title="MCP behavior hints">
  - `readOnlyHint: true` — reads data only - `openWorldHint: true` — calls
  PagerDuty’s external API - `destructiveHint: false` — no destructive
  operations - `idempotentHint: true` — same request returns same data
</Callout>

<TabbedCodeBlock
  tabs={[
    {
      label: "Call the tool directly",
      content: {
        Python: [
          "/examples/integrations/resources/integrations/pagerduty/list_escalation_policies_example_call_tool.py",
        ],
        JavaScript: [
          "/examples/integrations/resources/integrations/pagerduty/list_escalation_policies_example_call_tool.js",
        ],
      },
    },
  ]}
/>

**Parameters**

- **limit** (`integer`, _optional_) 1-50. Default: 10.
- **offset** (`integer`, _optional_) Pagination offset.

**API calls:** GET `/escalation_policies`

---

### PagerDuty.GetEscalationPolicy

Get escalation policy details.

<Callout type="info" title="MCP behavior hints">
  - `readOnlyHint: true` — reads data only - `openWorldHint: true` — calls
  PagerDuty’s external API - `destructiveHint: false` — no destructive
  operations - `idempotentHint: true` — same request returns same data
</Callout>

<TabbedCodeBlock
  tabs={[
    {
      label: "Call the tool directly",
      content: {
        Python: [
          "/examples/integrations/resources/integrations/pagerduty/get_escalation_policy_example_call_tool.py",
        ],
        JavaScript: [
          "/examples/integrations/resources/integrations/pagerduty/get_escalation_policy_example_call_tool.js",
        ],
      },
    },
  ]}
/>

**Parameters**

- **escalation_policy_id** (`string`, **required**) Escalation policy ID.

**API calls:** GET `/escalation_policies/{id}`

---

## Service tools

### PagerDuty.ListServices

List services (optional name search).

<Callout type="info" title="MCP behavior hints">
  - `readOnlyHint: true` — reads data only - `openWorldHint: true` — calls
  PagerDuty’s external API - `destructiveHint: false` — no destructive
  operations - `idempotentHint: true` — same request returns same data
</Callout>

<TabbedCodeBlock
  tabs={[
    {
      label: "Call the tool directly",
      content: {
        Python: [
          "/examples/integrations/resources/integrations/pagerduty/list_services_example_call_tool.py",
        ],
        JavaScript: [
          "/examples/integrations/resources/integrations/pagerduty/list_services_example_call_tool.js",
        ],
      },
    },
  ]}
/>

**Parameters**

- **query** (`string`, _optional_) Search by name.
- **limit** (`integer`, _optional_) 1-50. Default: 10.
- **offset** (`integer`, _optional_) Pagination offset.

**API calls:** GET `/services`

---

### PagerDuty.GetService

Get service details.

<Callout type="info" title="MCP behavior hints">
  - `readOnlyHint: true` — reads data only - `openWorldHint: true` — calls
  PagerDuty’s external API - `destructiveHint: false` — no destructive
  operations - `idempotentHint: true` — same request returns same data
</Callout>

<TabbedCodeBlock
  tabs={[
    {
      label: "Call the tool directly",
      content: {
        Python: [
          "/examples/integrations/resources/integrations/pagerduty/get_service_example_call_tool.py",
        ],
        JavaScript: [
          "/examples/integrations/resources/integrations/pagerduty/get_service_example_call_tool.js",
        ],
      },
    },
  ]}
/>

**Parameters**

- **service_id** (`string`, **required**) Service ID.

**API calls:** GET `/services/{id}`

---

## Schedule tools

### PagerDuty.ListSchedules

List schedules with optional time zone and pagination.

<Callout type="info" title="MCP behavior hints">
  - `readOnlyHint: true` — reads data only - `openWorldHint: true` — calls
  PagerDuty’s external API - `destructiveHint: false` — no destructive
  operations - `idempotentHint: true` — same request returns same data
</Callout>

<TabbedCodeBlock
  tabs={[
    {
      label: "Call the tool directly",
      content: {
        Python: [
          "/examples/integrations/resources/integrations/pagerduty/list_schedules_example_call_tool.py",
        ],
        JavaScript: [
          "/examples/integrations/resources/integrations/pagerduty/list_schedules_example_call_tool.js",
        ],
      },
    },
  ]}
/>

**Parameters**

- **limit** (`integer`, _optional_) 1-50. Default: 10.
- **offset** (`integer`, _optional_) Pagination offset.
- **time_zone** (`string`, _optional_) IANA time zone.

**API calls:** GET `/schedules`

---

## On-call tools

### PagerDuty.ListOnCalls

List on-call entries with filters (schedule, escalation policy, team, time).

<Callout type="info" title="MCP behavior hints">
  - `readOnlyHint: true` — reads data only - `openWorldHint: true` — calls
  PagerDuty’s external API - `destructiveHint: false` — no destructive
  operations - `idempotentHint: true` — same request returns same data
</Callout>

<TabbedCodeBlock
  tabs={[
    {
      label: "Call the tool directly",
      content: {
        Python: [
          "/examples/integrations/resources/integrations/pagerduty/list_oncalls_example_call_tool.py",
        ],
        JavaScript: [
          "/examples/integrations/resources/integrations/pagerduty/list_oncalls_example_call_tool.js",
        ],
      },
    },
  ]}
/>

**Parameters**

- **schedule_ids** (`array`, _optional_) Filter by schedules.
- **escalation_policy_ids** (`array`, _optional_) Filter by escalation policies.
- **team_ids** (`array`, _optional_) Filter by teams.
- **time_zone** (`string`, _optional_) IANA time zone.
- **since** / **until** (`string`, _optional_) ISO times.
- **limit** (`integer`, _optional_) 1-50. Default: 10.
- **offset** (`integer`, _optional_) Pagination offset.

**API calls:** GET `/oncalls`

---

## User tools

### PagerDuty.ListUsers

List users with pagination.

<Callout type="info" title="MCP behavior hints">
  - `readOnlyHint: true` — reads data only - `openWorldHint: true` — calls
  PagerDuty’s external API - `destructiveHint: false` — no destructive
  operations - `idempotentHint: true` — same request returns same data
</Callout>

<TabbedCodeBlock
  tabs={[
    {
      label: "Call the tool directly",
      content: {
        Python: [
          "/examples/integrations/resources/integrations/pagerduty/list_users_example_call_tool.py",
        ],
        JavaScript: [
          "/examples/integrations/resources/integrations/pagerduty/list_users_example_call_tool.js",
        ],
      },
    },
  ]}
/>

**Parameters**

- **limit** (`integer`, _optional_) 1-50. Default: 10.
- **offset** (`integer`, _optional_) Pagination offset.

**API calls:** GET `/users`

---

### PagerDuty.SearchUsers

Search users by name/email (fuzzy).

<Callout type="info" title="MCP behavior hints">
  - `readOnlyHint: true` — reads data only - `openWorldHint: true` — calls
  PagerDuty’s external API - `destructiveHint: false` — no destructive
  operations - `idempotentHint: true` — same request returns same data
</Callout>

<TabbedCodeBlock
  tabs={[
    {
      label: "Call the tool directly",
      content: {
        Python: [
          "/examples/integrations/resources/integrations/pagerduty/search_users_example_call_tool.py",
        ],
        JavaScript: [
          "/examples/integrations/resources/integrations/pagerduty/search_users_example_call_tool.js",
        ],
      },
    },
  ]}
/>

**Parameters**

- **query** (`string`, **required**) Name or email fragment.
- **auto_accept_matches** (`boolean`, _optional_) Auto-accept above confidence threshold. Default: `false`.

**API calls:** GET `/users` (fuzzy match locally)

---

## Team tools

### PagerDuty.ListTeams

List teams with pagination.

<Callout type="info" title="MCP behavior hints">
  - `readOnlyHint: true` — reads data only - `openWorldHint: true` — calls
  PagerDuty’s external API - `destructiveHint: false` — no destructive
  operations - `idempotentHint: true` — same request returns same data
</Callout>

<TabbedCodeBlock
  tabs={[
    {
      label: "Call the tool directly",
      content: {
        Python: [
          "/examples/integrations/resources/integrations/pagerduty/list_teams_example_call_tool.py",
        ],
        JavaScript: [
          "/examples/integrations/resources/integrations/pagerduty/list_teams_example_call_tool.js",
        ],
      },
    },
  ]}
/>

**Parameters**

- **limit** (`integer`, _optional_) 1-50. Default: 10.
- **offset** (`integer`, _optional_) Pagination offset.

**API calls:** GET `/teams`

---

### PagerDuty.GetTeam

Get team details (members, linked services/policies).

<Callout type="info" title="MCP behavior hints">
  - `readOnlyHint: true` — reads data only - `openWorldHint: true` — calls
  PagerDuty’s external API - `destructiveHint: false` — no destructive
  operations - `idempotentHint: true` — same request returns same data
</Callout>

<TabbedCodeBlock
  tabs={[
    {
      label: "Call the tool directly",
      content: {
        Python: [
          "/examples/integrations/resources/integrations/pagerduty/get_team_example_call_tool.py",
        ],
        JavaScript: [
          "/examples/integrations/resources/integrations/pagerduty/get_team_example_call_tool.js",
        ],
      },
    },
  ]}
/>

**Parameters**

- **team_id** (`string`, **required**) Team ID.

**API calls:** GET `/teams/{id}`

---

## Auth

PagerDuty requires OAuth2. Configure the PagerDuty auth provider and request the scopes shown above per tool. Tokens are passed as Bearer auth:

```
Authorization: Bearer <token>
```

See PagerDuty auth docs: [PagerDuty API Authentication](https://developer.pagerduty.com/docs/ZG9jOjExMDI5NTYz-authentication).

<ToolFooter pipPackageName="arcade_pagerduty" />