PagerDuty's official MCP Server

PagerDuty's local MCP (Model Context Protocol) server which provides tools to interact with your PagerDuty account, allowing you to manage incidents, services, schedules, event orchestrations, and more directly from your MCP-enabled client.

Prerequisites

• asdf-vm installed.

• uv installed globally.

• A PagerDuty User API Token. To obtain a PagerDuty User API Token, follow these steps:

  1. Navigate to User Settings. Click on your user profile icon, then select My Profile and then User Settings.

     For Freemium accounts, the permissions for generating User API tokens are limited to the user role as defined here.

  2. In your user settings, locate the API Access section.
  3. Click the Create API User Token button and follow the prompts to generate a new token.
  4. Copy the generated token and store it securely. You will need this token to configure the MCP server.

  Use of the PagerDuty User API Token is subject to the PagerDuty Developer Agreement.

Using with MCP Clients

Cursor Integration

You can configure this MCP server directly within Cursor's settings.json file, by following these steps:

1. Open Cursor settings (Cursor Settings > Tools > Add MCP, or Cmd+, on Mac, or Ctrl+, on Windows/Linux).

2. Add the following configuration:

   {
     "mcpServers": {
       "pagerduty-mcp": {
         "type": "stdio",
         "command": "uvx",
         "args": [
           "pagerduty-mcp",
           "--enable-write-tools"
           // This flag enables write operations on the MCP Server enabling you to creating incidents, schedule overrides and much more
         ],
         "env": {
           "PAGERDUTY_USER_API_KEY": "${input:pagerduty-api-key}"
         }
       }
     }
   }
   

VS Code Integration

You can configure this MCP server directly within Visual Studio Code's settings.json file, allowing VS Code to manage the server lifecycle.

1. Open VS Code settings (File > Preferences > Settings, or Cmd+, on Mac, or Ctrl+, on Windows/Linux).

2. Search for "mcp" and ensure "Mcp: Enabled" is checked under Features > Chat.

3. Click "Edit in settings.json" under "Mcp > Discovery: Servers".

4. Add the following configuration:

   {
       "mcp": {
           "inputs": [
               {
                   "type": "promptString",
                   "id": "pagerduty-api-key",
                   "description": "PagerDuty API Key",
                   "password": true
               }
           ],
           "servers": {
               "pagerduty-mcp": { 
                   "type": "stdio",
                   "command": "uvx",
                   "args": [
                       "pagerduty-mcp",
                       "--enable-write-tools"
                       // This flag enables write operations on the MCP Server enabling you to creating incidents, schedule overrides and much more
                   ],
                   "env": {
                       "PAGERDUTY_USER_API_KEY": "${input:pagerduty-api-key}",
                       "PAGERDUTY_API_HOST": "https://api.pagerduty.com"
                       // If your PagerDuty account is located in EU update your API host to https://api.eu.pagerduty.com
                   }
               }
           }
       }
   }
   

Trying it in VS Code Chat (Agent)

1. Ensure MCP is enabled in VS Code settings (Features > Chat > "Mcp: Enabled").
2. Configure the server as described above.
3. Open the Chat view in VS Code (View > Chat).
4. Make sure Agent mode is selected. In the Chat view, you can enable or disable specific tools by clicking

... View full README on GitHub