io.github.PagerDuty/pagerduty-mcp
PagerDuty's official MCP server which provides tools to interact with your PagerDuty account.
Install
Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).
pagerduty-mcpclaude mcp add pagerduty-mcp -e 'PAGERDUTY_USER_API_KEY=<PAGERDUTY_USER_API_KEY>' -e 'PAGERDUTY_API_HOST=<PAGERDUTY_API_HOST>' -- uvx pagerduty-mcp==0.2.1 --enable-write-tools
{
"mcpServers": {
"pagerduty-mcp": {
"command": "uvx",
"args": [
"pagerduty-mcp==0.2.1",
"--enable-write-tools"
],
"env": {
"PAGERDUTY_USER_API_KEY": "<PAGERDUTY_USER_API_KEY>",
"PAGERDUTY_API_HOST": "<PAGERDUTY_API_HOST>"
}
}
}
}
Environment variables
PAGERDUTY_USER_API_KEYPagerDuty User API Token - obtain from User Settings > API Access in your PagerDuty accountPAGERDUTY_API_HOSTPagerDuty API host URL (default: https://api.pagerduty.com, EU: https://api.eu.pagerduty.com)
Documentation
From the project's README on GitHub, refreshed weekly. Links open on GitHub.
PagerDuty's official MCP Server
[!IMPORTANT] This repository is deprecated and now read-only. Development has moved to PagerDuty's hosted Remote MCP Server — see the docs there for setup instructions.
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.
Quick start
You need uv and a PagerDuty User API Token — see
Prerequisites and Authentication.
PAGERDUTY_USER_API_KEY="your-token" uvx pagerduty-mcp
By default only read-only tools are exposed. Add --enable-write-tools to allow tools that modify
your PagerDuty account. Then point your MCP client at the server —
Cursor, VS Code,
Claude Desktop, or Docker.
Prefer no local install? PagerDuty hosts a Remote MCP Server with OAuth support.
Contents
The full documentation lives in docs/ and is readable directly on GitHub.
Getting Started
- Introduction — what the MCP server is and what it can do
- Prerequisites
- Quick Start
- Authentication
Installation
Remote Server
- Remote MCP Server Setup — PagerDuty-hosted, no local install. Maintained on the PagerDuty Knowledge Base.
Configuration
Tools Reference
- Tools Overview — every tool, read/write type, and description
- Alert Grouping
- Alerts
- Analytics
- Business Services
- Change Events
- Incidents
- Incident Workflows
- Services
- Teams
- Users
- Schedules
- On-Call
- Priorities
- Log Entries
- Escalation Policies
- Event Orchestrations
- Status Pages
Use Cases
- Use Cases Overview
- Incident Investigation
- On-Call Handoff
- Service Health Check
- Incident Response Automation
Experimental
- Experimental Overview — MCP Apps and the
experimentalbranch - Incident Command Center
- On-Call Manager
- On-Call Compensation Report
- Service Dependency Graph
- Onboarding Wizard
Community
Contributing
Support
PagerDuty's MCP server is an open-source project, and as such, we offer only community-based support. If assistance is required, please open an issue in GitHub or PagerDuty's community forum.
Contributing
If you are interested in contributing to this project, please refer to our Contributing Guidelines and the development setup guide.
Frequently asked questions
What is io.github.PagerDuty/pagerduty-mcp?
PagerDuty's official MCP server which provides tools to interact with your PagerDuty account.
How do I install io.github.PagerDuty/pagerduty-mcp?
It runs on your machine. In Claude Code: claude mcp add pagerduty-mcp -e 'PAGERDUTY_USER_API_KEY=<PAGERDUTY_USER_API_KEY>' -e 'PAGERDUTY_API_HOST=<PAGERDUTY_API_HOST>' -- uvx pagerduty-mcp==0.2.1 --enable-write-tools. For other clients, paste the JSON configuration from this page into their MCP settings.
Does io.github.PagerDuty/pagerduty-mcp need an API key?
Its registry entry lists no required key or secret. Some features may still need an account with the service it connects to.
Is io.github.PagerDuty/pagerduty-mcp open source?
Yes. Its code is on GitHub under the Apache-2.0 license.
Who maintains io.github.PagerDuty/pagerduty-mcp?
It is published by PagerDuty. AI.tn lists it but does not maintain or endorse it.
From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.