# HNW — Highest Number Wins HNW settles everyday choices for groups: where to eat, who pays, which option wins. Everyone locks a number; the highest number wins. Every result can be checked by anyone afterwards. HNW is a selection mechanism. It is not a giveaway platform, not a lottery, and not a sweepstakes or gambling service. No money or prizes are held, promised or paid by HNW. ## Use HNW from an AI assistant (ChatGPT, Claude and others) - Plain-language setup and ready-made prompts: /connect - Signed-in connector: https://highestnumberwins.com/api/mcp/account Streamable HTTP with OAuth authorization code and PKCE. Discover the issuer at /.well-known/oauth-protected-resource/api/mcp/account. Call tools/list after sign-in to see the tools available to this grant. Creator hosts need games:write. Users review and revoke access in /connections. - Anonymous connector: https://highestnumberwins.com/api/mcp JSON-RPC 2.0. No key needed; 120 requests/hour and 1000/day per IP. Tool catalog: /developers/mcp and GET /api/mcp/tools - Links, for assistants that can only send a URL: /decide?options=pizza|burger|biryani /create?mode=option_pick&options=red|blue|green&win_condition=highest The person sees a confirm-and-play page; nothing is created without their confirmation. Up to 20 options, 64 bytes each, pipe-separated. ## Agent workflows - Solo pick: call create_solo_decision with 2–20 candidate objects, each with a label. To choose now, call finish_solo_decision with the game_id and seeded_players[0].token as player_token. Read winner_candidate.label. Retrying the same game returns the same pick. To let the person play, give them the private join_url. The first browser to claim it within 15 minutes receives the seat. - Group game: start the game, then use lock_number for each seat, or for each assigned candidate in Option Pick. The server assigns each lock its place on the reel; an assistant cannot choose when it stops. A waiting_for_players response identifies the current phase. Advance other seats, retry the waiting seat, and read get_result. - Share a finished classic game: when asked, use share_result with the exact game_id and round_id and a participant's seat or account. Give the returned share_url. Player names and other option labels are redacted by default. The winning option label is public. - Creator draw: call host_public_game from a connected Creator account. Supply name, RFC3339 window_closes_at and a UUID request_id from prepare_randomness.object_id. Reuse it on retries. Give entrants the join_url. They sign in and draw once each. Directory listing and follower announcements are opt-in. list_hosted_games includes the host's closed and unlisted games among their 50 most recent. - Official audience winner: call get_audience_result with game_id. A pending draw has no official winner. On closure, share the returned share_url and winner. Zero entrants means no winner. drawn_number is a decimal string. For more standings, pass next_offset as offset. - Keep player tokens private. Public result links work for a fresh browser. ## Check any result - verify_round({round_id}) compares a classic round's locally re-derived seed with its publication. GET /verify/{round_id}.json serves the round bundle. Private games require admission. - verify_round({game_id}) reports the backend's replay of a closed audience draw. Inspect status for match, mismatch or unavailable. - /fairness — the same explanation for people. ## Pages for people - / — start a game - /pricing — plans - /restaurants — free listing, menu and table card for restaurant owners - /discover — find a restaurant and let the group pick - /agents, /developers/mcp — developer detail ## Guides - /blog — plain-language guides to picking fairly, for groups, creators and restaurants - /blog/giveaway-winner-picker — pick one winner from thousands, with a public receipt - /blog/prove-a-random-pick-was-fair — how each kind of draw can be checked - /blog/pick-a-winner-with-chatgpt-or-claude — using HNW from an assistant - /blog/add-your-restaurant-menu-free — restaurant owners: list a menu free - /blog/how-to-check-a-round — check one round step by step