Skip to main content
Glama
wpfleger96

PagerDuty MCP Server

by wpfleger96

get_incidents

Retrieve PagerDuty incidents by filters like status, service, team, or date range. Get details for a specific incident by ID or number.

Instructions

Get PagerDuty incidents by filters or get details for a specific incident ID or number.

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
incident_idNoThe incident ID or number to retrieve (optional, cannot be used with any other filters).
current_user_contextNoFilter by current user's context (default: True). Not used if `incident_id` is provided.
service_idsNoFilter by services (optional, excludes current_user_context). Not used if `incident_id` is provided.
team_idsNoFilter by teams (optional, excludes current_user_context). Not used if `incident_id` is provided.
statusesNoFilter by status (optional). Not used if `incident_id` is provided. Must be input as a list of strings, valid values are `["triggered", "acknowledged", "resolved"]`.
sinceNoStart of query range in ISO8601 format (default range: 1 month, max range: 6 months). Not used if `incident_id` is provided.
untilNoEnd of query range in ISO8601 format (default range: 1 month, max range: 6 months). Not used if `incident_id` is provided.
limitNoMax results (optional). Not used if `incident_id` is provided.
include_past_incidentsNoIf True and `incident_id` is provided, includes similar past incidents in the response. Defaults to False. Cannot be used without `incident_id`.
include_related_incidentsNoIf True and `incident_id` is provided, includes related incidents impacting other services/responders in the response. Defaults to False. Cannot be used without `incident_id`.
include_notesNoIf True, includes notes for each incident in the response. Defaults to False.

Output Schema

TableJSON Schema
NameRequiredDescriptionDefault

No arguments

Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations are provided, so the description must disclose behavioral traits. It only states the two modes without discussing pagination, rate limits, authentication, or exclusivity of filter parameters. The schema descriptions cover parameter constraints, but the description adds little beyond that.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single sentence that is concise and front-loaded with the core purpose. It could be more structured, but it effectively communicates the main functionality without waste.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness3/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

With an output schema present, the description does not need to explain return values. However, given the tool has 11 parameters and two operational modes, the description is somewhat minimal. It omits details like pagination or sorting behaviors, but the output schema may cover some of this. It is adequate but not thorough.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100%, so the baseline is 3. The description does not add additional meaning to the parameters beyond what the schema already provides. It simply says 'by filters or get details', which is already clear from the parameter descriptions.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the tool retrieves PagerDuty incidents either by filters or by a specific incident ID/number. It specifies the verb 'get' and the resource 'incidents', distinguishing between two retrieval modes.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description does not provide explicit guidance on when to use this tool versus alternatives. While sibling tools are for different entities (users, teams, etc.), there is no mention of this tool's role or when not to use it. The usage context is implied but not clearly stated.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Install Server

Other Tools

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/wpfleger96/pagerduty-mcp-server'

If you have feedback or need assistance with the MCP directory API, please join our Discord server