Polly

Draft Polly

Draft a polly for user review. Nothing is created or sent. The questions array decides what you get: ONE question makes a single-question polly, TWO OR MORE make a multi-question polly, which also needs a title. When the user asks for "a poll" author one question; when they ask for "a survey" author two or more, asking what to include if they didn't say. Call this first whenever the user asks for a polly. It validates the audience and renders a confirmation card with Send and Cancel buttons.

Create Polly

Create and publish a polly — sends immediately. One question makes a single-question polly, two or more a multi-question polly. Default flow: 1. draft_polly 2. Wait for the user to explicitly confirm in chat — or they press Send on the card, which publishes the polly by itself (then do NOT call this tool). 3. Only if they confirmed in chat: create_polly with { draftId, userConfirmed: true } — publishes from the draft's stored state; repeating the call can never create a duplicate. Never send i

Update Polly

Update a polly that has ALREADY been created, by its real id (from create_polly, or list_pollys/get_polly) — never a draftId; change an unsent draft with draft_polly and its draftId instead. Update in place — never close and recreate a polly. A created polly's type is FIXED. Adding a question does not turn a single-question polly into a multi-question one — only an unsent draft can change kind. Questions cannot be added or removed here, only edited. Editable by state: - Scheduled (future send

Polly List

List the authenticated user's pollys with optional filters — single- and multi-question pollys in one feed, newest first unless you sort otherwise, the same list the web app shows. Leave `type` out and both kinds come back; set it only when the user explicitly asked for one. Recurring pollys are not included. For a polly's choices or its full settings, call get_polly. Paged: keep `limit` at 25 and page with `cursor` rather than asking for one huge page. Searching by name, read up to 5 pages, th

Polly Details

Get one polly by ID for the authenticated user. Returns metadata; response count is included only with the mcp:results:read scope. If you only know the polly by name, call list_pollys first and take both the id and the type from the row you matched — every row carries its type. Never guess the type, and never call with one type hoping to retry with the other. Requires scope: Read (non-sensitive data).

Polly Results

Get vote counts and distributions for a polly by ID. Returns choice-level results including votes and percentages — for its single question, or for each question of a multi-question polly. Comments and open-ended response text always render on the results card but are withheld from the AI for privacy; there is no parameter to request them. If you only know the polly by name, call list_pollys first and take both the id and the type from the row you matched — every row carries its type. Never gues

Close Polly

Close an active polly by ID, ending voting immediately. Confirm with the user before calling — this stops responses. If you only know the polly by name, call list_pollys first and take both the id and the type from the row you matched — every row carries its type. Never guess the type, and never call with one type hoping to retry with the other. Requires scope: Write.

Reopen Polly

Reopen a closed polly. Ask the user when it should close and pass that as closeAt; omit it only if they have no preference, which reopens for 24 hours. Set sendReminders to re-notify the audience. If you only know the polly by name, call list_pollys first and take both the id and the type from the row you matched — every row carries its type. Never guess the type, and never call with one type hoping to retry with the other. Requires scope: Write.

Get Draft Status

Check what happened to a polly draft: pending (not sent yet), sent (includes the live polly), or cancelled. Read-only — changes nothing. The preview card also calls this on load to catch up with drafts that were sent or cancelled after the card was rendered. Requires scope: Read (non-sensitive data).

Cancel Polly Draft

Cancel a polly draft that has not been sent. Nothing is deleted from Slack — this only voids the draft so its Send action can never publish it. Use the draftId from draft_polly. Already-sent drafts cannot be cancelled — close the polly instead. Requires scope: Write.

Template Search

Search or browse polly templates available to the user, both Polly's templates and the user's own templates. Pass id to get one template's full details, including the default fields to author from. Requires scope: Read (non-sensitive data).

Send Reminder

Send a reminder direct message to everyone who has not yet responded to a polly the authenticated user owns. Only works while the polly is open (already sent and not yet closed) — a scheduled/not-yet-sent or already-closed one will be rejected. This sends a DM to everyone who has not yet responded — confirm with the user before calling. If you only know the polly by name, call list_pollys first and take both the id and the type from the row you matched — every row carries its t