List polls
list_pollsEvery public poll, latest run first, filtered and sorted as the directory at /polls is: by topic (a topic's slug), status, model, lab and search, sorted by latest run, newest, most answers or ending soon. With a key that has the read scope, mine=true lists your own polls instead (a test key lists test polls only; the filters apply to public polls). Use updated_since to fetch only polls that changed, then get_results for each. (GET /api/v1/polls)
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": "list_polls"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| q | No | Public polls: only those whose title, description, first question or topics contain every word given. | |
| lab | No | Public polls: only those asking a model from this lab, such as Anthropic. | |
| mine | No | true: your own polls (needs a key with read). Default: public polls. | |
| sort | No | Public polls: latest run first (the default), newest published, most answers, or soonest end date (polls with none last). | latest |
| limit | No | Items per page, 1 to 100. | |
| model | No | Public polls: only those asking this model, by its display name. | |
| topic | No | Public polls: only those with this topic, by its slug (as in /polls/topics/{slug}). | |
| cursor | No | next_cursor from the previous page, unchanged. | |
| status | No | Public polls: running (on a schedule), stopped (ended, paused, or run once by hand), or all (the default). | all |
| updated_since | No | Only polls whose last run or edit is after this moment. |