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

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

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"` · `"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

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

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-polls.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).