web_app_review
Manage Web App Reviews for agent handoff with action=list, get, create, update_metadata, list_comments, get_agent_context, create_comment, resolve, reopen, list_shares, share, revoke_share, or remove_access.
Connect and discover
Section titled “Connect and discover”Connect an authenticated MCP client. Call tools/list to confirm this tool is available to the current credential. Provider, workspace, and agent grants remain separate access checks.
Input fields
Section titled “Input fields”| Field | Type | Required | Description |
|---|---|---|---|
action |
"list" · "get" · "create" · "update_metadata" · "list_comments" · "get_agent_context" · "create_comment" · "resolve" · "reopen" · "list_shares" · "share" · "revoke_share" · "remove_access" |
Yes | Operation to perform. Choose one advertised value; the remaining parameters are interpreted for that action. |
collaboration |
object | No | Collaboration object used by the selected Web App Review action. |
requestDecision |
boolean | No | Whether to enable request decision for the selected Web App Review action. |
poll |
object | No | Poll object used by the selected Web App Review action. |
reviewId |
string | No | Stable Web App Review identifier. |
shareLinkId |
string | No | Stable share link identifier used by the selected Web App Review action. |
accessGrantId |
string | No | Stable access grant identifier used by the selected Web App Review action. |
audience |
"anyone" · "user" |
No | Allowed audience value for the selected Web App Review action. |
recipient |
string | No | User identity or recipient descriptor used by an explicitly selected sharing action. |
title |
string | No | Human-readable title for the created or updated artifact. |
sourceType |
"deployed_url" · "localhost" |
No | Origin classification for the created or resolved source artifact. |
previewUrl |
string | No | Absolute localhost or deployed preview URL to review. |
deliveryMode |
"auto" · "embedded" · "new_tab" |
No | Allowed delivery mode value for the selected Web App Review action. |
status |
"active" · "archived" |
No | Status filter or requested state supported by the selected action. |
repo |
object | No | Repository name without the owner prefix. |
externalMetadata |
object | No | External metadata object used by the selected Web App Review action. |
includeResolved |
boolean | No | Whether resolved review threads should be included. |
includeArchived |
boolean | No | Whether archived reviews or records should be included. |
includeImages |
boolean | No | Whether bounded screenshot bytes should be included; false returns metadata only. |
threadId |
string | No | Stable Commentary review-thread identifier. |
reviewSessionId |
string | No | Stable review session identifier associated with the target review. |
bodyMarkdown |
string | No | Markdown body for the comment, reply, note, or report produced by the selected action. |
body |
string | No | Plain-text body accepted by actions that support a non-Markdown alias. |
agentAlias |
string | No | Stable agent identifier for agent-authored activity. Agents should always provide this on state-changing calls; clientName is not a substitute. |
targetKind |
"element" · "screenshot" · "general" |
No | Allowed target kind value for the selected Web App Review action. |
route |
string | No | Application route associated with the review comment. |
url |
string | No | Full reviewed page URL associated with the comment. |
origin |
string | No | Exact URL origin authorized for the Web App Review. |
selector |
string | No | Primary CSS selector supplied by the review SDK for the selected element. |
fallbackSelector |
string | No | Fallback CSS selector supplied by the review SDK when the primary selector no longer resolves. |
tagName |
string | No | Tag name used by the selected Web App Review action. |
role |
string | No | Role used by the selected Web App Review action. |
accessibleName |
string | No | Accessible name of the selected interface element. |
textSnippet |
string | No | Bounded visible-text snippet captured for the selected interface element. |
boundingRect |
object | No | Viewport-relative selected-element rectangle supplied by the review SDK. |
viewport |
object | No | Viewport dimensions associated with the captured review context. |
component |
object | No | Component object used by the selected Web App Review action. |
screenshot |
object | No | Bounded screenshot metadata and content accepted by screenshot-comment actions. |
commitSha |
string | No | Commit sha used by the selected Web App Review action. |
Call the tool
Section titled “Call the tool”Send a tools/call request with name: "web_app_review" and an arguments object containing the required fields above. Choose an advertised action, then supply the fields required by that action. Do not treat a successful request as human approval or verified execution unless the returned contract explicitly records that fact.
Errors and recovery
Section titled “Errors and recovery”Read the returned error and permission requirements. Refresh stale revisions before conditional writes, retain idempotency keys only for exact retries, and reconnect when a credential has expired.
Complete input contract
Section titled “Complete input contract”Download the JSON schema for action-specific unions, nested fields, and validation constraints. This schema is generated from the same released definitions as the MCP endpoint. Browse tools.