Skip to main content
Glama

Page through the PR-vs-base changeset by kind

list_pr_stories
Read-onlyIdempotent

Page through the PR-vs-base changeset stories of one kind (resolved by commitSha/prNumber/buildId) - use it to read past get_pr_changeset's first page. kind='new' returns stories the PR adds that the base branch has no baseline for; kind='changed' returns stories whose image differs from the base branch's accepted image (even if accepted mid-PR, with status=accepted); kind='removed' returns stories that HAD a baseline on the base branch but are gone from head (a deletion; each carries lastBuildId, not a review status or verdict). Returns { stories, nextCursor }: pass nextCursor back as cursor for the next page; null means no more. limit defaults to 25 (max 100).

Input Schema

NameRequiredDescriptionDefault
kindYesWhich changeset stories to page: new (added), changed (vs base), or removed (deleted).
limitNoPage size (default 25, max 100).
cursorNoThe nextCursor from a prior page; omit for the first page.
buildIdNoResolve this exact build id.
prNumberNoResolve the latest build for this PR number.
commitShaNoResolve the build for this git commit SHA.
projectIdNoThe project to look in (a projectId from list_projects). Needed only when you can access several projects; a buildId already names its project.

Output Schema

NameRequiredDescriptionDefault
noteNoPresent when this is UI Verify's demo project rather than one of yours; says how to set up your own.
storiesYes
nextCursorYes
openReviewCommentsNoPresent when open review comments are waiting on some branch of this project; read yours with list_comments.

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed1 schema field changed
    • addedOutput schema / properties / openReviewComments
      Added value: +{
      +  "additionalProperties": false,
      +  "description": "Present when open review comments are waiting on some branch of this project; read yours with list_comments.",
      +  "properties": {
      +    "branches": {
      +      "items": {
      +        "additionalProperties": false,
      +        "properties": {
      +          "branch": {
      +            "type": "string"
      +          },
      +          "lastActivityAt": {
      +            "type": "string"
      +          },
      +          "open": {
      +            "type": "number"
      +          }
      +        },
      +        "required": [
      +          "branch",
      +          "open",
      +          "lastActivityAt"
      +        ],
      +        "type": "object"
      +      },
      +      "type": "array"
      +    },
      +    "branchesTotal": {
      +      "type": "number"
      +    },
      +    "hint": {
      +      "type": "string"
      +    },
      +    "projectId": {
      +      "type": "string"
      +    },
      +    "total": {
      +      "type": "number"
      +    }
      +  },
      +  "required": [
      +    "total",
      +    "branches",
      +    "branchesTotal",
      +    "projectId",
      +    "hint"
      +  ],
      +  "type": "object"
      +}
  2. Changed1 schema field changed
    • addedOutput schema / properties / note
      Added value: +{
      +  "description": "Present when this is UI Verify's demo project rather than one of yours; says how to set up your own.",
      +  "type": "string"
      +}
  3. Changed1 schema field changed
    • addedInput schema / properties / projectId
      Added value: +{
      +  "description": "The project to look in (a projectId from list_projects). Needed only when you can access several projects; a buildId already names its project.",
      +  "format": "uuid",
      +  "type": "string"
      +}
  4. Changed1 schema field changed
    • changedOutput schema / (root)
      Previous value: -nullNew value: +{
      +  "$schema": "http://json-schema.org/draft-07/schema#",
      +  "additionalProperties": false,
      +  "properties": {
      +    "nextCursor": {
      +      "type": [
      +        "string",
      +        "null"
      +      ]
      +    },
      +    "stories": {
      +      "items": {
      +        "anyOf": [
      +          {
      +            "additionalProperties": false,
      +            "properties": {
      +              "aiConfidence": {
      +                "type": [
      +                  "string",
      +                  "null"
      +                ]
      +              },
      +              "aiVerdict": {
      +                "type": [
      +                  "string",
      +                  "null"
      +                ]
      +              },
      +              "browsers": {
      +                "items": {
      +                  "type": "string"
      +                },
      +                "type": "array"
      +              },
      +              "kind": {
      +                "enum": [
      +                  "new",
      +                  "changed"
      +                ],
      +                "type": "string"
      +              },
      +              "name": {
      +                "type": "string"
      +              },
      +              "status": {
      +                "enum": [
      +                  "accepted",
      +                  "denied",
      +                  "ignored",
      +                  "pending"
      +                ],
      +                "type": "string"
      +              },
      +              "storyId": {
      +                "type": "string"
      +              },
      +              "title": {
      +                "type": "string"
      +              },
      +              "unstable": {
      +                "type": "boolean"
      +              },
      +              "viewports": {
      +                "items": {
      +                  "type": "string"
      +                },
      +                "type": "array"
      +              }
      +            },
      +            "required": [
      +              "storyId",
      +              "title",
      +              "name",
      +              "kind",
      +              "status",
      +              "browsers",
      +              "viewports",
      +              "aiVerdict",
      +              "aiConfidence",
      +              "unstable"
      +            ],
      +            "type": "object"
      +          },
      +          {
      +            "additionalProperties": false,
      +            "properties": {
      +              "browsers": {
      +                "items": {
      +                  "type": "string"
      +                },
      +                "type": "array"
      +              },
      +              "lastBuildId": {
      +                "format": "uuid",
      +                "type": "string"
      +              },
      +              "name": {
      +                "type": "string"
      +              },
      +              "storyId": {
      +                "type": "string"
      +              },
      +              "title": {
      +                "type": "string"
      +              },
      +              "viewports": {
      +                "items": {
      +                  "type": "string"
      +                },
      +                "type": "array"
      +              }
      +            },
      +            "required": [
      +              "storyId",
      +              "title",
      +              "name",
      +              "lastBuildId",
      +              "browsers",
      +              "viewports"
      +            ],
      +            "type": "object"
      +          }
      +        ]
      +      },
      +      "type": "array"
      +    }
      +  },
      +  "required": [
      +    "stories",
      +    "nextCursor"
      +  ],
      +  "type": "object"
      +}
  5. First observed

TDQS

Score is being calculated.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources