vote_poll
Vote on active Signal polls in DMs or groups. Send option indices with poll identifiers to cast or change your vote.
Instructions
Cast your vote on an active Signal poll in a DM or group conversation. Your vote is delivered via signal-cli and is visible to all participants in real time. Each participant can vote once; re-voting overwrites the previous selection. For single-choice polls, provide exactly one option index in votes. For multi-select polls, provide all chosen indices in a single call — partial updates are not supported. votes are 0-based indices corresponding to the options array from the original create_poll call. Get target_author, target_timestamp, and poll_id from the poll message returned by get_conversation. Provide exactly one of recipient (for a DM poll) or group_id (for a group poll). Voting on a terminated poll returns an error. Use terminate_poll to close a poll you created and freeze the results. Use when responding to an open poll in a conversation. Do NOT use to create a poll — use create_poll instead.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| target_author | Yes | Phone number of the poll creator (E.164) | |
| target_timestamp | Yes | Timestamp of the poll message (from get_conversation) | |
| poll_id | Yes | Poll ID from the poll message data | |
| votes | Yes | Option indices to vote for (0-based). Single item for single-choice polls. | |
| recipient | No | Phone number for a DM poll — provide this OR group_id | |
| group_id | No | Group ID for a group poll — provide this OR recipient |
Implementation Reference
- src/signal_mcp/client.py:1193-1215 (handler)The vote_poll method on SignalClient: sends a vote on an existing poll via the sendPollVote JSON-RPC method. Requires target_author, target_timestamp, poll_id, and votes list, plus exactly one of recipient or group_id.
async def vote_poll( self, target_author: str, target_timestamp: int, poll_id: int, votes: list[int], recipient: str | None = None, group_id: str | None = None, ) -> None: """Vote on an existing poll.""" if not recipient and not group_id: raise SignalError("Either recipient or group_id must be provided") params: dict = { "targetAuthor": target_author, "targetTimestamp": target_timestamp, "poll-id": poll_id, "poll-answer": votes, } if group_id: params["groupId"] = group_id else: params["recipient"] = [recipient] await self._rpc("sendPollVote", params) - src/signal_mcp/server.py:1613-1624 (handler)The call_tool handler for 'vote_poll': validates that recipient or group_id is provided, then calls client.vote_poll() with the arguments from the tool invocation.
elif name == "vote_poll": if not arguments.get("recipient") and not arguments.get("group_id"): return _err("Either recipient or group_id is required") await client.vote_poll( target_author=arguments["target_author"], target_timestamp=arguments["target_timestamp"], poll_id=arguments["poll_id"], votes=arguments["votes"], recipient=arguments.get("recipient"), group_id=arguments.get("group_id"), ) return _ok({"status": "vote sent"}) - src/signal_mcp/server.py:739-767 (registration)Tool registration for 'vote_poll': defines the input schema (target_author, target_timestamp, poll_id, votes arrays, recipient/group_id) and description.
Tool( name="vote_poll", description=( "Cast your vote on an active Signal poll in a DM or group conversation. " "Your vote is delivered via signal-cli and is visible to all participants in real time. " "Each participant can vote once; re-voting overwrites the previous selection. " "For single-choice polls, provide exactly one option index in votes. " "For multi-select polls, provide all chosen indices in a single call — partial updates are not supported. " "votes are 0-based indices corresponding to the options array from the original create_poll call. " "Get target_author, target_timestamp, and poll_id from the poll message returned by get_conversation. " "Provide exactly one of recipient (for a DM poll) or group_id (for a group poll). " "Voting on a terminated poll returns an error. " "Use terminate_poll to close a poll you created and freeze the results. " "Use when responding to an open poll in a conversation. " "Do NOT use to create a poll — use create_poll instead." ), inputSchema={ "type": "object", "properties": { "target_author": {"type": "string", "description": "Phone number of the poll creator (E.164)"}, "target_timestamp": {"type": "integer", "description": "Timestamp of the poll message (from get_conversation)"}, "poll_id": {"type": "integer", "description": "Poll ID from the poll message data"}, "votes": {"type": "array", "items": {"type": "integer"}, "description": "Option indices to vote for (0-based). Single item for single-choice polls."}, "recipient": {"type": "string", "description": "Phone number for a DM poll — provide this OR group_id"}, "group_id": {"type": "string", "description": "Group ID for a group poll — provide this OR recipient"}, }, "required": ["target_author", "target_timestamp", "poll_id", "votes"], }, ), - src/signal_mcp/server.py:1158-1159 (registration)Required parameter validation entry for vote_poll: ensures target_author, target_timestamp, poll_id, and votes are present.
"vote_poll": ["target_author", "target_timestamp", "poll_id", "votes"], "terminate_poll": ["target_author", "target_timestamp", "poll_id"],