Skip to main content
Glama

Get status page

get_status_page
Read-onlyIdempotent

Retrieve a single status page by UID or slug, optionally including its sections, section resources, and incidents for monitoring or incident review.

Instructions

Get one status page by UID or slug (identifier takes either) and return it. with=sections embeds its sections and their resources. include adds lists next to the page fields: "sections" (section metadata, display order), "resources" (the resources of the section named by sectionIdentifier) and "incidents" (the customer-facing incident publications on the page, filtered by state and active). Use list_status_pages to browse every page, and manage_status_page_section / _resource / _incident to change them. Read-only: works with mcp:read tokens.

Input Schema

NameRequiredDescriptionDefault
withNo"sections" to include nested sections and their resources
stateNoWith include=incidents: only publications in this public state. Allowed: "investigating", "identified", "monitoring", "resolved".
activeNoWith include=incidents: when true, only publications that are not resolved.
includeNoExtra lists to return with the page. An unknown value is an error. Do not combine "sections" with with=sections.
identifierYesStatus page UID or URL-friendly slug, e.g. "public".
sectionIdentifierNoSection UID or slug whose resources include=resources returns (required with it).

Output Schema

NameRequiredDescriptionDefault
uidYesStatus page UID.
nameNoDisplay name.
slugNoURL-friendly slug.
enabledNoWhether the public page is served.
sectionsNoSections; absent unless with=sections (nested resources included) or include=sections (section metadata only) was passed.
createdAtNoRFC3339 creation timestamp.
incidentsNoIncident publications on the page; present with include=incidents.
isDefaultNoWhether this is the organization's default page.
resourcesNoResources of the section named by sectionIdentifier; present with include=resources.
visibilityNo"public", "private" or "password".
historyPeriodNoHistory window: "24h", "7d", "30d" or "90d".

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed5 schema fields changedv0.42.0
    • addedInput schema / properties / identifier / maxLength
      Added value: +2048
    • addedInput schema / properties / identifier / minLength
      Added value: +1
    • addedInput schema / properties / sectionIdentifier / maxLength
      Added value: +2048
    • addedInput schema / properties / state / maxLength
      Added value: +2048
    • addedInput schema / properties / with / maxLength
      Added value: +2048
  2. Changed2 schema fields changedv0.41.0
    • addedInput schema / additionalProperties
      Added value: +false
    • addedOutput schema / additionalProperties
      Added value: +false
  3. Changed5 schema fields changedv0.38.5
    • addedInput schema / properties / active
      Added value: +{
      +  "description": "With include=incidents: when true, only publications that are not resolved.",
      +  "type": "boolean"
      +}
    • addedInput schema / properties / include
      Added value: +{
      +  "description": "Extra lists to return with the page. An unknown value is an error. Do not combine \"sections\" with with=sections.",
      +  "items": {
      +    "enum": [
      +      "sections",
      +      "resources",
      +      "incidents"
      +    ],
      +    "type": "string"
      +  },
      +  "type": "array"
      +}
    • addedInput schema / properties / sectionIdentifier
      Added value: +{
      +  "description": "Section UID or slug whose resources include=resources returns (required with it).",
      +  "type": "string"
      +}
    • addedInput schema / properties / state
      Added value: +{
      +  "description": "With include=incidents: only publications in this public state. Allowed: \"investigating\", \"identified\", \"monitoring\", \"resolved\".",
      +  "type": "string"
      +}
    • changedOutput schema / (root)
      Previous value: -nullNew value: +{
      +  "properties": {
      +    "createdAt": {
      +      "description": "RFC3339 creation timestamp.",
      +      "type": "string"
      +    },
      +    "enabled": {
      +      "description": "Whether the public page is served.",
      +      "type": "boolean"
      +    },
      +    "historyPeriod": {
      +      "description": "History window: \"24h\", \"7d\", \"30d\" or \"90d\".",
      +      "type": "string"
      +    },
      +    "incidents": {
      +      "description": "Incident publications on the page; present with include=incidents.",
      +      "items": {
      +        "properties": {
      +          "autoCreated": {
      +            "description": "True when the publication was created by the auto-publish pipeline.",
      +            "type": "boolean"
      +          },
      +          "createdAt": {
      +            "description": "RFC3339 creation timestamp.",
      +            "type": "string"
      +          },
      +          "humanTouched": {
      +            "description": "True once an operator edited it, which stops auto-resolve.",
      +            "type": "boolean"
      +          },
      +          "incidentUid": {
      +            "description": "Linked internal incident UID, when the publication tracks one.",
      +            "type": "string"
      +          },
      +          "publishedAt": {
      +            "description": "RFC3339 timestamp when the entry appeared on the page.",
      +            "type": "string"
      +          },
      +          "resolvedAt": {
      +            "description": "RFC3339 timestamp when it was resolved; absent while open.",
      +            "type": "string"
      +          },
      +          "severity": {
      +            "description": "Public severity: minor, major or critical; absent when unset.",
      +            "type": "string"
      +          },
      +          "stale": {
      +            "description": "True when the linked incident has resolved while the entry is still open.",
      +            "type": "boolean"
      +          },
      +          "state": {
      +            "description": "Public state: investigating, identified, monitoring or resolved.",
      +            "type": "string"
      +          },
      +          "statusPageUid": {
      +            "description": "UID of the status page the publication lives on.",
      +            "type": "string"
      +          },
      +          "title": {
      +            "description": "Customer-facing title.",
      +            "type": "string"
      +          },
      +          "uid": {
      +            "description": "Publication UID.",
      +            "type": "string"
      +          },
      +          "updatedAt": {
      +            "description": "RFC3339 last-update timestamp.",
      +            "type": "string"
      +          }
      +        },
      +        "type": "object"
      +      },
      +      "type": "array"
      +    },
      +    "isDefault": {
      +      "description": "Whether this is the organization's default page.",
      +      "type": "boolean"
      +    },
      +    "name": {
      +      "description": "Display name.",
      +      "type": "string"
      +    },
      +    "resources": {
      +      "description": "Resources of the section named by sectionIdentifier; present with include=resources.",
      +      "items": {
      +        "properties": {
      +          "checkGroupUid": {
      +            "description": "Pinned check group UID, when the resource targets a group.",
      +            "type": "string"
      +          },
      +          "checkUid": {
      +            "description": "Pinned check UID, when the resource targets a check.",
      +            "type": "string"
      +          },
      +          "explanation": {
      +            "description": "Short explanation rendered under the resource.",
      +            "type": "string"
      +          },
      +          "position": {
      +            "description": "Display position within the section (smaller renders earlier).",
      +            "type": "integer"
      +          },
      +          "publicName": {
      +            "description": "Display name shown on the public page.",
      +            "type": "string"
      +          },
      +          "uid": {
      +            "description": "Resource UID.",
      +            "type": "string"
      +          }
      +        },
      +        "type": "object"
      +      },
      +      "type": "array"
      +    },
      +    "sections": {
      +      "description": "Sections; absent unless with=sections (nested resources included) or include=sections (section metadata only) was passed.",
      +      "items": {
      +        "properties": {
      +          "name": {
      +            "description": "Section display name.",
      +            "type": "string"
      +          },
      +          "position": {
      +            "description": "Display position (smaller renders earlier).",
      +            "type": "integer"
      +          },
      +          "resources": {
      +            "description": "Pinned checks and groups of the section.",
      +            "items": {
      +              "properties": {
      +                "checkGroupUid": {
      +                  "description": "Pinned check group UID, when the resource targets a group.",
      +                  "type": "string"
      +                },
      +                "checkUid": {
      +                  "description": "Pinned check UID, when the resource targets a check.",
      +                  "type": "string"
      +                },
      +                "explanation": {
      +                  "description": "Short explanation rendered under the resource.",
      +                  "type": "string"
      +                },
      +                "position": {
      +                  "description": "Display position within the section (smaller renders earlier).",
      +                  "type": "integer"
      +                },
      +                "publicName": {
      +                  "description": "Display name shown on the public page.",
      +                  "type": "string"
      +                },
      +                "uid": {
      +                  "description": "Resource UID.",
      +                  "type": "string"
      +                }
      +              },
      +              "type": "object"
      +            },
      +            "type": "array"
      +          },
      +          "selector": {
      +            "description": "Dynamic membership rule; absent on hand-curated sections.",
      +            "type": "object"
      +          },
      +          "slug": {
      +            "description": "URL-friendly slug, unique within the page.",
      +            "type": "string"
      +          },
      +          "uid": {
      +            "description": "Section UID.",
      +            "type": "string"
      +          }
      +        },
      +        "type": "object"
      +      },
      +      "type": "array"
      +    },
      +    "slug": {
      +      "description": "URL-friendly slug.",
      +      "type": "string"
      +    },
      +    "uid": {
      +      "description": "Status page UID.",
      +      "type": "string"
      +    },
      +    "visibility": {
      +      "description": "\"public\", \"private\" or \"password\".",
      +      "type": "string"
      +    }
      +  },
      +  "required": [
      +    "uid"
      +  ],
      +  "type": "object"
      +}
  4. First observedv0.32.1

