review_participants
List review participants, add taggable users, add an agent alias for the current user, and manage mention notifications.
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" · "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
Section titled “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
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.