# review_participants

List review participants, add taggable users, add an agent alias for the current user, and manage mention notifications.

Canonical: https://commentary.dev/docs/reference/mcp/review-participants

List review participants, add taggable users, add an agent alias for the current user, and manage mention notifications.

## 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"` · `"add_user"` · `"add_agent"` · `"list_notifications"` · `"mark_notification_read"` | Yes | Operation to perform. Choose one advertised value; the remaining parameters are interpreted for that action. |
| `provider` | `"github"` | No | Source provider for the review. Commentary currently accepts GitHub for provider-backed MCP operations. |
| `owner` | string | No | Repository owner or organization login. |
| `repo` | string | No | Repository name without the owner prefix. |
| `prNumber` | number | No | Pull request number within the selected repository. |
| `branchRef` | string | No | Repository branch name or fully qualified branch reference. |
| `sessionId` | string | No | Stable Draft, or Research session identifier, as applicable to the selected tool. |
| `webAppReviewId` | string | No | Stable Web App Review identifier. |
| `providerLogin` | string | No | Provider login used by the selected Review Participants action. |
| `providerUserId` | string | No | Stable provider user identifier used by the selected Review Participants action. |
| `userId` | string | No | Stable user identifier used by the selected Review Participants action. |
| `agentAlias` | string | No | Stable agent identifier for agent-authored activity. Agents should always provide this on state-changing calls; clientName is not a substitute. |
| `displayName` | string | No | Display name used by the selected Review Participants action. |
| `mentionHandle` | string | No | Mention handle used by the selected Review Participants action. |
| `recipient` | string | No | User identity or recipient descriptor used by an explicitly selected sharing action. |
| `unreadOnly` | boolean | No | Whether to enable unread only for the selected Review Participants action. |
| `notificationId` | string | No | Stable notification identifier used by the selected Review Participants action. |

## Call the tool

Send a `tools/call` request with `name: "review_participants"` 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/review-participants.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).