PagerDuty
PagerDuty's official local MCP (Model Context Protocol) server which provides tools to interact with your PagerDuty account directly from your MCP-enabled client.
What is PagerDuty?
PagerDuty is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to pagerduty's official local mcp (model context protocol) server which provides tools to interact with your pagerduty account directly from your mcp-enabled client.
PagerDuty's official local MCP (Model Context Protocol) server which provides tools to interact with your PagerDuty account directly from your MCP-enabled client.
This server falls under the Monitoring & Observability category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- PagerDuty's official local MCP (Model Context Protocol) serv
Use Cases
Maintainer
Works with
Installation
NPM
npx -y pagerduty_mcp_serverPIP
pip install pagerduty-mcpManual Installation
npx -y pagerduty_mcp_serverConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use PagerDuty
PagerDuty's official MCP server connects AI assistants directly to your PagerDuty account, exposing 60+ tools for incident management, on-call scheduling, service configuration, team management, event orchestration, and status page updates — all accessible through natural language. It ships in read-only mode by default (safe for investigation workflows) and enables write operations explicitly via the `--enable-write-tools` flag. Platform engineers, SREs, and on-call teams can use it to triage incidents, check coverage, manage escalations, and automate routine PagerDuty operations without leaving their AI assistant.
Prerequisites
- Python 3.10+ and the uv package manager (for uvx execution)
- asdf-vm for managing runtime versions (recommended for local development)
- A PagerDuty User API Token generated from User Settings > API Access in your PagerDuty account
- An MCP-compatible client such as Claude Desktop, VS Code, or Cursor
- Optional: access to a PagerDuty EU account requires setting the PAGERDUTY_API_HOST variable
Generate a PagerDuty API token
Log into PagerDuty, go to User Settings > API Access Keys, and create a new User API Key. Copy the key — you will use it as the PAGERDUTY_USER_API_KEY environment variable.
Install uv (if not already installed)
The PagerDuty MCP server is run via uvx, which requires the uv package manager. Install it using the official installer.
curl -LsSf https://astral.sh/uv/install.sh | shConfigure your MCP client (read-only mode)
Add the PagerDuty server to your MCP client configuration. By default, only read-only tools are exposed. This is the recommended starting configuration for safe incident investigation.
{
"mcpServers": {
"pagerduty": {
"command": "uvx",
"args": ["pagerduty-mcp"],
"env": {
"PAGERDUTY_USER_API_KEY": "your_user_api_key_here"
}
}
}
}Enable write tools for incident management
To allow the AI to create, acknowledge, resolve, and escalate incidents — as well as manage schedules and services — pass the --enable-write-tools flag in the args array.
{
"mcpServers": {
"pagerduty": {
"command": "uvx",
"args": ["pagerduty-mcp", "--enable-write-tools"],
"env": {
"PAGERDUTY_USER_API_KEY": "your_user_api_key_here"
}
}
}
}For EU PagerDuty accounts, set the API host
If your PagerDuty account uses the EU data region, add PAGERDUTY_API_HOST to point to the EU endpoint.
{
"mcpServers": {
"pagerduty": {
"command": "uvx",
"args": ["pagerduty-mcp", "--enable-write-tools"],
"env": {
"PAGERDUTY_USER_API_KEY": "your_user_api_key_here",
"PAGERDUTY_API_HOST": "https://api.eu.pagerduty.com"
}
}
}
}Restart your client and test the connection
Restart your MCP client after saving the configuration. Ask Claude to list open incidents to verify the connection is working.
PagerDuty Examples
Client configuration
Claude Desktop configuration with write tools enabled for full incident management capabilities.
{
"mcpServers": {
"pagerduty": {
"command": "uvx",
"args": ["pagerduty-mcp", "--enable-write-tools"],
"env": {
"PAGERDUTY_USER_API_KEY": "your_user_api_key_here"
}
}
}
}Prompts to try
Use Claude to interact with PagerDuty incidents, schedules, and services through natural language.
- "List all open P1 and P2 incidents and show their current assignees"
- "Who is on call right now for the Payments service?"
- "Acknowledge incident INC-1234 and add a note saying I'm investigating"
- "Create a schedule override for the Database team this Saturday from 9am to 5pm"
- "Show me the incident command center"
- "List all services with no recent activity in the past 7 days"Troubleshooting PagerDuty
Authentication error: 401 Unauthorized
The PAGERDUTY_USER_API_KEY must be a User API Key (not an Integration API key or REST API key). Generate it from User Settings > API Access Keys in PagerDuty. Service-level keys will not work for all tools.
Write operations fail even after adding --enable-write-tools
Confirm the flag is in the `args` array (e.g., `["pagerduty-mcp", "--enable-write-tools"]`), not in the `env` block. Also verify your API key has sufficient permissions in PagerDuty — some write operations require Account Admin or Manager role.
uvx command not found when the MCP client starts the server
The MCP client subprocess may not have uv in its PATH even if you installed it in your shell. Add the full path to uvx in the `command` field (e.g., `/Users/yourname/.local/bin/uvx`) or install uv system-wide.
Frequently Asked Questions about PagerDuty
What is PagerDuty?
PagerDuty is a Model Context Protocol (MCP) server that pagerduty's official local mcp (model context protocol) server which provides tools to interact with your pagerduty account directly from your mcp-enabled client. It connects AI assistants to external tools and data sources through a standardized interface.
How do I install PagerDuty?
Install via npm with the command: npx -y pagerduty_mcp_server. Then add the server configuration to your AI client's JSON config file (e.g., claude_desktop_config.json or .cursor/mcp.json).
Which AI clients work with PagerDuty?
PagerDuty works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is PagerDuty free to use?
Yes, PagerDuty is open source and available under the Apache-2.0 license. You can use it freely in both personal and commercial projects.
PagerDuty Alternatives — Similar Monitoring & Observability Servers
Looking for alternatives to PagerDuty? Here are other popular monitoring & observability servers you can use with Claude, Cursor, and VS Code.
Netdata
★ 78.9kReal-time infrastructure monitoring with metrics, logs, alerts, and ML-based anomaly detection.
Kubeshark
★ 11.9keBPF-powered network observability for Kubernetes. Indexes L4/L7 traffic with full K8s context, decrypts TLS without keys. Queryable by AI agents via MCP and humans via dashboard.
Mission Control
★ 4.9kSelf-hosted AI agent orchestration platform: dispatch tasks, run multi-agent workflows, monitor spend, and govern operations from one mission control dashboard.
Grafana
★ 3.0kThis MCP server enables natural-language querying of Grafana logs by automatically detecting log sources and service labels. It provides read-only access to log data with intelligent caching for efficient repeat queries.
Sentrux
★ 2.4kReal-time architectural sensor that helps AI agents close the feedback loop, enabling recursive self-improvement of code quality. Pure Rust.
OpenInference
★ 986OpenTelemetry Instrumentation for AI Observability
Browse More Monitoring & Observability MCP Servers
Explore all monitoring & observability servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up PagerDuty in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use PagerDuty?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.