# 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_

Canonical: https://commentary.dev/docs/reference/mcp/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

Connect an authenticated [MCP client](/docs/build/mcp). Call `tools/list` to confirm this tool is available to the current credential. Provider, workspace, and agent grants remain separate access checks.

## 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

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

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

[Download the JSON schema](/docs/reference/mcp/web-app-review.json) for action-specific unions, nested fields, and validation constraints. This schema is generated from the same released definitions as the MCP endpoint. [Browse tools](/docs/reference/mcp-operations).