TDQS

A4.4/5.0
Behavior4/5

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

Annotations already declare readOnly, idempotent, non-destructive, closed-world, so the bar is lower; the description still adds real context: mcp:read token scope, that with=sections embeds nested sections and their resources, that include returns filtered incident publications, and that an unknown include value is an error. It doesn't discuss pagination or failure modes beyond the include error, keeping it short of a 5.

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?

Front-loaded with purpose and efficient overall, but the middle sentence enumerating include values in prose is verbose and duplicates the schema enumeration. Slight redundancy, no wasted framing.

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

Completeness5/5

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

With an output schema present, return shape needn't be described; annotations cover safety and the description covers auth scope, embedding behavior, and sibling routing. Nothing needed to call it correctly is missing.

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 baseline is 3. The description's prose about with/include/state/active largely restates what the schema already documents (including the sectionIdentifier requirement for include=resources), adding little semantic depth beyond 'identifier takes either'.

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?

States a specific verb and resource ('Get one status page') plus identifier flexibility (UID or slug), and explicitly distinguishes itself from list_status_pages for browsing. An agent can tell instantly this is the single-record read.

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

Usage Guidelines5/5

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

Names the alternatives and the conditions selecting them: list_status_pages for browsing, manage_status_page_section/_resource/_incident for changes. It also gives intra-tool guidance (when to use with=sections vs include, and the rule not to combine them), leaving nothing to inference.

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