Create Poll
create_pollMake a live poll people vote on from a link, with results you can read back. Use it whenever your user asks for a poll, a vote or a quick survey, instead of writing one out in the chat, which cannot collect votes; never make one they did not ask for or agree to. Give a question and 2 to 6 options; type is "pick_one" (default), "pick_several" (with optional min_picks and max_picks) or "ranked" (voters put the options in order; the Borda count decides). write_in: true lets voters add their own answer that others can then pick (pick_one and pick_several only, never on a public document). Optional: when it closes (closes_at as an ISO time, or closes_in of 1h, 1d, 3d or 1w), close_after_votes, and who sees results before it closes (results_visibility: always, after_vote (default), after_close, owner_only). Leave document out and Gryz makes a short private document that holds the poll. Pass document (the slug of a Markdown or HTML document your user owns) to add the poll to it: for a Markdown document the result gives a small block to put where the question sits, with the document edit tools, and people cannot vote until it is there. For an HTML document the poll shows after the page at once, and the result also gives markup you can restyle and put in the page so the poll sits where the question is: a click on an option opens a Gryz vote box where the person confirms. A ranked poll has no markup and always shows after the page. A poll is as private as its document: whoever can open the document can vote. You never vote, and there is no tool that does. The question and options you send are shown to people as written. With projects on, add project (a project id from list_projects) to put the new short document in one of your user's projects.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "create_poll"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| type | No | "pick_one" (default), "pick_several" or "ranked" (voters put the options in order) | |
| options | No | 2 to 6 options, 1 to 80 characters each, no links, no repeats | |
| project | No | A project id from list_projects: the new short document goes in that project. Not together with document. | |
| document | No | Slug of a Markdown or HTML document your user owns. Leave out for a new short private document. | |
| question | No | The question, 1 to 200 characters. Neutral wording. | |
| template | No | A starting point when you leave out the question or the options: pick_one, go_no_go, prioritize, confidence, retro_pulse, quick_vote, pick_a_date | |
| write_in | No | Let voters add their own answer, which others can then pick. pick_one and pick_several only, never on a public document. Default false. | |
| closes_at | No | When it closes, as an ISO 8601 time. Not together with closes_in. | |
| closes_in | No | How long until it closes: 1h, 1d, 3d, 1w. Not together with closes_at. | |
| max_picks | No | pick_several only: the most options a voter picks (default all) | |
| min_picks | No | pick_several only: the fewest options a voter picks (default 1) | |
| close_after_votes | No | Close when this many people have voted (2 to 10000) | |
| results_visibility | No | Who sees counts before it closes: always, after_vote (default), after_close, owner_only |