draw_winners
Perform a verifiable random draw (commit-reveal + drand) of winners from contestants and prizes. Saves a proof page on rfwin.uk/d/:id. Free for all accounts (free tier: up to 10,000 contestants per draw; paid plans: larger draws). Optional radio preset: alternates (ordered backup winners), station, show. Optional visibility: "public" (default, indexable) or "private" (unlisted: works and verifies for anyone with the link, but noindex and never listed).
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"contestants": "<contestants>",
"prizes": "<prizes>"
},
"name": "draw_winners"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| show | No | Optional show or segment name shown on the proof page. | |
| title | No | Optional title for the draw | |
| prizes | Yes | List of prizes and quantities to draw for | |
| station | No | Optional station name / call sign shown on the proof page. | |
| algorithm | No | Drawing algorithm: random (equal weight) or weighted. Default random. | |
| alternates | No | Optional number of ordered backup winners (0-20) drawn after the main prizes, e.g. for radio giveaways. Requires uniqueWinners. | |
| visibility | No | Optional. "public" (default): proof page is indexable by search engines. "private" (alias "unlisted"): proof page works and verifies for anyone with the link (get_draw / verify_draw too) but is noindex,nofollow and never listed. | |
| contestants | Yes | List of contestants (names, emails, or usernames) | |
| uniqueWinners | No | If true, a contestant can win at most one prize. Default true. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| drawId | No | ||
| winners | No | ||
| visibility | No | ||
| manageToken | No | Organiser token for PATCH https://rfwin.uk/api/draws/{id}/visibility (header X-RFWIN-Manage-Token). Keep private. | |
| verificationUrl | No |