此 MCP 可以做什么
Supports visual regression testing by inspecting UI build diffs, rendering comparison images, reviewing or accepting changes, and managing comments on visual test results.
功能
工具
14
工具
accept_build
Accept every changed story in a build
Accept ALL changed stories in one build at once (resolved by commitSha/prNumber/buildId), advancing each story's per-branch baseline so the next build is clean. This is the bulk form of review_diff='accept' â use it when you've decided the whole build's changes are intended. It accepts every changed story, including stories that already have a prior denied review; failed stories are unaffected. Returns the build triage after accepting (first page of changed stories, each now showing decision='accepted'; page the rest with list_build_stories if changedNextCursor is set). Refused, with nothing accepted, while any changed story has an unresolved review comment: the error names those stories; read them with list_comments, address each note, resolve_comment its thread, then accept again.
输入模式
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'buildId': {'type': 'string', 'format': 'uuid', 'description': 'Resolve this exact build id.'}, 'prNumber': {'type': 'integer', 'description': 'Resolve the latest build for this PR number.', 'exclusiveMinimum': 0}, 'commitSha': {'type': 'string', 'minLength': 1, 'description': 'Resolve the build for this git commit SHA.'}}, 'additionalProperties': False}
输出模式
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['buildId', 'commitSha', 'branch', 'prNumber', 'status', 'gateStatus', 'autoAcceptChanges', 'createdAt', 'counts', 'comments', 'aiReview', 'changedStories', 'changedNextCursor', 'failedStories', 'failedNextCursor'], 'properties': {'branch': {'type': 'string'}, 'counts': {'type': 'object', 'required': ['total', 'changed', 'failed', 'unchanged'], 'properties': {'total': {'type': 'number'}, 'failed': {'type': 'number'}, 'changed': {'type': 'number'}, 'unchanged': {'type': 'number'}}, 'additionalProperties': False}, 'status': {'type': 'string'}, 'buildId': {'type': 'string', 'format': 'uuid'}, 'aiReview': {'anyOf': [{'type': 'object', 'required': ['regressions', 'intended', 'reviewed'], 'properties': {'intended': {'type': 'number'}, 'reviewed': {'type': 'number'}, 'regressions': {'type': 'number'}}, 'additionalProperties': False}, {'type': 'null'}]}, 'comments': {'type': 'object', 'required': ['total', 'unresolved'], 'properties': {'total': {'type': 'number'}, 'unresolved': {'type': 'number'}}, 'additionalProperties': False}, 'prNumber': {'type': ['number', 'null']}, 'commitSha': {'type': 'string'}, 'createdAt': {'type': 'string'}, 'gateStatus': {'type': 'string'}, 'failedStories': {'type': 'array', 'items': {'type': 'object', 'required': ['storyId', 'title', 'name', 'viewport', 'browser', 'error', 'errorTruncated', 'kind'], 'properties': {'kind': {'enum': ['render', 'interaction'], 'type': 'string'}, 'name': {'type': 'string'}, 'error': {'type': 'string'}, 'title': {'type': 'string'}, 'browser': {'type': 'string'}, 'storyId': {'type': 'string'}, 'viewport': {'type': 'string'}, 'errorTruncated': {'type': 'boolean'}}, 'additionalProperties': False}}, 'changedStories': {'type': 'array', 'items': {'type': 'object', 'required': ['diffResultId', 'storyId', 'title', 'name', 'viewport', 'browser', 'changedPct', 'decision', 'isNew', 'unstable', 'aiVerdict', 'aiClassification', 'aiIntroducedBy', 'aiConfidence', 'aiSummary', 'aiFlagReason', 'comments'], 'properties': {'name': {'type': 'string'}, 'isNew': {'type': 'boolean'}, 'title': {'type': 'string'}, 'browser': {'type': 'string'}, 'storyId': {'type': 'string'}, 'comments': {'type': 'object', 'required': ['total', 'unresolved'], 'properties': {'total': {'$ref': '#/properties/comments/properties/total'}, 'unresolved': {'$ref': '#/properties/comments/properties/unresolved'}}, 'additionalProperties': False}, 'decision': {'type': ['string', 'null']}, 'unstable': {'type': 'boolean'}, 'viewport': {'type': 'string'}, 'aiSummary': {'type': ['string', 'null']}, 'aiVerdict': {'type': ['string', 'null']}, 'changedPct': {'type': ['number', 'null']}, 'aiConfidence': {'type': ['string', 'null']}, 'aiFlagReason': {'type': ['string', 'null']}, 'diffResultId': {'type': 'string', 'format': 'uuid'}, 'aiIntroducedBy': {'type': ['string', 'null']}, 'aiClassification': {'type': ['string', 'null']}}, 'additionalProperties': False}}, 'failedNextCursor': {'type': ['string', 'null']}, 'autoAcceptChanges': {'type': 'boolean'}, 'changedNextCursor': {'type': ['string', 'null']}}, 'additionalProperties': False}
delete_comment
Delete a comment
Soft-delete a comment (get its id from list_comments). An agent key can delete only agent-authored comments, never a human's. Deleting a thread root removes its replies too. Requires the image comments feature.
可能执行破坏性操作
输入模式
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['commentId'], 'properties': {'commentId': {'type': 'string', 'description': 'The comment id to delete (from list_comments).'}}, 'additionalProperties': False}
输出模式
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['id', 'deleted'], 'properties': {'id': {'type': 'string'}, 'deleted': {'type': 'boolean', 'const': True}}, 'additionalProperties': False}
get_build
Get what changed in a UI Verify build
Triage one build, resolved by commitSha, prNumber, or buildId (exactly one). Returns the gate verdict and counts (total/changed/failed/unchanged), then the FIRST page (25) of the changed stories (story id, viewport, % pixels changed, review decision, the AI verdict aiVerdict=intended|regression + aiConfidence, and for a regression the judge's one-line aiFlagReason=what-looks-unintended, when AI review is on, and the story's own review-comment tally comments {total, unresolved}) and the first page of failed stories (failedStories[].kind is `render` when the story produced no frame, or `interaction` when it rendered and its play() assertion threw; failedStories[].error is the message's first line, errorTruncated marks the ones that carried more). When AI review ran, aiReview tallies how many changes look like regressions vs intended, and the changed list is ordered likely-regressions-first. changedNextCursor / failedNextCursor are non-null when there are more than 25: page the rest with list_build_stories. counts.unchanged is how many stories did NOT change and have a baseline - this triage call does NOT list them (keeps the response lean); call list_build_stories status=unchanged to browse them (e.g. to confirm a passed build's stories are 'identical to baseline'). comments is the build-wide review-comment tally {total, unresolved}: unresolved>0 means a designer/QA (or another agent) left an open note on a story - read it with list_comments BEFORE you accept. No image URLs here - call get_diff or render_diff_image for pixels.
只读
输入模式
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'buildId': {'type': 'string', 'format': 'uuid', 'description': 'Resolve this exact build id.'}, 'prNumber': {'type': 'integer', 'description': 'Resolve the latest build for this PR number.', 'exclusiveMinimum': 0}, 'commitSha': {'type': 'string', 'minLength': 1, 'description': 'Resolve the build for this git commit SHA.'}}, 'additionalProperties': False}
输出模式
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['buildId', 'commitSha', 'branch', 'prNumber', 'status', 'gateStatus', 'autoAcceptChanges', 'createdAt', 'counts', 'comments', 'aiReview', 'changedStories', 'changedNextCursor', 'failedStories', 'failedNextCursor'], 'properties': {'branch': {'type': 'string'}, 'counts': {'type': 'object', 'required': ['total', 'changed', 'failed', 'unchanged'], 'properties': {'total': {'type': 'number'}, 'failed': {'type': 'number'}, 'changed': {'type': 'number'}, 'unchanged': {'type': 'number'}}, 'additionalProperties': False}, 'status': {'type': 'string'}, 'buildId': {'type': 'string', 'format': 'uuid'}, 'aiReview': {'anyOf': [{'type': 'object', 'required': ['regressions', 'intended', 'reviewed'], 'properties': {'intended': {'type': 'number'}, 'reviewed': {'type': 'number'}, 'regressions': {'type': 'number'}}, 'additionalProperties': False}, {'type': 'null'}]}, 'comments': {'type': 'object', 'required': ['total', 'unresolved'], 'properties': {'total': {'type': 'number'}, 'unresolved': {'type': 'number'}}, 'additionalProperties': False}, 'prNumber': {'type': ['number', 'null']}, 'commitSha': {'type': 'string'}, 'createdAt': {'type': 'string'}, 'gateStatus': {'type': 'string'}, 'failedStories': {'type': 'array', 'items': {'type': 'object', 'required': ['storyId', 'title', 'name', 'viewport', 'browser', 'error', 'errorTruncated', 'kind'], 'properties': {'kind': {'enum': ['render', 'interaction'], 'type': 'string'}, 'name': {'type': 'string'}, 'error': {'type': 'string'}, 'title': {'type': 'string'}, 'browser': {'type': 'string'}, 'storyId': {'type': 'string'}, 'viewport': {'type': 'string'}, 'errorTruncated': {'type': 'boolean'}}, 'additionalProperties': False}}, 'changedStories': {'type': 'array', 'items': {'type': 'object', 'required': ['diffResultId', 'storyId', 'title', 'name', 'viewport', 'browser', 'changedPct', 'decision', 'isNew', 'unstable', 'aiVerdict', 'aiClassification', 'aiIntroducedBy', 'aiConfidence', 'aiSummary', 'aiFlagReason', 'comments'], 'properties': {'name': {'type': 'string'}, 'isNew': {'type': 'boolean'}, 'title': {'type': 'string'}, 'browser': {'type': 'string'}, 'storyId': {'type': 'string'}, 'comments': {'type': 'object', 'required': ['total', 'unresolved'], 'properties': {'total': {'$ref': '#/properties/comments/properties/total'}, 'unresolved': {'$ref': '#/properties/comments/properties/unresolved'}}, 'additionalProperties': False}, 'decision': {'type': ['string', 'null']}, 'unstable': {'type': 'boolean'}, 'viewport': {'type': 'string'}, 'aiSummary': {'type': ['string', 'null']}, 'aiVerdict': {'type': ['string', 'null']}, 'changedPct': {'type': ['number', 'null']}, 'aiConfidence': {'type': ['string', 'null']}, 'aiFlagReason': {'type': ['string', 'null']}, 'diffResultId': {'type': 'string', 'format': 'uuid'}, 'aiIntroducedBy': {'type': ['string', 'null']}, 'aiClassification': {'type': ['string', 'null']}}, 'additionalProperties': False}}, 'failedNextCursor': {'type': ['string', 'null']}, 'autoAcceptChanges': {'type': 'boolean'}, 'changedNextCursor': {'type': ['string', 'null']}}, 'additionalProperties': False}
get_diff
Get per-story diff detail with image URLs
Per-story diff detail for a build (resolved by commitSha/prNumber/buildId). Returns diff metrics and presigned, time-limited URLs (download them to a file, or link them in a PR comment) for the baseline, candidate, and diff PNGs. Defaults to the changed stories; pass storyId for one specific story. When that storyId is an UNCHANGED story it returns its baseline (diffResultId null, changed false, the baseline URL as both baselineUrl and candidateUrl) - the story rendered identical to baseline. Use render_diff_image instead when you want the actual pixels inline for a vision model, not a URL. When AI review is on, each diff carries the judge's call: aiVerdict (intended|regression), aiConfidence, aiSummary (what changed), aiReasoning, and aiFlagReason; all null when AI review didn't run for it. Each diff also carries comments {total, unresolved} for THAT story - unresolved>0 means an open review note; read the thread with list_comments before accepting.
只读
输入模式
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'buildId': {'type': 'string', 'format': 'uuid', 'description': 'Resolve this exact build id.'}, 'storyId': {'type': 'string', 'description': 'Limit to one story id.'}, 'prNumber': {'type': 'integer', 'description': 'Resolve the latest build for this PR number.', 'exclusiveMinimum': 0}, 'commitSha': {'type': 'string', 'minLength': 1, 'description': 'Resolve the build for this git commit SHA.'}}, 'additionalProperties': False}
输出模式
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['diffs'], 'properties': {'diffs': {'type': 'array', 'items': {'type': 'object', 'required': ['diffResultId', 'storyId', 'viewport', 'browser', 'changed', 'decision', 'metrics', 'baselineUrl', 'candidateUrl', 'diffUrl', 'aiSummary', 'aiVerdict', 'aiConfidence', 'aiReasoning', 'aiFlagReason', 'comments'], 'properties': {'browser': {'type': 'string'}, 'changed': {'type': 'boolean'}, 'diffUrl': {'type': ['string', 'null']}, 'metrics': {'type': 'object', 'properties': {'bbox': {'anyOf': [{'type': 'object', 'required': ['x', 'y', 'width', 'height'], 'properties': {'x': {'type': 'number'}, 'y': {'type': 'number'}, 'width': {'type': 'number'}, 'height': {'type': 'number'}}, 'additionalProperties': False}, {'type': 'null'}]}, 'width': {'type': 'number'}, 'height': {'type': 'number'}, 'changedPx': {'type': 'number'}, 'threshold': {'type': 'number'}, 'changedPct': {'type': 'number'}, 'flakinessPx': {'type': 'number'}, 'hadBaseline': {'type': 'boolean'}, 'sizeChanged': {'type': 'boolean'}, 'flakinessScore': {'type': 'number'}, 'changedPxAdjusted': {'type': 'number'}}, 'additionalProperties': False}, 'storyId': {'type': 'string'}, 'comments': {'type': 'object', 'required': ['total', 'unresolved'], 'properties': {'total': {'type': 'number'}, 'unresolved': {'type': 'number'}}, 'additionalProperties': False}, 'decision': {'type': ['string', 'null']}, 'viewport': {'type': 'string'}, 'aiSummary': {'type': ['string', 'null']}, 'aiVerdict': {'type': ['string', 'null']}, 'aiReasoning': {'type': ['string', 'null']}, 'baselineUrl': {'type': ['string', 'null']}, 'aiConfidence': {'type': ['string', 'null']}, 'aiFlagReason': {'type': ['string', 'null']}, 'candidateUrl': {'type': 'string'}, 'diffResultId': {'anyOf': [{'type': 'string', 'format': 'uuid'}, {'type': 'null'}]}}, 'additionalProperties': False}}}, 'additionalProperties': False}
get_pr_changeset
Get what this PR does to the UI vs its base branch
The cumulative 'this PR vs base' visual changeset (resolved by commitSha/prNumber/buildId) - what the whole PR does to the UI versus the branch it merges into, INDEPENDENT of what is left to review on the latest build. Unlike get_build (this commit vs the branch's own accepted baseline), this survives in-PR accepts: a story accepted mid-PR still shows under `changed` with status=accepted, so it answers 'what did this PR change' even after the gate reads clean. Returns base (the branch it merges into), counts {new,changed,removed,unchanged}, and the first page of `new` + `changed` + `removed` stories (storyId, title, name, kind, review status, aiVerdict). `removed` lists stories that HAD a baseline on the base branch but are gone from this PR's head (a deletion - otherwise invisible; each carries lastBuildId, the build that rendered its now-orphaned baseline). newNextCursor / changedNextCursor / removedNextCursor page the rest with list_pr_stories. No image URLs - fetch pixels by storyId with get_diff / render_diff_image. Requires the PR visual changeset feature.
只读
输入模式
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'buildId': {'type': 'string', 'format': 'uuid', 'description': 'Resolve this exact build id.'}, 'prNumber': {'type': 'integer', 'description': 'Resolve the latest build for this PR number.', 'exclusiveMinimum': 0}, 'commitSha': {'type': 'string', 'minLength': 1, 'description': 'Resolve the build for this git commit SHA.'}}, 'additionalProperties': False}
输出模式
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['base', 'counts', 'new', 'newNextCursor', 'changed', 'changedNextCursor', 'removed', 'removedNextCursor'], 'properties': {'new': {'type': 'array', 'items': {'type': 'object', 'required': ['storyId', 'title', 'name', 'kind', 'status', 'browsers', 'viewports', 'aiVerdict', 'aiConfidence', 'unstable'], 'properties': {'kind': {'enum': ['new', 'changed'], 'type': 'string'}, 'name': {'type': 'string'}, 'title': {'type': 'string'}, 'status': {'enum': ['accepted', 'denied', 'ignored', 'pending'], 'type': 'string'}, 'storyId': {'type': 'string'}, 'browsers': {'type': 'array', 'items': {'type': 'string'}}, 'unstable': {'type': 'boolean'}, 'aiVerdict': {'type': ['string', 'null']}, 'viewports': {'type': 'array', 'items': {'type': 'string'}}, 'aiConfidence': {'type': ['string', 'null']}}, 'additionalProperties': False}}, 'base': {'type': 'string'}, 'counts': {'type': 'object', 'required': ['new', 'changed', 'removed', 'unchanged'], 'properties': {'new': {'type': 'number'}, 'changed': {'type': 'number'}, 'removed': {'type': 'number'}, 'unchanged': {'type': 'number'}}, 'additionalProperties': False}, 'changed': {'type': 'array', 'items': {'$ref': '#/properties/new/items'}}, 'removed': {'type': 'array', 'items': {'type': 'object', 'required': ['storyId', 'title', 'name', 'lastBuildId', 'browsers', 'viewports'], 'properties': {'name': {'type': 'string'}, 'title': {'type': 'string'}, 'storyId': {'type': 'string'}, 'browsers': {'type': 'array', 'items': {'type': 'string'}}, 'viewports': {'type': 'array', 'items': {'type': 'string'}}, 'lastBuildId': {'type': 'string', 'format': 'uuid'}}, 'additionalProperties': False}}, 'newNextCursor': {'type': ['string', 'null']}, 'changedNextCursor': {'type': ['string', 'null']}, 'removedNextCursor': {'type': ['string', 'null']}}, 'additionalProperties': False}
list_builds
List recent UI Verify builds
Recent UI Verify builds for your project, newest first. Each row is a one-line verdict (gateStatus: passed | changed | failed) for a commit/PR â use it to find the build to inspect. No image URLs or per-story detail here: call get_build for the changed-story list, get_diff for images.
只读
输入模式
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'limit': {'type': 'integer', 'maximum': 100, 'minimum': 1, 'description': 'Max builds to return (default 20).'}, 'branch': {'type': 'string', 'description': 'Only builds on this git branch.'}, 'status': {'enum': ['pending', 'preflight', 'running', 'passed', 'changed', 'failed', 'blocked'], 'type': 'string', 'description': 'Only builds with this raw status.'}}, 'additionalProperties': False}
输出模式
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['builds'], 'properties': {'builds': {'type': 'array', 'items': {'type': 'object', 'required': ['buildId', 'commitSha', 'branch', 'prNumber', 'status', 'gateStatus', 'autoAcceptChanges', 'createdAt'], 'properties': {'branch': {'type': 'string'}, 'status': {'type': 'string'}, 'buildId': {'type': 'string', 'format': 'uuid'}, 'prNumber': {'type': ['number', 'null']}, 'commitSha': {'type': 'string'}, 'createdAt': {'type': 'string'}, 'gateStatus': {'type': 'string'}, 'autoAcceptChanges': {'type': 'boolean'}}, 'additionalProperties': False}}}, 'additionalProperties': False}
list_build_stories
Page through a build's stories by status
Page through one build's stories filtered by status (resolved by commitSha/prNumber/buildId). Use it to read past get_build's first page, or to browse the unchanged/passed stories get_build only counts. status='changed' returns changed stories (same shape + order as get_build, regression-first, each with its comments {total, unresolved}; unresolved>0 means an open review note - read it with list_comments first); status='failed' returns failed stories; status='unchanged' returns the stories that did NOT change this build but have a baseline on this branch (storyId, viewport, browser) - fetch any of their images by storyId with get_diff or render_diff_image to confirm 'identical to baseline'. Returns { stories, nextCursor }: pass nextCursor back as `cursor` for the next page; null means no more. limit defaults to 25 (max 100). Unchanged is only available once the build has settled (an in-progress build has rendered nothing, so it returns an empty page).
只读
输入模式
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['status'], 'properties': {'limit': {'type': 'integer', 'maximum': 100, 'minimum': 1, 'description': 'Page size (default 25, max 100).'}, 'cursor': {'type': 'string', 'description': 'The nextCursor from a prior page; omit for the first page.'}, 'status': {'enum': ['changed', 'unchanged', 'failed'], 'type': 'string', 'description': "Which stories to page: changed, failed, or unchanged (baselined, didn't change this build)."}, 'buildId': {'type': 'string', 'format': 'uuid', 'description': 'Resolve this exact build id.'}, 'prNumber': {'type': 'integer', 'description': 'Resolve the latest build for this PR number.', 'exclusiveMinimum': 0}, 'commitSha': {'type': 'string', 'minLength': 1, 'description': 'Resolve the build for this git commit SHA.'}}, 'additionalProperties': False}
输出模式
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['stories', 'nextCursor'], 'properties': {'stories': {'type': 'array', 'items': {'anyOf': [{'type': 'object', 'required': ['diffResultId', 'storyId', 'title', 'name', 'viewport', 'browser', 'changedPct', 'decision', 'isNew', 'unstable', 'aiVerdict', 'aiClassification', 'aiIntroducedBy', 'aiConfidence', 'aiSummary', 'aiFlagReason', 'comments'], 'properties': {'name': {'type': 'string'}, 'isNew': {'type': 'boolean'}, 'title': {'type': 'string'}, 'browser': {'type': 'string'}, 'storyId': {'type': 'string'}, 'comments': {'type': 'object', 'required': ['total', 'unresolved'], 'properties': {'total': {'type': 'number'}, 'unresolved': {'type': 'number'}}, 'additionalProperties': False}, 'decision': {'type': ['string', 'null']}, 'unstable': {'type': 'boolean'}, 'viewport': {'type': 'string'}, 'aiSummary': {'type': ['string', 'null']}, 'aiVerdict': {'type': ['string', 'null']}, 'changedPct': {'type': ['number', 'null']}, 'aiConfidence': {'type': ['string', 'null']}, 'aiFlagReason': {'type': ['string', 'null']}, 'diffResultId': {'type': 'string', 'format': 'uuid'}, 'aiIntroducedBy': {'type': ['string', 'null']}, 'aiClassification': {'type': ['string', 'null']}}, 'additionalProperties': False}, {'type': 'object', 'required': ['storyId', 'title', 'name', 'viewport', 'browser', 'error', 'errorTruncated', 'kind'], 'properties': {'kind': {'enum': ['render', 'interaction'], 'type': 'string'}, 'name': {'type': 'string'}, 'error': {'type': 'string'}, 'title': {'type': 'string'}, 'browser': {'type': 'string'}, 'storyId': {'type': 'string'}, 'viewport': {'type': 'string'}, 'errorTruncated': {'type': 'boolean'}}, 'additionalProperties': False}, {'type': 'object', 'required': ['storyId', 'viewport', 'browser'], 'properties': {'browser': {'type': 'string'}, 'storyId': {'type': 'string'}, 'viewport': {'type': 'string'}}, 'additionalProperties': False}]}}, 'nextCursor': {'type': ['string', 'null']}}, 'additionalProperties': False}
list_comments
List the review comments on a build's diffs
Every review comment on a build's changed stories (resolved by commitSha/prNumber/buildId), each carrying its diffResultId, author (human name or 'agent'), body, createdAt, and anchor - where on the candidate image it points: null (whole diff), {type:'point',x,y}, {type:'rect',x,y,w,h}, or {type:'path',points,closed}, all normalized 0..1 to the candidate image. Use it to read what a designer/QA (or another agent) flagged on a screenshot before acting. Requires the image comments feature.
只读
输入模式
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'buildId': {'type': 'string', 'format': 'uuid', 'description': 'Resolve this exact build id.'}, 'prNumber': {'type': 'integer', 'description': 'Resolve the latest build for this PR number.', 'exclusiveMinimum': 0}, 'commitSha': {'type': 'string', 'minLength': 1, 'description': 'Resolve the build for this git commit SHA.'}}, 'additionalProperties': False}
输出模式
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['comments'], 'properties': {'comments': {'type': 'array', 'items': {'type': 'object', 'required': ['diffResultId', 'id', 'authorType', 'authorName', 'side', 'parentId', 'anchor', 'body', 'createdAt', 'resolved'], 'properties': {'id': {'type': 'string'}, 'body': {'type': 'string'}, 'side': {'enum': ['before', 'after'], 'type': 'string'}, 'anchor': {'anyOf': [{'anyOf': [{'type': 'object', 'required': ['type', 'x', 'y'], 'properties': {'x': {'type': 'number', 'maximum': 1, 'minimum': 0}, 'y': {'$ref': '#/properties/comments/items/properties/anchor/anyOf/0/anyOf/0/properties/x'}, 'type': {'type': 'string', 'const': 'point'}}, 'additionalProperties': False}, {'type': 'object', 'required': ['type', 'x', 'y', 'w', 'h'], 'properties': {'h': {'type': 'number', 'maximum': 1, 'exclusiveMinimum': 0}, 'w': {'type': 'number', 'maximum': 1, 'exclusiveMinimum': 0}, 'x': {'$ref': '#/properties/comments/items/properties/anchor/anyOf/0/anyOf/0/properties/x'}, 'y': {'$ref': '#/properties/comments/items/properties/anchor/anyOf/0/anyOf/0/properties/x'}, 'type': {'type': 'string', 'const': 'rect'}}, 'additionalProperties': False}, {'type': 'object', 'required': ['type', 'points', 'closed'], 'properties': {'type': {'type': 'string', 'const': 'path'}, 'closed': {'type': 'boolean'}, 'points': {'type': 'array', 'items': {'type': 'object', 'required': ['x', 'y'], 'properties': {'x': {'$ref': '#/properties/comments/items/properties/anchor/anyOf/0/anyOf/0/properties/x'}, 'y': {'$ref': '#/properties/comments/items/properties/anchor/anyOf/0/anyOf/0/properties/x'}}, 'additionalProperties': False}, 'maxItems': 512, 'minItems': 2}}, 'additionalProperties': False}]}, {'type': 'null'}]}, 'parentId': {'type': ['string', 'null']}, 'resolved': {'type': 'boolean'}, 'createdAt': {'type': 'string'}, 'authorName': {'type': ['string', 'null']}, 'authorType': {'enum': ['human', 'agent'], 'type': 'string'}, 'diffResultId': {'type': 'string'}}, 'additionalProperties': False}}}, 'additionalProperties': False}
list_pr_stories
Page through the PR-vs-base changeset by kind
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). Requires the PR visual changeset feature.
只读
输入模式
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['kind'], 'properties': {'kind': {'enum': ['new', 'changed', 'removed'], 'type': 'string', 'description': 'Which changeset stories to page: new (added), changed (vs base), or removed (deleted).'}, 'limit': {'type': 'integer', 'maximum': 100, 'minimum': 1, 'description': 'Page size (default 25, max 100).'}, 'cursor': {'type': 'string', 'description': 'The nextCursor from a prior page; omit for the first page.'}, 'buildId': {'type': 'string', 'format': 'uuid', 'description': 'Resolve this exact build id.'}, 'prNumber': {'type': 'integer', 'description': 'Resolve the latest build for this PR number.', 'exclusiveMinimum': 0}, 'commitSha': {'type': 'string', 'minLength': 1, 'description': 'Resolve the build for this git commit SHA.'}}, 'additionalProperties': False}
输出模式
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['stories', 'nextCursor'], 'properties': {'stories': {'type': 'array', 'items': {'anyOf': [{'type': 'object', 'required': ['storyId', 'title', 'name', 'kind', 'status', 'browsers', 'viewports', 'aiVerdict', 'aiConfidence', 'unstable'], 'properties': {'kind': {'enum': ['new', 'changed'], 'type': 'string'}, 'name': {'type': 'string'}, 'title': {'type': 'string'}, 'status': {'enum': ['accepted', 'denied', 'ignored', 'pending'], 'type': 'string'}, 'storyId': {'type': 'string'}, 'browsers': {'type': 'array', 'items': {'type': 'string'}}, 'unstable': {'type': 'boolean'}, 'aiVerdict': {'type': ['string', 'null']}, 'viewports': {'type': 'array', 'items': {'type': 'string'}}, 'aiConfidence': {'type': ['string', 'null']}}, 'additionalProperties': False}, {'type': 'object', 'required': ['storyId', 'title', 'name', 'lastBuildId', 'browsers', 'viewports'], 'properties': {'name': {'type': 'string'}, 'title': {'type': 'string'}, 'storyId': {'type': 'string'}, 'browsers': {'type': 'array', 'items': {'type': 'string'}}, 'viewports': {'type': 'array', 'items': {'type': 'string'}}, 'lastBuildId': {'type': 'string', 'format': 'uuid'}}, 'additionalProperties': False}]}}, 'nextCursor': {'type': ['string', 'null']}}, 'additionalProperties': False}
post_comment
Comment on a build's diff
Leave a review comment on one of a build's changed-story diffs (resolve the build by commitSha/prNumber/buildId, target the diff by diffResultId from get_build/get_diff). The comment is authored as the agent. Optionally anchor it to a spot on the candidate image with `anchor`: omit or null for a whole-diff comment, {type:'point',x,y} to pin a point, {type:'rect',x,y,w,h} for a box, or {type:'path',points:[{x,y},...],closed} for a shape - all coordinates 0..1 normalized to the candidate image. `side` picks the pane ('after' the candidate, default; 'before' the baseline). Pass `parentId` (a root comment id from list_comments) to REPLY in that thread instead - a reply inherits the root's side and carries no anchor, so `anchor`/`side` are ignored. A new root comment is refused when a newer build exists on the branch (comment on the latest build); replies stay allowed. Requires the image comments feature.
输入模式
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['diffResultId', 'body'], 'properties': {'body': {'type': 'string', 'maxLength': 4000, 'minLength': 1, 'description': 'The comment text.'}, 'side': {'enum': ['before', 'after'], 'type': 'string', 'description': "Which pane: 'after' (candidate, default) or 'before' (baseline). Ignored on a reply."}, 'anchor': {'anyOf': [{'anyOf': [{'type': 'object', 'required': ['type', 'x', 'y'], 'properties': {'x': {'type': 'number', 'maximum': 1, 'minimum': 0}, 'y': {'$ref': '#/properties/anchor/anyOf/0/anyOf/0/properties/x'}, 'type': {'type': 'string', 'const': 'point'}}, 'additionalProperties': False}, {'type': 'object', 'required': ['type', 'x', 'y', 'w', 'h'], 'properties': {'h': {'type': 'number', 'maximum': 1, 'exclusiveMinimum': 0}, 'w': {'type': 'number', 'maximum': 1, 'exclusiveMinimum': 0}, 'x': {'$ref': '#/properties/anchor/anyOf/0/anyOf/0/properties/x'}, 'y': {'$ref': '#/properties/anchor/anyOf/0/anyOf/0/properties/x'}, 'type': {'type': 'string', 'const': 'rect'}}, 'additionalProperties': False}, {'type': 'object', 'required': ['type', 'points', 'closed'], 'properties': {'type': {'type': 'string', 'const': 'path'}, 'closed': {'type': 'boolean'}, 'points': {'type': 'array', 'items': {'type': 'object', 'required': ['x', 'y'], 'properties': {'x': {'$ref': '#/properties/anchor/anyOf/0/anyOf/0/properties/x'}, 'y': {'$ref': '#/properties/anchor/anyOf/0/anyOf/0/properties/x'}}, 'additionalProperties': False}, 'maxItems': 512, 'minItems': 2}}, 'additionalProperties': False}]}, {'type': 'null'}], 'description': "Where on the candidate image to pin it (0..1 normalized): omit/null = whole diff; {type:'point',x,y}; {type:'rect',x,y,w,h}; {type:'path',points,closed}. Ignored on a reply."}, 'buildId': {'type': 'string', 'format': 'uuid', 'description': 'Resolve this exact build id.'}, 'parentId': {'type': 'string', 'format': 'uuid', 'description': "Reply to this thread ROOT comment's id (from list_comments) instead of starting a new thread."}, 'prNumber': {'type': 'integer', 'description': 'Resolve the latest build for this PR number.', 'exclusiveMinimum': 0}, 'commitSha': {'type': 'string', 'minLength': 1, 'description': 'Resolve the build for this git commit SHA.'}, 'diffResultId': {'type': 'string', 'format': 'uuid', 'description': 'The diff result to comment on (from get_build/get_diff).'}}, 'additionalProperties': False}
输出模式
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['id'], 'properties': {'id': {'type': 'string'}}, 'additionalProperties': False}
render_diff_image
Fetch the actual pixels of a story image
Fetch a story's image as an INLINE image (base64 pixels, not a URL) so a vision model can look at it directly. Needs a native MCP client that renders image content; piped through raw curl it is useless (use get_diff's URLs there instead). Two ways to address it: (1) diffResultId + which for a CHANGED story - which is baseline|candidate|diff (the triptych) or before_after, the baseline and candidate SIDE BY SIDE (before on the left, after on the right) cropped to the changed region - and when a story changed in SEVERAL far-apart places, one such crop PER region stacked top to bottom, so a header-plus-footer change is two tight crops, not a page-tall image. before_after is usually what you want for a code change - it zooms to what moved instead of a full page. Get diffResultId from get_build (changedStories[].diffResultId) or get_diff. (2) a build selector (commitSha|prNumber|buildId) + storyId for ANY story's current image - the candidate if it changed this build, else its baseline. This second form is the only way to see an UNCHANGED/passed story's pixels (list them via list_build_stories status=unchanged), so you can confirm 'identical to baseline'. Errors if the image doesn't exist (a genuinely new story has no baseline, so no before_after either). When the story has unresolved review comments, a text note saying so comes with the image: read them with list_comments before you accept.
只读
输入模式
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'which': {'enum': ['baseline', 'candidate', 'diff', 'before_after'], 'type': 'string', 'description': 'For the diffResultId form: baseline|candidate|diff (one triptych image, default candidate), or before_after (baseline+candidate side by side, cropped to the change - one crop per changed region, stacked, when the change spans several places). Ignored for the storyId form.'}, 'buildId': {'type': 'string', 'format': 'uuid', 'description': 'Resolve this exact build id.'}, 'storyId': {'type': 'string', 'description': "With a build selector: fetch THIS story's current image (works for unchanged stories)."}, 'prNumber': {'type': 'integer', 'description': 'Resolve the latest build for this PR number.', 'exclusiveMinimum': 0}, 'commitSha': {'type': 'string', 'minLength': 1, 'description': 'Resolve the build for this git commit SHA.'}, 'diffResultId': {'type': 'string', 'format': 'uuid', 'description': "A CHANGED story's diff result id (from get_build/get_diff); pair with `which`."}, 'pxPagination': {'type': 'object', 'required': ['offset'], 'properties': {'height': {'type': 'integer', 'default': 500, 'description': 'Slice height in device px (default 500).', 'exclusiveMinimum': 0}, 'offset': {'type': 'integer', 'minimum': 0, 'description': 'Top y (device px) of the slice to return.'}}, 'description': 'Paginate a TALL image slice by slice instead of one unreadable image: return the `height` device px starting at y=`offset`, so a 5000px page is reviewed in readable slices. Omit for the whole image. Ignored for the before_after form (already cropped to the change).', 'additionalProperties': False}}, 'additionalProperties': False}
resolve_comment
Resolve or reopen a comment thread
Mark a comment thread resolved or reopen it (get the id from list_comments). Resolving stamps the thread ROOT, so pass a root comment's id - a reply id is a no-op. Any team writer may toggle this. Requires the image comments feature.
输入模式
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['commentId', 'resolved'], 'properties': {'resolved': {'type': 'boolean', 'description': 'true to resolve the thread, false to reopen it.'}, 'commentId': {'type': 'string', 'description': 'The thread root comment id (from list_comments).'}}, 'additionalProperties': False}
输出模式
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['id', 'resolved'], 'properties': {'id': {'type': 'string'}, 'resolved': {'type': 'boolean'}}, 'additionalProperties': False}
review_diff
Accept, deny, or ignore one story's change
Record a review on a single diff result (get diffResultId from get_build/get_diff). 'accept' makes the candidate the new baseline for that story on its branch, so the next build is clean; 'deny' records the rejection without changing the baseline; 'ignore' excludes the story from the gate persistently (the snapshot keeps differing on future builds but no longer flags the check) â use it for an intentional, ongoing diff like an animation or a live timestamp. This is the same accept/deny/ignore as the dashboard, attributed to your project key. Use after you've inspected the diff (e.g. with render_diff_image) and decided intended vs. regression. accept and ignore are refused while the story has an unresolved review comment (read it with list_comments, address it, resolve_comment the thread, then retry); deny is always allowed.
输入模式
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['diffResultId', 'decision'], 'properties': {'decision': {'enum': ['accept', 'deny', 'ignore'], 'type': 'string', 'description': "'accept' advances the baseline; 'deny' records a rejection; 'ignore' excludes the story from the gate."}, 'diffResultId': {'type': 'string', 'format': 'uuid', 'description': 'The diff result id from get_build or get_diff.'}}, 'additionalProperties': False}
输出模式
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['diffResultId', 'decision'], 'properties': {'decision': {'enum': ['accepted', 'denied', 'ignored'], 'type': 'string'}, 'diffResultId': {'type': 'string', 'format': 'uuid'}}, 'additionalProperties': False}
update_comment
Edit a comment's text
Replace the body of a comment (get its id from list_comments). An agent key can edit only agent-authored comments, never a human's. Requires the image comments feature.
输入模式
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['commentId', 'body'], 'properties': {'body': {'type': 'string', 'maxLength': 4000, 'minLength': 1, 'description': 'The new comment text.'}, 'commentId': {'type': 'string', 'description': 'The comment id to edit (from list_comments).'}}, 'additionalProperties': False}
输出模式
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['id'], 'properties': {'id': {'type': 'string'}}, 'additionalProperties': False}
历史
近期工具变更
已更改
accept_build
2026年9月27日 02:44
已更改
review_diff
2026年9月27日 02:44
已更改
render_diff_image
2026年9月27日 02:44
已更改
list_build_stories
2026年9月27日 02:44
已更改
get_build
2026年9月27日 02:44
已更改
render_diff_image
2026年9月21日 02:51
已添加
delete_comment
2026年9月17日 12:42
已添加
resolve_comment
2026年9月17日 12:42
已添加
update_comment
2026年9月17日 12:42
已添加
post_comment
2026年9月17日 12:42
已添加
accept_build
2026年9月17日 12:42
已添加
review_diff
2026年9月17日 12:42
已添加
render_diff_image
2026年9月17日 12:42
已添加
get_diff
2026年9月17日 12:42
已添加
list_pr_stories
2026年9月17日 12:42
已添加
list_comments
2026年9月17日 12:42
已添加
get_pr_changeset
2026年9月17日 12:42
已添加
list_build_stories
2026年9月17日 12:42
已添加
get_build
2026年9月17日 12:42
已添加
list_builds
2026年9月17日 12:42
发现
类似的 MCP 服务器
GripForge
io.github.gripforgeai/mcp
Generates, rigs, animates, analyzes, and packages game characters, weapons, armor, effects, environments, and engine-ready assets.
spriteship
com.spriteship/spriteship
Generates and manages 2D game characters, assets, animations, tilesets, UI packs, maps, and engine-ready exports for multiple gam…
Blixtworks
com.blixtworks.www/tools
Offers pay-per-call utilities for text, image processing and analysis, data conversion, validation, web inspection, cryptography,…
Compose Preview Catalogs
io.github.yschimke/compose-preview
Browses, renders, compares, audits, and edits Jetpack Compose preview catalogs and associated UI designs.
arch-tools-mcp
io.github.Deesmo/arch-tools-mcp
Provides general-purpose agent APIs for browser automation, web and PDF extraction, data conversion, email operations, fact check…
kernelcad
com.kernelcad/kernelcad
Authors, evaluates, reviews, simulates, edits, and exports parametric CAD assemblies and geometry from editable TypeScript-based …
floot
com.floot/floot
Creates, edits, previews, databases, and publishes full-stack web and mobile applications with hosted resources and deployment wo…
Raven
ai.ravenmcp/raven-mcp
Supports coding agents with design audits, design-system guidance, and a configurable visual preference profile.