review_polls
List, read, create, edit, vote, close, reopen or archive review polls. Creation attaches a poll to an authorized existing comment using threadId and commentId. Polls must be enabled; decision polls also require Consensus. Standard polls are non-binding. Decision votes cannot override blockers. Agents vote using their registered identity. Lists accept review, optional threadId, after and outcome; follow nextAfter.
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" · "edit" · "vote" · "clear_vote" · "close" · "reopen" · "archive" · "markdown" |
Yes | Operation to perform. Choose one advertised value; the remaining parameters are interpreted for that action. |
review |
object or object or object or object or object or object or object | No | Review used by the selected Review Polls action. |
threadId |
string | No | Stable Commentary review-thread identifier. |
commentId |
string | No | Stable Commentary comment identifier. |
pollId |
string | No | Stable poll-comment identifier. |
poll |
object | No | Poll object used by the selected Review Polls action. |
selectedOptionIds |
array of string | No | Selected option ids values used by the selected Review Polls action. |
after |
string | No | After used by the selected Review Polls action. |
reason |
string | No | Reason used by the selected Review Polls action. |
outcome |
"all" · "pending" · "accepted_for_change" · "blocked" · "needs_owner_decision" · "rejected" · "out_of_scope" · "stale" |
No | Allowed outcome value for the selected Review Polls action. |
Call the tool
Section titled “Call the tool”Send a tools/call request with name: "review_polls" 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.